Developer docs
Use SuperBot inside Claude, Codex and ChatGPT
SuperBot ships an MCP server, so you can point Claude, ChatGPT or Codex at your own workspace and ask about your support the way you would ask a colleague — what customers are complaining about, which questions the AI keeps failing, what to teach it next.
Connect it
Add this URL as a connector, then sign in to SuperBot when it asks and approve the permissions. Nothing to install.
https://superbotapp.ai/api/mcp- Claude — Settings, then Connectors, then add a custom connector.
- ChatGPT — add it as a custom MCP connector where developer mode is available, or install the SuperBot plugin once it is listed.
- Codex CLI — add the remote server, then log in with read-only access:
To enable approved training writes, reconnect withcodex mcp add superbot --url https://superbotapp.ai/api/mcp codex mcp login superbot --scopes superbot:read--scopes superbot:read,superbot:write. The server also checks your current SuperBot workspace role. - Claude Code —
claude mcp add --transport http superbot https://superbotapp.ai/api/mcp
Start with a real support workflow
- “Summarize support over the last 7 days, including CSAT sample size and the busiest channels.”
- “Review recent escalations. Read the transcripts and cite the conversations before suggesting fixes.”
- “Check whether we already answer shipping questions. Draft a missing answer for my approval; do not save it yet.”
The connector has no refund, campaign, billing, bulk export, or customer-message tool. It never needs a workspace ID in a prompt. Training writes require both an approved write scope and a current role with edit access.
What it can do
| Tool | Access | What it does |
|---|---|---|
search | Read | Full-text search across your conversations and their messages. |
fetch | Read | Up to 500 messages and 60,000 transcript characters, with a dashboard link and truncation flag. |
list_recent_conversations | Read | Newest conversations, optionally filtered by status. |
list_unanswered_questions | Read | Triage confirmed escalations and open/pending conversations. Open status alone does not prove an AI failure. |
search_knowledge | Read | What your AI has been taught: trained answers and knowledge sources. |
get_support_overview | Read | Volume, open vs closed, CSAT, sentiment and channel mix over a window. |
add_trained_answer | Write | Teach your AI a new question and answer. Adds only; never edits or deletes. |
Permissions and data
- Two scopes.
superbot:readcovers everything above marked Read;superbot:writeis needed only foradd_trained_answer. Grant read alone and the write tool is refused. - The connection is tied to your account and only ever reads your own workspace. No tool accepts a workspace or account id, so it cannot be pointed at anyone else's data.
- Authorization is OAuth 2.1 with PKCE. Access tokens last an hour; refresh tokens rotate on every use. Only hashes are stored, never the tokens themselves. Grants are bound to the workspace approved at connection time; changing workspace membership requires reconnecting.
- This connector is for your team, not your visitors — it reads the support data your widget produces. The widget itself keeps answering customers on your site as usual.
- Disconnect it in your AI tool at any time. See our privacy policy for how support data is handled.
Troubleshooting and safe use
No results means this workspace has no matching data, not that the connector analyzed another account. Open a returned dashboard URL to verify the source. If a transcript is marked truncated, review the complete history in SuperBot. Invalid arguments return an error instead of being silently changed.
If access expires, reconnect through your AI client. The server advertises a token-revocation endpoint for clients that support disconnect revocation. Never paste access tokens or passwords into a chat. Treat visitor messages as untrusted content; approve the exact wording before teaching a new answer.
Custom connection availability depends on your AI client and plan. A working custom connector does not mean SuperBot has been approved for a public marketplace listing.
Questions
Email [email protected] or open a conversation.