SimplyBoost MCP

官方

向 SimplyBoost AI 支持代理提问，回复他们转交给团队的对话，跟进潜在客户并更新他们的知识库

你可以用 SimplyBoost MCP 做什么？

查找聊天机器人 — 列出令牌可使用的聊天机器人，并按 id 获取某个聊天机器人的详细信息。
发送访客消息 — 像访客一样向聊天机器人提问，并传入 threadId 以继续现有对话。
查看对话 — 列出所有渠道中的对话、阅读对话消息，并获取单个对话。
以人工身份处理对话 — 接管对话、回复、将对话交还给聊天机器人、解决对话或重新打开对话。
管理潜在客户 — 列出并查看已收集的潜在客户、更新其详细信息或将其标记为已转化，并删除潜在客户。
管理知识来源 — 列出聊天机器人已掌握的知识、添加文本或网站、编辑或刷新来源，并删除来源。

托管 MCP 服务器

npx add-mcp 'https://get-api.simplyboost.io/api/v1/mcp'

可安装到 Claude Code、Codex、Cursor 等客户端

文档

它是什么

MCP 服务器位于 https://get-api.simplyboost.io/api/v1/mcp。它使用 Streamable HTTP 传输，并使用与 REST API 相同的 API 令牌（Authorization: Bearer sb_live_…）、相同的套餐（Growth、Pro 和 Enterprise）、相同的权限和相同的限制。每个工具的功能都与对应的 REST 端点相同，并且需要相同的权限范围；如果助手看到一个它无权使用的工具，会明确拒绝，而不是报错。

它是无状态的：每次调用都是一个请求和一个答复，无需维持会话，因此你可以从任何机器连接。服务器不会自行启动数据流。

连接客户端

有两种方式。登录（OAuth）：添加服务器地址，然后在客户端提示时，以团队所有者身份在 SimplyBoost 标签页中批准连接，并选择团队、权限和聊天机器人。claude.ai 和 ChatGPT 连接器、Cursor、Codex 和 Claude Code 都通过这种方式连接，无需粘贴任何内容。使用令牌：对于需要手动配置的客户端或你自己的脚本，请在 Settings → API 中创建一个仅包含助手所需权限的令牌，并将其作为标头发送。

Claude Code（按提示登录）

claude mcp add --transport http simplyboost https://get-api.simplyboost.io/api/v1/mcp

Codex

codex mcp add simplyboost --url https://get-api.simplyboost.io/api/v1/mcp
codex mcp login simplyboost

Cursor、Windsurf、VS Code 和其他使用 mcp.json 的客户端（按提示登录）

{
  "mcpServers": {
    "simplyboost": { "url": "https://get-api.simplyboost.io/api/v1/mcp" }
  }
}

相同配置，但使用令牌而非登录

{
  "mcpServers": {
    "simplyboost": {
      "url": "https://get-api.simplyboost.io/api/v1/mcp",
      "headers": { "Authorization": "Bearer sb_live_…" }
    }
  }
}

通过登录建立的连接有效期为 90 天，仅拥有所有者勾选的权限（除非勾选，否则无法删除），并会列在 Settings → API → Connected apps 中，所有者可随时断开连接。只有团队所有者可以批准连接，这与创建令牌的规则相同。批准页面上显示的应用名称由应用自行声明；SimplyBoost 不会验证该名称。

客户端配置中的令牌相当于你账户的密码。请将其保存在自己的电脑上，设置有效期；如果配置文件被共享，请轮换令牌。登录可以避免这个问题：不会有任何机密信息写入文件。

面向客户端开发者：服务器遵循 MCP 授权规范。没有凭据的请求会返回 401，并附带一个 WWW-Authenticate 标头，其中指定受保护资源元数据（https://get-api.simplyboost.io/.well-known/oauth-protected-resource/api/v1/mcp），该元数据会指定授权服务器（https://get-api.simplyboost.io/.well-known/oauth-authorization-server）。客户端会自行注册（动态客户端注册），使用带 PKCE 的授权码流程（仅支持 S256），可以指定资源，并会获得轮换刷新令牌。访问令牌有效期为一小时，且仅适用于 MCP 端点；REST 端点需要使用 API 令牌。

工具

参数和结果使用与 REST API 相同的名称（chatbotId、threadId、camelCase 字段），因此端点页面同时适用于两者。请先使用 list_chatbots 查找聊天机器人的 ID。

工具	需要	功能
`get_account`	无	账户、套餐和令牌自身的权限。
`get_usage`	`account:read`	本计费周期已使用的消息数。
`list_chatbots`、`get_chatbot`	`chatbots:read`	令牌有权使用的聊天机器人。
`send_message`	`conversations:write`	像访客一样向聊天机器人提问；会计入套餐消息数。传入 `threadId` 以继续对话。
`list_conversations`、`get_conversation`、`list_messages`	`conversations:read`	所有渠道上的对话及其消息。
`take_over_conversation`、`reply_to_conversation`、`hand_back_to_chatbot`、`resolve_conversation`	`conversations:write`	像人工客服一样处理对话：接手、回复、转交、解决或重新打开。
`list_leads`、`get_lead`	`leads:read`	聊天机器人收集的潜在客户。
`update_lead`	`leads:write`	修改潜在客户的详细信息或将其标记为已转化。
`delete_lead`	`leads:delete`	删除潜在客户。
`list_knowledge_sources`、`get_knowledge_source`	`knowledge:read`	聊天机器人掌握的信息，以及每个来源的状态和文本。
`add_text_knowledge`、`add_website_knowledge`、`update_knowledge_source`、`refresh_knowledge_source`	`knowledge:write`	向聊天机器人提供文本或网站内容、编辑来源、重新读取网站。
`delete_knowledge_source`	`knowledge:delete`	移除来源。

文件上传和 Webhook 不作为工具提供；这些功能请使用 REST 端点。删除工具会标记为具有破坏性，服务器的指令会要求助手先征求你的同意。

错误和限制

被拒绝的工具调用（缺少权限、令牌无权查看某个聊天机器人、参数无效或达到套餐限制）会以标记为错误的工具结果返回，并附带与 REST API 相同的 code 和消息，以便助手告诉你需要更改什么。令牌缺失或无效时返回 401；套餐不包含 API 或订阅已过期时返回 403；超出每个令牌的速率限制时返回 429，与 REST API 完全相同。

非 JSON-RPC 2.0 格式的消息会返回 JSON-RPC 错误。对端点发出的 GET 和 DELETE 请求会返回 405，因为这里没有会话，也没有服务器数据流。