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