如何通过 MCP 将 amoCRM 连接到 Gemini

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → amoCRM、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

amoCRM + Gemini

让你的 AI 在 amoCRM 中工作：跨管道查找和更新交易，查询联系人和公司，读取任务、备注和事件日志，并记录新的任务和备注。适用于 amocrm.ru 上的账户，使用你账户中某个集成的长期令牌。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

AMOCRM_SUBDOMAIN, AMOCRM_ACCESS_TOKEN

步骤 1 — 获取凭证

1. 在 amoCRM 左侧菜单中打开 амоМаркет（amoMarket），点击右上角的 ⋯（在 + WEB HOOKS 旁边），选择 Создать интеграцию（创建集成），再选择 Внешняя интеграция（外部集成）。你需要是账户管理员。
2. 填写 Ссылка для перенаправления（重定向 URL）：表单要求必填，但长期令牌从不使用它，所以填写你自己的任意 https 地址即可。在 Предоставить доступ 下勾选所需权限，为集成填写名称和描述，然后点击 Сохранить（保存）。
3. 打开集成的 Ключи и доступы（密钥和访问）标签页，点击 Сгенерировать токен（生成令牌）。在 1 天到 5 年之间选择有效期，并立即复制令牌：amoCRM 只显示一次。
4. 将令牌粘贴到 AMOCRM_ACCESS_TOKEN，将账户子域名填入 AMOCRM_SUBDOMAIN：对于 https://acme.amocrm.ru，填写 acme。然后安装连接器。
5. 先运行 amocrm_get_account：它会显示账户、账户货币和任务类型。

amoCRM 还是 Kommo：两者是同一个产品。<subdomain>.amocrm.ru 上的账户使用这个连接器；旧的国际版地址 <subdomain>.amocrm.com 会跳转到那里，所以填写同一个子域名即可。<subdomain>.kommo.com 上的账户请使用 Kommo 连接器。

令牌归属：令牌以创建它的管理员的身份操作。可在集成的 Выданные доступы 标签页中点击 Отозвать доступ 撤销它。令牌到期后，生成新令牌并填入。

先确认：在创建或修改交易、创建联系人或任务、添加备注之前，AI 会向你展示将要写入的内容，并等待你确认。amoCRM 不会检查新联系人是否重复，所以 AI 会先搜索。

只读设置：amoCRM 令牌无法限制为只读，因此请停用 amocrm_create_lead、amocrm_update_lead、amocrm_create_contact、amocrm_create_task 和 amocrm_add_note。这个连接器中没有任何工具会删除数据。

管道、阶段和字段：在 API 中，交易称为线索（lead）。每笔交易都位于某个管道的某个阶段中，amocrm_list_pipelines 会列出它们。在每个管道中，阶段 142 都是 Closed-won（Успешно реализовано，成功成交），143 都是 Closed-lost（Закрыто и не реализовано，关闭未成交）。电话号码、邮箱地址和其他额外数据都是自定义字段，amocrm_list_custom_fields 会列出它们及其 id 和选项。负责人来自 amocrm_list_users。

备注和事件日志：amocrm_list_notes 读取单笔交易、单个联系人或公司的时间线。amocrm_list_notes_by_type 一次读取所有记录的备注，例如本周记录的所有通话。amocrm_list_events 读取账户的事件日志：阶段变更、新记录、字段和负责人的变更、通话、聊天消息和已完成的任务，并附有旧值和新值。

限制：每个集成每秒最多 7 个请求，每个账户每秒最多 50 个。超出后 amoCRM 返回 429；反复超限会封禁该账户的 API 访问，所有调用都返回 403。请让 AI 使用筛选或搜索，而不是逐页翻阅所有交易或事件。

常见错误：401 表示令牌错误、已过期或已撤销，或者 amocrm.ru 上没有这个子域名的账户（kommo.com 账户需要使用 Kommo 连接器）。402 表示订阅已结束：写入立即停止，读取在 30 天后停止。403 可能表示令牌所属用户权限不足，或因请求过多导致 API 访问被封禁。404 表示 id 或子域名错误。400 会列出无效字段，例如不属于该管道的阶段，或类型错误的自定义字段值。

这个连接器不会删除任何内容，也不处理客户（покупатели）、未分类的传入线索、聊天和消息、列表（目录）、Webhook 或 Salesbot。

步骤 2 — 安装 adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

步骤 3 — 在 Gemini 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Gemini CLI 从 ~/.gemini/settings.json（Windows 上为 %USERPROFILE%\.gemini\settings.json）读取 MCP 服务器。添加：

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在终端运行 gemini mcp list），anythingmcp 应显示为已连接。
4. 开始输入提示，Gemini CLI 现在可以调用 amoCRM 的工具。

可用工具

示例提示

• “销售管道中哪些交易处于谈判阶段？每笔交易的负责人是谁？”
• “本周是谁把交易改成了 Closed-lost？这些交易的金额是多少？”
• “显示从周一以来记录的所有来电，以及它们所属的交易。”
• “把交易“Stroymarket 仓库货架”移到 Closed-won，并为负责的经理创建一个周一的跟进任务。”

FAQ

Gemini CLI 从哪里读取 MCP 服务器？ 用户级配置位于 ~/.gemini/settings.json，项目级配置位于项目内的 .gemini/settings.json。gemini mcp list 会列出每个服务器及其连接状态。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT