连接 AI 应用（MCP）

MonoChat MCP Server 让支持 Model Context Protocol（MCP）的 AI 应用（如 Claude Code 或 Cursor）能够使用您的 MonoChat 账户。AI 应用通过一组固定的工具向 MonoChat 请求数据；它只能看到您能看到的内容。

MonoChat MCP Server 适用于所有套餐，不按套餐设限。

连接以您的身份操作

使用您的访问密钥连接的 AI 应用以您的用户身份操作。它只能访问您有权访问的租户（tenant），仅此而已。请撤销不再使用的连接。

AI 应用可以做什么

每个连接都可以使用以下工具：

工具	功能
`list_tenants`	列出该连接可访问的租户。
`list_sessions`	按从新到旧的顺序列出某个租户的对话会话，可只列出 `opened`、`assigned` 或 `closed` 的会话。
`get_session`	返回一个对话会话。
`list_messages`	按从新到旧的顺序列出某个会话的消息。
`search_customers`	按关键词搜索某个租户的客户。
`list_message_templates`	列出某个租户某个渠道的消息模板。

消息文本来自客户和客服。它是供 AI 应用读取的数据，而不是指令。

连接有权限范围：只读或读写。只读连接永远看不到会修改数据的工具。上面列出的所有工具都只读取数据。

创建连接

连接属于您的账户，而不是某个租户。您需要先设置好两步验证（通过电子邮件或验证器应用）。

打开您的个人资料设置，选择 MCP 连接 标签页，然后点击创建。
输入名称，选择权限范围（默认只读）和有效期天数（默认 90，最多 365）。
输入两步验证方式提供的 6 位确认码。如果使用电子邮件验证，请先点击 发送确认码。
复制访问密钥。它只显示一次，以 mcp_sk_ 开头。

您最多可以有 10 个有效连接。

连接 AI 应用

服务器地址为 https://app.monochat.ai/api/mcp-server（如果您在自己的服务器上运行 MonoChat，请使用您自己的 MonoChat 地址），并要求在 Authorization 请求头中以 bearer 令牌的形式提供访问密钥。

Claude Code

claude mcp add --transport http monochat https://app.monochat.ai/api/mcp-server \
  --header "Authorization: Bearer <access key>"

Cursor

将服务器添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "monochat": {
      "url": "https://app.monochat.ai/api/mcp-server",
      "headers": { "Authorization": "Bearer <access key>" }
    }
  }
}

任何其他支持 streamable HTTP 传输和自定义请求头的 MCP 客户端，都可以用同样的方式连接。

限制

调用按分钟计数：每个连接 60 次，每个账户 300 次，每个租户 600 次，并且每个连接最多同时 4 个调用。部分工具会算作多次调用。达到限制时，服务器会返回 429 状态和 Retry-After 响应头；AI 应用应等待相应的秒数。

撤销连接

MCP 连接 标签页中的每个连接都会显示其状态、权限范围、到期时间和最近使用时间。点击撤销可立即切断 AI 应用的访问。已撤销或已过期的连接无法再次使用；请改为创建新连接。

管理组织的 MCP 访问

可以更改组织设置的用户在 设置 › 组织 › MCP 服务器 中管理其 MCP 访问。

关闭此组织的 MCP 访问：打开并点击保存，即可拒绝所有用户的所有连接对该组织发起的每一次 MCP 调用。该组织将不再出现在 list_tenants 中。关闭并保存即可重新允许 MCP 访问。
MCP 调用：所有指定该组织的工具调用，按时间从新到旧排列，包括被拒绝的调用。每一行显示用户、连接、工具、状态（成功或失败）、IP 地址和时间。不显示非该组织成员的用户发起的调用。

AI 应用可以做什么​

创建连接​

连接 AI 应用​

Claude Code​

Cursor​

限制​

撤销连接​

管理组织的 MCP 访问​