Twenty CRM MCP Server

二十台CRM（客户关系管理）+ MCP（可能是指某种特定的服务器或管理控制协议，具体需根据上下文确定，此处直译为“管理控制协议”服务器）服务器

完整的解决方案，集……于一体 二十个CRM（客户关系管理） 用一个 MCP服务器 （模型上下文协议）用于高级集成。

这是什么？

这个项目提供了一个容器化堆栈，其中包括：

• Twenty CRM（可译为“二十CRM”或根据具体语境译为“二十客户关系管理系统”，但通常保留原英文以指明特定产品或服务） - 现代且可扩展的CRM平台
• 二十个工人 - 异步任务处理器
• MCP 服务器 - 用于与人工智能和自动化集成的模型上下文协议服务器

版本0.2.0

MCP服务器已根据Twenty CRM应用的当前OpenAPI架构进行了重构。

主要变化

组件堆栈

该项目的架构由3个容器化服务组成：

1. “ambienz-twenty-server”可以翻译为“环境-二十服务器”或根据具体语境稍作调整，但直接翻译可能略显生硬。如果这是一个特定软件或系统名称，可能需要查找官方中文名称或根据上下文进行意译。不过，基于直接翻译的原则，“ambienz-twenty-server”即为“环境-二十服务器” - Twenty CRM（端口3000）

- CRM应用程序的主服务器 - 客户管理的网页界面 - 集成的REST API

1. 环境-二十名工人 - 二十名工人

- 异步作业处理器 - 自动化和工作流 - 与 Redis 集成

1. 环境-twenty-mcp服务器 - MCP 服务器（端口 3001）

- 服务器协议模型上下文 - 与人工智能和智能自动化集成 - 工具和上下文管理

更新后的基础URL

• 现在使用 https://twenty.ambienz.com.br/rest 默认
• 端点遵循Twenty CRM的REST标准

支持的对象

1. 人们 - 人员管理

- list_people， create_person， get_person， update_person， delete_person - 已更新的字段： name (物体)， emails (物体)， phones (对象)， linkedinLink， xLink

1. 公司 - 企业管理

- list_companies， create_company， get_company， update_company， delete_company - 巴西营地： cnpj， razaoSocial

1. 机会 - 机会管理

- list_opportunities， create_opportunity， get_opportunity， update_opportunity， delete_opportunity - 字段： amount （对象）， closeDate， stage， companyId， pointOfContactId

1. 注释 - 成绩管理

- list_notes， create_note， get_note， update_note， delete_note - Campos（人名或地名，根据上下文具体翻译，此处保留原样）： title， body， position

1. 任务 - 任务管理

- list_tasks， create_task， get_task， update_task， delete_task - 字段： title， body， dueAt， status， assigneeId

1. 对话 - 定制对象

- list_conversas， create_conversa， get_conversa， update_conversa， delete_conversa - Campos（人名或地名，具体根据上下文确定，此处直译为“坎波斯”）： name， conversasId， agent， lead

1. 发票 - 定制对象

- list_faturas， create_fatura， get_fatura， update_fatura， delete_fatura - 字段： name， status

分页和过滤器

所有列表端点现在都支持：

• filter - 用于过滤的JSON查询
• orderBy - 按字段排序
• limit - 结果限制（最多100条）
• depth - 关系的深度
• startingAfter / endingBefore - 分页光标

使用

# Configurar variáveis de ambiente
export TWENTY_API_KEY="your-api-key"
export TWENTY_BASE_URL="https://twenty.ambienz.com.br/rest"
export PORT=3000

# Executar servidor
node mcp/index.js

使用 Docker Compose 进行部署

要在本地部署完整堆栈：

# Copiar arquivo de ambiente
cp .env.example .env

# Iniciar todos os serviços
docker-compose up -d

# Verificar status
docker-compose ps

# Ver logs
docker-compose logs -f ambienz-twenty-mcp-server

Twenty CRM服务将在配置的URL上可用（例如： https://twenty.ambienz.com.br）以及在端口3001上的MCP服务器。

终点（或结局指标）

• GET /health - 健康检查
• POST /tools/:toolName - 运行特定工具
• POST /mcp - 通过服务器发送事件的终端MCP