摘要
让你的 AI 在 Kommo CRM 中工作:跨管道查找和更新线索,查询联系人和公司,跟进任务和备注,并记录新的任务和备注。通过私有集成的长期令牌连接一个账户。
引导式设置
2 分钟将 Kommo 连接到 Microsoft Copilot
开始 AnythingMCP Cloud 免费试用,在引导式设置中连接 Kommo,再把你的 MCP URL 添加到 Microsoft Copilot。无需代码,也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
试试这样问
Kommo 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Kommo、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无
git clone、无本地服务器。
Kommo + Microsoft Copilot
让你的 AI 在 Kommo CRM 中工作:跨管道查找和更新线索,查询联系人和公司,跟进任务和备注,并记录新的任务和备注。通过私有集成的长期令牌连接一个账户。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
KOMMO_SUBDOMAIN, KOMMO_ACCESS_TOKEN
步骤 1 — 获取凭证
- 在 Kommo 中,打开 Settings → Integrations,点击右上角的 Create integration。你需要是账户管理员。
- 选择私有集成,Redirect URL 留空,保留你需要的访问权限范围,然后点击 Save。
- 打开该集成的 Keys and scopes 标签页,点击 Generate long-lived token。选择到期日期,并立即复制令牌:Kommo 只显示一次。
- 把令牌填入
KOMMO_ACCESS_TOKEN,把账户的子域名填入KOMMO_SUBDOMAIN:例如https://acme.kommo.com填写acme。然后安装连接器。 - 先运行
kommo_get_account:它会显示账户、账户货币和任务类型。
amoCRM 账户:Kommo 是 amoCRM 的国际版。地址以 .amocrm.ru 结尾的账户(或会跳转到那里的旧地址 .amocrm.com)无法使用这个连接器:请改用 amoCRM 连接器。
令牌归属:令牌以创建它的管理员的身份操作。可在集成的 Authorization 标签页中撤销它。令牌到期后,生成新令牌并填入。
只读设置:Kommo 令牌无法限制为只读,因此请停用 kommo_create_lead、kommo_update_lead、kommo_create_contact、kommo_create_task 和 kommo_add_note。这个连接器中没有任何工具会删除数据。
管道、阶段和字段:每条线索都位于某个管道的某个阶段中,kommo_list_pipelines 会列出它们。在每个管道中,阶段 142 都是 Closed-won,143 都是 Closed-lost。电话号码、邮箱地址和其他额外数据都是自定义字段,kommo_list_custom_fields 会列出它们及其 id 和选项。
备注和事件:kommo_list_notes 读取单条线索、联系人或公司的时间线。kommo_list_notes_by_type 一次读取所有线索、联系人或公司的备注,可按备注类型、记录或最后更新时间筛选,例如本周记录的所有通话。kommo_list_events 读取账户的事件日志:阶段变更、新记录、字段和负责人的变更、通话、聊天消息和已完成的任务,并显示操作人和时间。
已经安装过? 按类型读取备注和事件日志的工具会通过目录更新加入你之前安装的连接器:在 AnythingMCP 中打开该连接器,在 Catalog update available 下查看新工具列表,然后点击 Apply update。你的令牌和你自己添加的工具保持不变。
限制:Kommo 每个账户每秒最多允许 7 个请求。超出后 Kommo 返回 429;反复超限会导致该 IP 地址被封禁,所有调用都返回 403。请让 AI 使用筛选或搜索,而不是逐页翻阅所有线索。
常见错误:401 表示令牌错误、已过期或已撤销:请生成新令牌。402 表示账户的订阅已失效。403 可能表示令牌所属用户权限不足,或 IP 地址因请求过多已被封禁。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 — 在 Microsoft Copilot 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
Microsoft Copilot 通过在 Copilot Studio 中构建的智能体使用 MCP 服务器:把 AnythingMCP 作为工具添加到智能体,然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 的云端通过 Streamable HTTP 连接,AnythingMCP 支持这种方式。
- 在 Copilot Studio 中打开你的智能体(或新建一个),进入 Tools,选择 Add a tool → New tool → Model Context Protocol。
- 填写 Server name(例如
AnythingMCP)、说明连接器用途的 Server description,以及 Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 根据描述决定何时调用该服务器。 - 身份验证选择 API key,把 Type 设为 Header,请求头名称填
X-API-Key,然后选择 Create。 - 在 Add tool 中选择 Create a new connection,粘贴 AnythingMCP 的 MCP API 密钥(MCP Servers → 你的服务器 → API keys),然后选择 Add to agent。
- 在智能体的 Test 窗格中试一试:提出需要用到
Kommo的工具的请求。 - 选择 Publish,然后进入 Channels → Microsoft 365 and Microsoft Teams,保持勾选 Make agent available in Microsoft Copilot,再选择 Add channel。See agent in Teams 会为你安装该智能体;在 Microsoft 365 Copilot 中输入 @ 并选择该智能体。
希望每个用户各自登录?请选择 OAuth 2.0 → Dynamic discovery 代替 API 密钥:每个用户会在智能体首次调用时登录 AnythingMCP。
自托管?请用你实例的公网 HTTPS 地址替换 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 的云端连接,因此 localhost 无法使用。
可用工具
| Tool | What it does |
|---|---|
kommo_get_account | Get the Kommo account: id, name, subdomain, current user id, country, currency, language, and with the default extras its task types (ids… |
kommo_list_leads | List or search leads (deals): id, name, price, pipeline and stage (status_id), responsible user, dates, tags, custom fields and, with… |
kommo_get_lead | Get one lead by id with its name, price, pipeline, stage, responsible user, dates, tags, custom field values, linked company and, by… |
kommo_create_lead | Create a lead, optionally in a given pipeline and stage, with price, responsible user, custom fields, tags and links to existing contacts… |
kommo_update_lead | Change a lead: name, price, stage or pipeline (moving it through the funnel; Closed-won is status 142, Closed-lost 143), responsible user… |
kommo_list_contacts | List or search contacts: id, name, first and last name, responsible user, dates, tags, custom fields (phone and email are custom fields)… |
kommo_get_contact | Get one contact by id with names, responsible user, tags, custom field values (phones, emails, position), linked companies and, by default… |
kommo_create_contact | Create a contact with name, responsible user, phone, email and other custom fields, and tags |
kommo_list_companies | List or search companies: id, name, responsible user, dates, tags, custom fields and, with with=leads,contacts, linked leads and contacts |
kommo_list_pipelines | List the lead pipelines with their stages: pipeline id, name, whether main or archived, and per stage (in _embedded.statuses) its id, name… |
kommo_list_custom_fields | List the custom fields of leads, contacts or companies: id, name, code (PHONE, EMAIL for contacts), type and, for select fields, the enum… |
kommo_list_tasks | List tasks: id, text, type, deadline (complete_till), whether completed, result, responsible user and the lead, contact or company it… |
kommo_create_task | Create a task with a deadline, linked to a lead, contact or company, for a responsible user |
kommo_list_notes | Read the notes (timeline entries) of one lead, contact or company: id, type (common text note, call_in, call_out, sms, service messages… |
kommo_list_notes_by_type | Read notes across all leads, contacts or companies at once, not just one record: id, entity_id of the record it belongs to, type (common… |
kommo_add_note | Add a text note to the timeline of a lead, contact or company |
kommo_list_users | List the account's users: id, name, email, language and rights, and with with=role,group their role and group |
kommo_list_events | Read the account's event log: who did what and when |
示例提示
- “销售管道中哪些线索在谈判阶段停留超过两周了?”
- “找到联系人 Maria Lopez,显示她的电话号码和她未完成的线索。”
- “把线索“Nova 网站改版”移到 Closed-won,并添加一条备注,说明合同已经签署。”
- “在线索“2026 车队订单”上为负责的经理创建一个明天 10:00 的电话任务。”
- “本周有哪些线索被移到了 Closed-won 或 Closed-lost?是谁移动的?”
- “列出从周一以来线索上记录的所有通话,并注明每个通话属于哪条线索。”
FAQ
这适用于哪个 Copilot? 适用于工作中的 Microsoft 365 Copilot,通过 Copilot Studio 的智能体实现。面向个人账户的 Microsoft Copilot 应用无法添加自己的 MCP 服务器。
我需要什么? 一个可以使用 Copilot Studio 的工作账户(许可证或试用版),用于构建智能体。在 Microsoft 365 Copilot 或 Teams 中使用它的人需要拥有该智能体的访问权限:把它共享给他们,或请管理员为整个组织发布。如果你的组织对 Power Platform 连接器设置了数据策略,这些策略同样适用于 MCP 服务器。
智能体不调用工具。 检查请求头名称是否正好是 X-API-Key,密钥是否属于与 URL 相同的 MCP 服务器,并把 Server description 写得具体:Copilot Studio 根据它决定何时调用服务器。每次修改后重新发布智能体;在已打开的对话中输入 "start over" 即可使用新版本。
下一步
这份指南对你有帮助吗?