Chatwoot MCP by usefulapi

usefulapi 提供的 Chatwoot MCP

通过 Claude、Cursor 或任何 MCP 客户端使用你的 Chatwoot 账户。读取对话、联系人和收件箱，添加回复或私人备注，设置状态或优先级，并分配对话。托管服务，无需本地安装：使用你自己的凭据连接。

实时端点： https://chatwoot.usefulapi.io/mcp · 主页： https://usefulapi.io

连接

• Claude（claude.ai、Desktop）：打开 自定义 → 连接器，点击 + 添加 → 添加自定义连接器，然后粘贴 https://chatwoot.usefulapi.io/mcp。
• Claude Code： claude mcp add --transport http chatwoot https://chatwoot.usefulapi.io/mcp，然后运行 /mcp 登录。
• VS Code： 添加到 VS Code。
• Cursor 和其他客户端： 将此 URL 添加为远程 MCP 服务：

{
  "mcpServers": {
    "chatwoot": {
      "url": "https://chatwoot.usefulapi.io/mcp"
    }
  }
}

只添加 URL。不要在客户端配置中添加 Authorization 标头或 API 密钥：服务会通过 OAuth 为你登录，登录页面会要求你提供 Chatwoot 凭据。

分步设置说明、凭据查找位置和常见问题解答：https://usefulapi.io/chatwoot/

首次连接时，你需要提供 Chatwoot 访问令牌（个人资料设置 → 访问令牌）和 账户 ID（Chatwoot URL 中 /app/accounts/ 后面的数字）。服务会验证令牌并按用户存储。配置文件中无需放置密钥。

工具

工具	类型	功能
chatwoot_get_account	读取	获取账户
chatwoot_list_conversations	读取	列出对话
chatwoot_get_conversation_counts	读取	获取对话数量
chatwoot_get_conversation	读取	获取对话
chatwoot_list_messages	读取	列出消息
chatwoot_list_contacts	读取	列出联系人
chatwoot_search_contacts	读取	搜索联系人
chatwoot_get_contact	读取	获取联系人
chatwoot_list_contact_conversations	读取	列出联系人的对话
chatwoot_list_labels	读取	列出标签
chatwoot_list_inboxes	读取	列出收件箱
chatwoot_list_agents	读取	列出 Agent
chatwoot_list_teams	读取	列出团队
chatwoot_list_canned_responses	读取	列出预设回复
chatwoot_send_message	写入	发送消息或私人备注
chatwoot_set_conversation_status	写入	设置对话状态
chatwoot_set_conversation_priority	写入	设置对话优先级
chatwoot_assign_conversation	写入	分配对话
chatwoot_usage_status	元信息	使用情况（免费套餐用量计数）
chatwoot_request_feature	元信息	请求添加缺失的功能
chatwoot_upgrade	元信息	升级到 Pro（无限量*）
chatwoot_cancel_subscription	元信息	取消 Pro 订阅

read 工具为只读；write 工具会修改数据（客户端应先确认）；meta 工具用于报告用量、管理订阅或发送功能请求。

定价

套餐	价格	限额
免费	$0	每月 50 次工具调用
Pro（按用户计费）	$9/月 或 $90/年（免费 2 个月）	无限量*

*Pro 在此服务上的公平使用限额为每月 10,000 次工具调用。如需更多，请发送邮件至 [email protected]。

Pro 仅适用于此服务。使用 chatwoot_upgrade 订阅（它会返回 Stripe Checkout 链接）。可随时使用 chatwoot_cancel_subscription 取消：Pro 服务会持续到付费周期结束，当前周期不予退款；在此之前运行 chatwoot_upgrade 可撤销取消操作。你也可以发送邮件至 [email protected]。

许可证

MIT — 参见 LICENSE。仅提供文档；服务由托管。