Connect an MCP server

MCP servers are connected at the workspace level (one connection serves
every agent in the workspace) and attached at the agent level (each agent
picks which tools to enable).

Connect a server

1. Open any agent → Integrations tab
2. Click + Connect MCP
3. Pick a curated card (Meta Ads, Stripe, Linear) or click
4. The form pre-fills with sensible defaults. Add your auth token:
5. Click Connect & discover tools

We immediately call the server's tools/list endpoint and cache the
result. You'll see the discovered tools listed under the server card.

Where to find auth tokens

• Meta Ads — generate a Marketing API access token with ads_read
• Stripe — use a restricted API key (sk_live_… or rk_live_…).
• Linear — generate a personal API key in

Re-discovering tools

If the server adds new tools, click Re-discover tools on the server
card to refresh the cached list.

Per-agent attachment

Discovered tools are not automatically active for any agent. To enable a
tool on an agent:

1. Toggle the tool on in the Integrations tab
2. Write a "when to use" rule (see the rules article)

Every tool starts disabled by default — you opt each one in deliberately.

Security model

• Auth tokens are encrypted at rest with AES-256-GCM, keyed by an env
• The token is only sent at request-time when Anthropic calls the MCP
• Detaching a tool removes the agent's access immediately. Deleting the

Troubleshooting

• "MCP server returned 401" — the token is wrong or expired. Edit
• "No tools discovered" — the server probably doesn't expose
• The agent never calls the tool — see