Symphia

    MCP connector

    Last updated September 2026

    The Symphia MCP connector lets you ask Claude or ChatGPT about your Symphia workspace in plain language — conversations, insights, monitoring, simulations, phone calls, and billing — using the Model Context Protocol (MCP). You connect once with your Symphia account; after that, the assistant can look things up for you with read-only access.

    1. What it is

    MCP is an open standard that lets AI assistants call tools on other products. Symphia exposes a remote MCP server at https://api.symphia.ai/mcp with read-only tools over one workspace:

    • Conversations — search every channel (web chat, SMS, WhatsApp, phone) and read full transcripts.
    • Insights — the same KPIs as the console's Insights tab: volume, deflection, CSAT, latency, top tools and journeys.
    • Monitoring — live monitor status and alert history.
    • Simulations — your agent-eval suite's latest results and pass rates.
    • Calls — recent phone calls with outcomes and linked transcripts.
    • Billing — balance, plan, and 30-day usage summary.

    Access is per-person and per-workspace: you sign in with your own Symphia account and pick which workspace to connect. Your workspace admin has to enable the connector first.

    2. Connect from Claude

    Custom connectors require a paid Claude plan (Pro, Max, Team, or Enterprise).

    1. Open claude.ai → Settings → Connectors.
    2. Choose Add custom connector.
    3. Paste the Symphia server URL: https://api.symphia.ai/mcp
    4. Click Add, then Connect. Your browser opens Symphia — sign in with your usual email code if you aren't already, pick the workspace, and click Allow access.

    That's it. In any conversation, Claude can now use the Symphia tools (enable them from the search-and-tools menu if they aren't already). The connector also works in Claude's research mode.

    3. Connect from ChatGPT

    ChatGPT supports MCP connectors on paid plans; on some plans custom connectors appear after enabling Developer mode (Settings → Connectors → Advanced).

    1. Open ChatGPT → Settings → Connectors.
    2. Choose Create (or Add custom connector).
    3. Name it Symphia and set the MCP server URL: https://api.symphia.ai/mcp
    4. Pick OAuth as the authentication method and save. When prompted, sign in to Symphia, pick the workspace, and click Allow access.

    Symphia also implements the search and fetch tools that ChatGPT's deep research requires, so you can include your Symphia conversations as a deep-research source.

    4. Things to ask

    Once connected, ask in plain language. A few that map directly to the tools:

    • "How did my Symphia agent do last week — conversations, deflection, CSAT?"
    • "Find conversations where a guest asked about early check-in, and summarize how the agent handled them."
    • "Pull the transcript of the call from +1 415… yesterday and tell me why it was transferred."
    • "Are any of my monitors breached right now? What alerts fired this week?"
    • "Which simulations are failing, and what's the pass rate trend?"
    • "What's my Symphia balance and what did the last 30 days of usage cost?"

    5. Security and privacy

    • Read-only. Every tool only reads. The connector cannot change your agent's brain, send messages, place calls, or spend credits.
    • You sign in on symphia.ai. Authorization uses OAuth 2.1 with PKCE; the consent page runs on Symphia's own site and your credentials are never shared with Claude, ChatGPT, or anyone else. The assistant only ever holds a revocable, short-lived token.
    • Per-workspace enablement. A workspace is only connectable after a Symphia admin enables the MCP connector for it, and access is always scoped to the single workspace you approved.
    • Disconnect anytime. Remove the connector in Claude/ChatGPT settings, or revoke it from the Symphia console under Settings → Profile → Connected apps — revocation takes effect immediately.

    6. Troubleshooting

    • "Can't connect" or a 404 while adding the URL: the connector may not be enabled yet for your Symphia deployment or workspace — check with your admin.
    • No workspaces selectable at consent: none of your workspaces has the connector enabled. An admin enables it per workspace.
    • The assistant says the token is invalid: the grant was revoked or your seat in the workspace changed. Reconnect from the assistant's connector settings.
    • Anything else — email support@symphia.ai.