跳到导航
集成设置指南CRM

Twenty

通过 Twenty CRM 的 MCP 服务器识别来电者并添加新潜在客户。

接待员可以识别已存在于 Twenty 中的来电者，并将新来电者添加为联系人，记录其姓名、电话号码和来电原因，以便销售团队跟进。Reception 通过 Twenty 内置的 MCP 服务器 连接，适用于 Twenty Cloud 和自托管的 Twenty。也可以为 Twenty 的 REST API 构建 Webhook 工具，但 MCP 服务器所需设置更少：它为接待员提供用于查找和添加联系人的现成工具，已与工作区字段匹配，包括下方的来电原因字段。

设置

1

添加来电原因字段

Twenty 中的联系人没有自己的备注字段。要在联系人记录中保存来电原因，请前往 Settings → Data model，打开 People，然后添加一个名为 Call reason 的 Text 字段。只有工作区管理员可以更改数据模型。

2

为 Reception.ai 创建角色

前往 Settings → Members → Roles，创建一个只能读取和创建联系人的角色。下一步将为其分配 API 密钥。

3

创建 API 密钥

前往 Settings → Developers → API，然后选择 + Create key。为其命名，例如 Reception.ai，并立即复制：Twenty 只会显示一次。然后打开创建的角色，前往其 Assignment 标签页，并为其分配该密钥。

API 密钥可以读取和修改其角色允许的一切内容。请勿将其放入共享文档中， 若发生泄露，请在 Twenty 中将其删除。

4

添加 MCP 服务器

在 Reception.ai 中，前往 Integrations，选择 Add integration，然后选择 MCP Server。

字段值
NameTwenty
Server typeStreamable HTTP
Server URL工作区地址后加上 /mcp，如下所示
Secret TokenAPI 密钥
Twenty 运行位置服务器 URL
Twenty Cloud工作区 URL，例如 https://mycompany.twenty.com/mcp
自托管实例的公网 URL，例如 https://crm.example.com/mcp

可以在 Twenty 的 Settings → AI → MCP 中复制准确地址。请勿在 URL 中添加 ?mode=meta：该模式会向接待员提供一个可运行任何操作的单一工具。

选择 Enable。Reception.ai 会将该密钥作为 bearer token 发送，并列出 Twenty 的工具。

5

分配工具

Twenty 会为每个对象的每项操作列出一个工具。打开 Tools 标签页，只将以下工具分配给 Client（接待员）：

  • find_many_people：按电话号码查找来电者。
  • create_one_person：添加包含姓名、电话号码和来电原因的新来电者。

不要分配更新和删除工具，以及其他对象的工具。

6

添加流程

为新潜在客户添加一项流程：先按电话号码搜索来电者，仅在未找到匹配项时创建联系人，并始终填写名字、姓氏、电话号码和来电原因。添加一条规则，禁止接待员向来电者复述 CRM 记录。

7

测试

通过使用已保存到 Twenty 联系人中的号码来电，然后以希望获取报价的新来电者身份来电，测试接待员。新联系人会显示在 People 下，并已填写来电原因。

限制

  • Twenty 将国家/地区区号与号码其余部分分开存储。未保存国家/地区区号或采用不同格式保存的来电者可能无法被找到，因此回访来电者可能被重复添加。
  • 在此设置中，接待员不会创建备注、任务或商机。团队可从 People 列表中跟进新联系人，例如使用按 Call reason 筛选的视图。
  • 自托管实例需要使用包含 MCP 服务器的 Twenty 版本，且公网 URL 必须能通过 HTTPS 从互联网访问。
  • Twenty 的 API 每分钟允许 100 个请求。使用其他集成的繁忙工作区可能会达到此限制。

故障排除

问题检查项
未列出工具使用 Streamable HTTP 服务器类型，并检查 URL 是否以 /mcp 结尾。对于自托管，SERVER_URL 设置必须为公网 URL。
工具返回权限错误该密钥的角色无权读取或创建联系人。在 Settings → Members → Roles 中编辑角色。
未找到已知来电者使用包含国家/地区区号的统一格式存储电话号码。
来电原因为空添加 Call reason 字段后选择 Refresh tools，然后在已更改的工具上选择 Update。
已更改密钥编辑集成并使用 Rotate Secret Token (optional)。保存的密钥不会再次显示。