Twenty MCP by usefulapi

Twenty MCP by usefulapi

通过 Claude、Cursor 或任何 MCP 客户端使用你的 Twenty 账户——读取联系人、公司、商机、笔记和任务，并创建或更新 CRM 记录。托管服务， 无需本地安装：使用你自己的凭据连接。

在线端点： https://twenty.usefulapi.io/mcp · 主页： https://usefulapi.io

连接

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

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

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

分步设置指南、凭据查找方法和常见问题解答：https://usefulapi.io/twenty/

首次连接时，你需要提供 Twenty API 密钥（设置 → API 与 Webhook）。系统会验证该密钥，并按用户存储且仅限你本人使用——配置文件中不会存放密钥。

工具

工具	类型	功能
twenty_list_metadata_objects	读取	列出元数据对象
twenty_list_people	读取	列出联系人
twenty_get_person	读取	获取联系人
twenty_list_companies	读取	列出公司
twenty_get_company	读取	获取公司
twenty_list_opportunities	读取	列出商机
twenty_get_opportunity	读取	获取商机
twenty_list_notes	读取	列出笔记
twenty_get_note	读取	获取笔记
twenty_list_tasks	读取	列出任务
twenty_get_task	读取	获取任务
twenty_create_person	写入	创建联系人
twenty_update_person	写入	更新联系人
twenty_create_company	写入	创建公司
twenty_update_company	写入	更新公司
twenty_create_opportunity	写入	创建商机
twenty_update_opportunity	写入	更新商机
twenty_create_note	写入	创建笔记
twenty_create_task	写入	创建任务
twenty_update_task	写入	更新任务
twenty_usage_status	元数据	使用情况状态（免费套餐用量计数）
twenty_request_feature	元数据	申请添加缺失功能
twenty_upgrade	元数据	升级到 Pro（不限量*）
twenty_cancel_subscription	元数据	取消 Pro 订阅

read 工具为只读；write 工具会修改数据（客户端应在执行前确认）；meta 工具用于报告使用情况、管理订阅或提交功能申请。

定价

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

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

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

许可证

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