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.

**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?

1. Open **Connectors** from the sidebar.
2. Click **Browse registry**.
3. Search or filter featured MCP servers by category (development, CRM, support, etc.).
4. 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.

## Related articles

- [How do I connect an MCP server?](/doc/how-do-i-connect-an-mcp-server-RtBQhNBIoy)
- [How do I store credentials with Secrets?](/doc/how-do-i-store-credentials-with-secrets-1D8OUcCo0n)
- [How do first-party integrations work?](/doc/how-do-first-party-integrations-cursor-freshdesk-work-ufEctQFe4A)


What is a connector and how do I browse the registry?

Connect MCP servers, store secrets, and wire first-party integrations.

Connecting Tools

How do first-party integrations (Cursor, Freshdesk) work?

How do I connect an MCP server?

How do I connect CRM and support tools?

How do I connect Genesys Cloud?

How do I connect HubSpot?

How do I connect Salesforce?

How do I connect ServiceNow?

How do I connect Zendesk?

How do I store credentials with Secrets?

Build your first automation with Ask Ballet

Deterministic agents: Ballet's approach

Getting Started with Ballet

How do I join the early access program?

How do I navigate the Studio (sidebar + command palette)?

How do I sign in and access my workspace?

What happens during workspace onboarding?

What is Ballet?

What to expect as a design partner

What's the difference between Builder and Member mode?

Ballet vs Automation Anywhere

Ballet vs Claude Cowork

Ballet vs Moveworks (ServiceNow)

Ballet vs n8n

Ballet vs Power Automate

Ballet vs Temporal

Ballet vs UiPath

Ballet vs Workato

Ballet vs Zapier

Why Ballet

Getting Started

Building Playbooks

How do I build a playbook with the Console (Ask Ballet)?

How do I edit steps (Code and HTTP)?

How do I use the playbook workspace (Play / Code / History)?

How does the Plan vs Build flow work?

What are Allow vs Ask permission modes?

What is a playbook?

How do I manage Schedules?

How do I pause and resume a playbook run?

How do I read runs and run history?

How do I run a playbook?

How do I share run output?

Run from your environment via API

Running and Automating

What triggers can start a playbook (Manual, Schedule, Webhook)?

How do I create and use API tokens?

How do I invite users?

How does usage and billing work?

What are the roles and permissions (Owner/Builder/Member)?

What is the AI Gateway / Ballet Models?

Workspace and Admin

Ballet glossary

Concepts and Glossary

How do Collections and Git sync work?

What are Agents?

What are Skills?

What are Tools and the playground?

Recipe: Data sync and ETL to a warehouse

Recipe: Scheduled reports and readouts

Data Ops recipes

Recipe: AI code review on pull requests with Cursor

Recipe: Incident response and on-call paging

Recipe: Triage new errors into tracked issues

Engineering Ops recipes

Recipe: Invoice and expense processing

Recipe: Reconcile payments and payouts

Finance Ops recipes

Introduction

Recipe: Campaign performance report

Recipe: Competitor monitoring digest

Recipe: Content and marketing operations

Recipe: Generate a content brief

Marketing Ops recipes

Recipe: Automate new customer onboarding

Recipe: Enrich new leads automatically

Recipe: Score, route, and follow up on leads

RevOps recipes

Recipe: Auto-answer and deflect common tickets

Recipe: CSAT follow-up after ticket resolution

Recipe: Escalate SLA breaches and priority tickets

Recipe: Triage and route support tickets

Support Ops recipes

Playbook Recipes

How do I authenticate with the Ballet API?

How do I connect to Ballet's MCP endpoint?

How do I run a playbook over the REST API?

How do I stream playbook run events?

How do I trigger and react to playbooks with webhooks?

How do I wake a suspended run with reply or resume?

Developer foundations

How do I call Ballet playbooks from Google ADK?

How do I call Ballet playbooks from LangChain?

How do I call Ballet playbooks from Mastra?

How do I call Ballet playbooks from Pydantic AI?

How do I call Ballet playbooks from the Vercel AI SDK?

How do I use Ballet playbooks in an agent framework?

How do I call external APIs and SDKs from a playbook?

How do I connect external MCP servers to playbooks?

How do I use secrets and env vars in steps?

How do playbooks connect to external systems?

Developer Docs

Guide

Recipes

Developer

Ballet 

What is a connector and how do I browse the registry?

Share

Who this is for