API 与 MCP 参考
Everything the dashboard does, as a REST API — plus a hosted MCP server so AI agents like Claude can manage your bots directly. Available on the Growth plan and higher.
本文暂以英文提供 — 翻译版即将上线。
Authentication
Create a token in Dashboard → API. Tokens are scoped, can be limited to specific bots, and can expire. Pass them as a bearer header:
curl https://mongpt-api.mongpt.workers.dev/v1/bots \ -H "Authorization: Bearer mgpt_your_token_here"
Endpoints
| Method | Path | Scope | Description |
|---|---|---|---|
| GET | /v1/bots | bots:read | List bots |
| POST | /v1/bots | bots:write | Create a bot (plan-limited) |
| GET | /v1/kb?chatbotId=… | kb:read | List knowledge-base documents |
| POST | /v1/kb/ingest | kb:write | Add knowledge from a URL or raw text (queued) |
| POST | /v1/chat | chat:invoke | Chat with a bot — SSE streaming, counts toward quota |
| GET | /v1/conversations | conversations:read | List conversations (?q= search) |
| GET | /v1/conversations/{sessionId} | conversations:read | Full transcript of one session |
| GET | /v1/analytics | analytics:read | 30-day analytics summary |
| GET | /v1/openapi.json | — | This API as an OpenAPI 3.1 spec (no auth) |
Full schemas: openapi.json
Chat (streaming)
POST /v1/chat returns Server-Sent Events with OpenAI-style chunks. Pass a stable sessionId to group turns into one conversation.
curl https://mongpt-api.mongpt.workers.dev/v1/chat \
-H "Authorization: Bearer mgpt_…" \
-H "Content-Type: application/json" \
-d '{"message":"What is your refund policy?","chatbotId":"…","sessionId":"user-42","language":"ja-JP"}'MCP server (for AI agents)
MonGPT hosts a remote MCP server, so Claude and other MCP-capable agents can list bots, add knowledge, ask questions, and read conversations & analytics — using the same scoped tokens.
{
"mcpServers": {
"mongpt": {
"url": "https://mongpt-api.mongpt.workers.dev/mcp",
"headers": { "Authorization": "Bearer mgpt_…" }
}
}
}Get an API key in 2 minutes
Start the free trial, open Dashboard → API & Agents, create a token.
Start free trial