Attach an MCP server

Connect an MCP server to a specific agent. The agent will be able to call tools exposed by that server during visitor conversations once you whitelist them.

Prerequisites

• An MCP server URL reachable from the public internet (Pitchbar is a SaaS — it cannot reach localhost or VPN-only hosts). The validator rejects private addresses.
• An API key (for bearer auth) or OAuth client credentials. Phase 1 ships bearer auth; OAuth flows are in a follow-up release.

Steps

1. Open /app/agents/{agent}/mcp.
2. Click Add server.
3. Enter a label (e.g. "Linear"), the server URL, and the auth method.
4. Submit. Pitchbar runs an initialize + tools/list handshake against the server and discovers the catalogue.
5. Open the tool list (Manage tools button on the server card).
6. Enable each tool you want the agent to use. Destructive tools require an explicit confirmation showing the input schema.

Verifying the connection

On the server card, the Test button runs a fresh initialize + ping round trip and records the result. The Refresh tools button re-discovers the catalogue — useful after the server has been updated.

Same server attached to multiple agents

Workspaces have one row per server URL (deduplicated at the database layer). Attaching the same URL to a second agent reuses the existing row but creates a new set of per-agent tool grants. Disabling a tool for one agent does not affect the other.