Article

    Unthread MCP

    3 min read
    Last updated 4 hours ago

    You can now connect your AI agent to your Unthread support portal! Once connected, you can ask it to search the knowledge base, check on your open tickets, submit new tickets, and start support conversations — all from inside ChatGPT, Claude, Cursor, or any MCP-capable AI client.

    Setup Instructions

    Your portal's MCP URL is your portal's domain followed by /api/mcp:

    https://<your-portal-domain>/api/mcp

    For example, if your portal is hosted at help.acme.com, then your portal MCP is https://help.acme.com/api/mcp.

    If you're not sure what your portal's domain is, it's the address you visit to log in. The instructions below use <your-portal-domain> as a placeholder — replace it with your actual portal address.

    ChatGPT

    1. Sign in to ChatGPT.

    2. Open Apps, then click on the settings icon (circled in green in this screenshot:Screenshot 2026-06-02 at 10.53.45 AM.png

    3. if you haven't done so already, click into Advanced settings, then enable developer mode. (This is required because these apps are bespoke to your setup and cannot be listed on the public marketplace)Screenshot 2026-06-02 at 10.54.33 AM.pngScreenshot 2026-06-02 at 10.58.15 AM.png

    4. Click Create app, then enter a name (e.g. "Acme Support") and the server URL:

      https://<your-portal-domain>/api/mcp

    5. Set Authentication to OAuth.

    6. Check the "I understand and want to continue" box, and click Create.

    7. Click Connect. ChatGPT will open your portal's sign-in page.

    Note: ChatGPT is a little inconsistent with how they handle MCPs. if you find that the app is not being properly connected, you may need to manually add it to your chat:

    Screenshot 2026-06-02 at 11.05.41 AM.png

    Claude.ai (Web)

    1. Go to claude.ai and sign in.

    2. Navigate to Customize → Connectors → Add custom connector.Screenshot 2026-06-02 at 11.07.57 AM.png

    3. Enter a name (e.g. "Acme Support") and the server URL:

      https://<your-portal-domain>/api/mcp

    4. Click Add and follow the authorization prompt.

    5. Sign in with your portal account when prompted.

    Claude Code (CLI)

    1. Open your Claude Code configuration file at ~/.claude.json.

    2. Add your portal to the mcpServers section:

      {
  "mcpServers": {
    "acme-portal": {
      "url": "https://<your-portal-domain>/api/mcp"
    }
  }
}

    3. Restart Claude Code.

    4. When you first use a portal tool, you'll be prompted to authenticate via your browser.

    Capabilities and limitations

    What your agent can read:

    • Knowledge base — search, fetch articles, look up an answer.
    • Your conversations — list your active conversations, read messages, check status.
    • Portal context — the portal's name, ticket types, projects you can submit to.
    • Bot replies — start a conversation with the portal bot and poll for its response.

    What your agent can write (only if your portal admin has enabled it):

    • Create a ticket — file a new support ticket on your behalf, including custom field values.
    • Convert a conversation to a ticket — escalate an existing bot conversation into a tracked ticket.
    • Reply to a conversation — send a message into a conversation you're part of.