AI导哈

CRM与MCP服务器集成

一个结合了Twenty CRM和MCP Server的完整解决方案，提供客户关系管理、异步任务处理和智能自动化集成。

  • by denisalmeida
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 denisalmeida/twenty-crm-mcp

使用说明

二十台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

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

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

  3. 环境-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

  2. 公司 - 企业管理

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

  3. 机会 - 机会管理

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

  4. 注释 - 成绩管理

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

  5. 任务 - 任务管理

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

  6. 对话 - 定制对象

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

  7. 发票 - 定制对象

    • 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

相关 MCP