rdstation-crm-mcp

rdstation-crm-mcp

一个开源的 MCP 服务，适用于 RD Station CRM——巴西和拉丁美洲领先的 CRM。直接通过 Claude 或任何兼容 MCP 的客户端管理联系人、交易、任务和备注，并获取销售管道健康报告。

“这个月我的销售管道情况如何？”→ 按阶段统计总数、成交率，以及停滞不前的交易。

原因

RD Station CRM 在拉丁美洲市场规模庞大，却没有开源的 MCP 服务。本项目将它接入 MCP 生态系统，让 AI Agent 能够处理你的销售管道：筛选潜在客户、推进交易、安排后续跟进，并用自然语言回答有关销售数据的问题。

快速开始

1. 在 RD Station CRM 中获取你的实例令牌：个人资料 → 产品和集成 → 实例令牌。
2. 将服务添加到你的 MCP 客户端。

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "rdstation-crm": {
      "command": "npx",
      "args": ["-y", "rdstation-crm-mcp"],
      "env": {
        "RDSTATION_CRM_TOKEN": "your-instance-token"
      }
    }
  }
}

Claude Code：

claude mcp add rdstation-crm -e RDSTATION_CRM_TOKEN=your-instance-token -- npx -y rdstation-crm-mcp

就这么简单。试着问 Claude：“列出我尚未完成的交易”或“给我一份销售管道概览”。

工具

工具	描述
rdcrm_search_contacts	按姓名、电子邮件或电话搜索联系人
rdcrm_get_contact	联系人详情，包括关联的交易
rdcrm_upsert_contact	创建联系人；如果电子邮件已存在，则更新联系人
rdcrm_list_deals	按状态、销售管道、阶段、负责人和日期筛选并列出交易
rdcrm_get_deal	交易详情：阶段、金额、负责人、联系人、产品
rdcrm_create_deal	创建交易——接受阶段名称，并自动解析
rdcrm_update_deal	推进阶段、更改负责人或评级、修改成交日期、暂停或恢复
rdcrm_close_deal	标记为赢单或输单（输单原因按名称解析）
rdcrm_list_tasks	按交易、负责人、状态、类型和截止日期列出任务
rdcrm_create_task	在交易中创建任务（电话、电子邮件、会议、WhatsApp 等）
rdcrm_add_note	向交易时间线添加备注
rdcrm_pipeline_overview	销售管道健康报告：各阶段总数、成交率、停滞交易

设计说明

这些工具专为大模型设计，而不是 1:1 的 API 封装：

• 使用名称而非 ID。 阶段、销售管道、用户和输单原因都可以按名称传入；服务会根据账户解析名称，如果不匹配，则列出有效选项。
• 响应精简。 列表工具为每条记录返回一行，只包含重要字段，并明确提示分页信息。响应过大时会截断并提供指引，而不是让上下文窗口被大量内容淹没。
• 错误信息可用于采取行动。 401 错误会告诉你应检查哪个环境变量；遇到未知阶段时，会列出所有销售管道中的每个阶段。
• 聚焦关键聚合。 rdcrm_pipeline_overview 通过一次工具调用，回答人们真正关心的问题（“哪些交易卡住了？”）。

远程部署（Streamable HTTP）

默认版本（rdstation-crm-mcp）通过 stdio 为单个本地用户运行，令牌从 RDSTATION_CRM_TOKEN 读取一次。对于团队托管或列入注册表的部署（例如 Smithery），请改为运行 Streamable HTTP 版本：

npx -y rdstation-crm-mcp-http

这会启动一个 HTTP 服务（默认地址为 http://127.0.0.1:8080/mcp），实现 MCP Streamable HTTP 传输，并正确管理会话生命周期（initialize → Mcp-Session-Id → DELETE 以关闭）。

由于托管服务可以为多个用户提供服务，因此没有单一的隐式令牌：每个会话都会在 initialize 时发送自己的 Authorization: Bearer <token> 标头。对于所有调用方共用一个 CRM 账户的单租户自托管设置，仍可将 RDSTATION_CRM_TOKEN 环境变量用作备用默认值。

环境变量：

变量	默认值	用途
PORT	8080	监听端口
HOST	127.0.0.1	绑定地址 — 容器或云环境中请使用 0.0.0.0
ALLOWED_HOSTS	（未设置）	以逗号分隔的 Host 标头允许列表（防止 DNS 重绑定）；在没有反向代理的情况下绑定到 0.0.0.0 时建议设置
RDSTATION_CRM_TOKEN	（未设置）	会话未发送 Authorization 标头时使用的默认令牌

curl http://127.0.0.1:8080/health
# {"status":"ok","server":"rdstation-crm-mcp","sessions":0}

开发

git clone https://github.com/fernandoludvig/rdstation-crm-mcp.git
cd rdstation-crm-mcp
npm install
npm test              # unit tests (API mocked with msw)
npm run typecheck
npm run build
RDSTATION_CRM_TOKEN=xxx npx @modelcontextprotocol/inspector node dist/index.js

HTTP 层（src/client/）与工具相互隔离，并内置了针对 429/5xx 的重试和指数退避机制。

路线图

• 组织和产品工具
• 在相同的工具接口下支持 RD Station CRM API v2（OAuth）
• 为远程部署提供 Streamable HTTP 传输
• 发布到 MCP 注册表（Glama、PulseMCP、Smithery）

欢迎贡献 — 对于任何较大的改动，请先提交 issue。

许可证

MIT © Fernando Ludvig

与 RD Station 无关联，也未获其认可。使用公开的 RD Station CRM API v1。