二十台CRM（客户关系管理）+ MCP（可能是指某种特定的服务器或管理控制协议，具体需根据上下文确定，此处直译为“管理控制协议”服务器）服务器
完整的解决方案，集……于一体 二十个CRM（客户关系管理） 用一个 MCP服务器 （模型上下文协议）用于高级集成。
这是什么？
这个项目提供了一个容器化堆栈，其中包括：
- Twenty CRM（可译为“二十CRM”或根据具体语境译为“二十客户关系管理系统”，但通常保留原英文以指明特定产品或服务） - 现代且可扩展的CRM平台
- 二十个工人 - 异步任务处理器
- MCP 服务器 - 用于与人工智能和自动化集成的模型上下文协议服务器
版本0.2.0
MCP服务器已根据Twenty CRM应用的当前OpenAPI架构进行了重构。
主要变化
组件堆栈
该项目的架构由3个容器化服务组成：
- “ambienz-twenty-server”可以翻译为“环境-二十服务器”或根据具体语境稍作调整，但直接翻译可能略显生硬。如果这是一个特定软件或系统名称，可能需要查找官方中文名称或根据上下文进行意译。不过，基于直接翻译的原则，“ambienz-twenty-server”即为“环境-二十服务器” - Twenty CRM（端口3000）
- CRM应用程序的主服务器 - 客户管理的网页界面 - 集成的REST API
- 环境-二十名工人 - 二十名工人
- 异步作业处理器 - 自动化和工作流 - 与 Redis 集成
- 环境-twenty-mcp服务器 - MCP 服务器（端口 3001）
- 服务器协议模型上下文 - 与人工智能和智能自动化集成 - 工具和上下文管理
更新后的基础URL
- 现在使用
https://twenty.ambienz.com.br/rest默认 - 端点遵循Twenty CRM的REST标准
支持的对象
- 人们 - 人员管理
- list_people， create_person， get_person， update_person， delete_person - 已更新的字段： name (物体)， emails (物体)， phones (对象)， linkedinLink， xLink
- 公司 - 企业管理
- list_companies， create_company， get_company， update_company， delete_company - 巴西营地： cnpj， razaoSocial
- 机会 - 机会管理
- list_opportunities， create_opportunity， get_opportunity， update_opportunity， delete_opportunity - 字段： amount （对象）， closeDate， stage， companyId， pointOfContactId
- 注释 - 成绩管理
- list_notes， create_note， get_note， update_note， delete_note - Campos（人名或地名，根据上下文具体翻译，此处保留原样）： title， body， position
- 任务 - 任务管理
- list_tasks， create_task， get_task， update_task， delete_task - 字段： title， body， dueAt， status， assigneeId
- 对话 - 定制对象
- list_conversas， create_conversa， get_conversa， update_conversa， delete_conversa - Campos（人名或地名，具体根据上下文确定，此处直译为“坎波斯”）： name， conversasId， agent， lead
- 发票 - 定制对象
- 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-serverTwenty CRM服务将在配置的URL上可用（例如： https://twenty.ambienz.com.br）以及在端口3001上的MCP服务器。
终点（或结局指标）
GET /health- 健康检查POST /tools/:toolName- 运行特定工具POST /mcp- 通过服务器发送事件的终端MCP