在使用 Cursor 编写代码、撰写技术方案或处理日常自动化任务时，如果需要查阅企业内部知识库与接口规范、将最新排障经验沉淀回知识库，或者直接查询实时汇率、HS 编码及立刻云订单信息，无需切出编辑器——通过立刻智能体的 MCP（Model Context Protocol，模型上下文协议）即可直接接入。
Cursor 支持通过 企业 API Key 方式接入 MCP。管理员在后台创建专属 Key、开启所需工具并复制配置后，即可在 Cursor 的 Agent / Composer 对话框中直接调用授权范围内的企业能力。
本文面向控制台管理员与 Cursor 使用者，介绍如何配置 API Key、如何将 MCP 接入 Cursor，以及常见问题的排查处理。
一、接入前准备：确认套餐、入口与权限
- 适用套餐：立刻智能体 专业版 Pro、旗舰版 Ultra（基础版暂不支持）。
- 功能入口：控制台 → 外部拓展 → MCP管理。
- 管理权限说明：
- 企业管理员始终拥有全部 MCP 管理权限。
- 员工如需管理接入，须单独获得 “MCP管理” 权限（该权限依赖“API设置”，且不包含在“全部标准功能”授权模式中，需要管理员单独勾选）。
- 为 Key 开通“MCP 接入”的开放 API 权限，仍只有企业管理员可以修改。
- 注：使用 API Key 接入 Cursor 时，实际可用工具取决于企业套餐、Key 的能力授权与工具开关，不受员工个人业务权限限制。
二、第一步：在立刻智能体控制台配置 API Key
1. 新建并保存专属 Key
- 进入 外部拓展 → API设置，新建一个 Key，例如命名为 “Cursor 接入”。
- 重要提示：完整 Key 只在新建时显示一次，请及时复制并妥善保存；后续页面只能查看前缀。建议为不同平台分别创建独立的 Key，方便独立管理工具开关与调用频率。
2. 开通 MCP 和对应底层能力
- 由企业管理员进入 系统设置 → 开放 API 权限，启用 “MCP 接入”，勾选刚创建的“Cursor 接入” Key 并保存。
- 根据需要，在同一页面为该 Key 开通对应的底层能力：
| 需要使用的工具 | 需要开通的能力 |
| 知识检索、智能体问答 | AI 会话 |
| 新增知识 | 知识库写入 |
| 可推送群列表、推送通知 | 推送通知 |
| HS 编码、汇率查询、舱单查询、立刻云查单 | 无需额外勾选能力（按套餐与工具开关控制） |
3. 选择需要向 Cursor 开放的工具
- 进入 外部拓展 → MCP管理 → 对外开放，在“可用 Key”中选中该 Key，再到 “工具清单” 按需开启工具：
- 通常只读工具（知识检索、智能体问答、HS 编码、汇率查询等）默认开启。
- “新增知识”（会写入企业知识库）和 “推送通知”（会对外发送且发出后不能撤回）默认关闭，开启时页面会二次确认，请按实际用途开放。
- “立刻云单号查询” 与 “立刻云单证获取”（仅旗舰版）默认均为关闭。使用前需先在 系统设置 → 单号查询 中配置立刻云服务地址，再回到工具清单手动开启。
- 如果某个工具开关置灰，可以查看提示原因，确认是否存在套餐不支持、Key 缺少能力授权或工具暂不可用等情况。
三、第二步：复制配置并接入 Cursor
1. 复制平台配置
- 在 外部拓展 → MCP管理 → 对外开放 页面的 “接入配置” 区域中，选择 Cursor。
- 点击 “复制配置”，控制台会自动带入本企业代码（
customer_code），生成的 Key 接入服务地址形如：https://agent.likelic.com/mcp?customer_code=你的企业代码
2. 填写到 Cursor 设置中
- 打开 Cursor 编辑器，进入 Cursor Settings → Features → MCP（或对应的
.cursor/mcp.json配置文件）。 - 按照控制台页面说明，将复制的接入配置粘贴到 Cursor 中，并将配置里的 Key 占位符替换为你第一步保存的 完整 API Key。
- 安全规范：Key 必须按配置放入请求头（Headers）中，不要直接拼接到 URL 地址中。
3. 检查开通状态并试用
- 回到立刻智能体控制台，选中该 Key，点击 “检查开通状态”，确认 Key、套餐与 MCP 接入状态正常（“检查开通状态”本身不计费、不占调用次数，也不会产生调用记录）。
- 在 Cursor 的 MCP 列表中确认服务状态亮起（Connected）并成功加载工具列表，随后在 Cursor 的 Agent 对话框中发起一次工具调用，再到控制台 “调用记录” 中检查结果。
四、第三步：在 Cursor 中调用工具实战示例
接入并开启对应工具后，你可以在 Cursor 的对话窗口（Agent 模式）中直接提出以下请求：
- 查企业知识库与沉淀技术文档
- “从企业知识库查一下，AI 应收录入怎么使用？”
- “帮我把当前项目整理的接口联调 FAQ，新增一条问答到企业知识库。”
- 查询 HS 编码与实时汇率
- “帮我查询‘笔记本电脑’的 HS 编码及申报详情。”
- “查询美元兑人民币汇率，并换算 1,000 美元。”
- 查询立刻云订单与获取单证（旗舰版）
- “查询指定客户群（企微群ID：xxxx）对应的这票订单，并获取提单文件下载链接。”
- 使用说明：查询需准备订单号、群渠道（企微或 QQ）与群标识（可在目标群中发送“群ID”获取，也可在具备推送通知能力时让 AI 助手查询“可推送群列表”）。订单查询最多返回 10 票信息；单证获取最多返回 5 份文件（≤50MB）的文件名和下载链接，超出部分会提示登录系统查看。
- 发送群通知
- “查询当前可推送通知的群列表，并向目标群发送一条版本发布通知。”
五、工具能力、计费与开关管理
1. 工具能力与计费一览
| 工具名称 | 可以做什么 | 适用套餐 | 计费规则 |
| 知识检索 | 按问题检索企业知识库，返回命中的问答原文 | 专业版 / 旗舰版 | 只计向量化 Token |
| 智能体问答 | 向企业智能体提问，获取与开放 API 一致的回答 | 专业版 / 旗舰版 | 按实际消耗扣除套餐 Token |
| 新增知识 | 向企业知识库新增一条问答 | 专业版 / 旗舰版 | 只计向量化 Token |
| HS 编码查询 | 按商品名称搜索编码，或查询编码详情 | 专业版 / 旗舰版 | 成功出站扣技能点，技术失败自动冲正 |
| 汇率查询 | 查询汇率并换算金额 | 专业版 / 旗舰版 | 免费 |
| 可推送群列表 | 查询当前可推送通知的群 | 专业版 / 旗舰版 | 免费 |
| 推送通知 | 向指定群发送通知 | 专业版 / 旗舰版 | 占用推送通知额度 |
| 舱单查询 | 按提运单号查询舱单状态 | 仅旗舰版 | 成功出站扣技能点，技术失败自动冲正 |
| 立刻云单号查询 | 查询指定客户群可见的单票信息 | 仅旗舰版 | 立刻智能体侧免费（占用立刻云共用查询频率） |
| 立刻云单证获取 | 获取指定订单的单证文件下载链接 | 仅旗舰版 | 立刻智能体侧免费（占用立刻云共用查询频率） |
2. 工具开关与频率管理规则
- 按 Key 独立控制：工具开关按 Key 分别设置。关闭某个工具后，该 Key 通过 MCP 调用智能体问答时，也不能再间接调用对应技能；控制台和其他渠道不受影响。
- 写入类工具自动保护：Key 被停用或移出相关能力授权时，已开启的写入类工具（新增知识、推送通知）会自动关闭。重新启用或授权后，需要手动开启，不会自动恢复。
- 调用频率共用：MCP 与开放 API 共用同一 Key 的每分钟调用上限，Cursor 建立连接、刷新列出工具等请求也计入次数。