Loading…
What is a connector and how do I browse the registry?
TL;DR: A connector links Ballet to an external service — typically via an MCP (Model Context Protocol) server. Open Connectors in the sidebar and use Browse registry to find featured servers like GitHub, Slack, Brainfish, Freshdesk, and dozens more. Connect with OAuth or an API key depending on the provider.
Who this is for
Builders setting up external tool access for playbooks and agents.
What is a connector?
A connector is a configured connection to an external service. Once connected, playbook steps and AI agents can call that service's tools — search tickets, post messages, read files, and more.
How do I browse the registry?
- Open Connectors from the sidebar.
- Click Browse registry.
- Search or filter featured MCP servers by category (development, CRM, support, etc.).
- Select a server and follow the setup instructions — OAuth sign-in or API key entry.
What is MCP?
MCP (Model Context Protocol) is an open standard for connecting AI systems to external tools. Ballet supports MCP servers over HTTP and SSE transports. Many popular services now offer hosted MCP endpoints.
Workspace vs playbook connections
- Workspace connectors — available across all playbooks in your workspace.
- Playbook connections — attached to a specific playbook in its Connectors panel.