# 立刻智能体 MCP 接入 Claude Code 教程：使用 API Key 在终端调用企业知识库与业务工具

来源: https://www.likelic.com/blog/agent-mcp-claude-code-setup-guide.html

在使用 Claude Code 进行终端开发、脚本编写或自动化任务处理时，如果需要随时查阅企业内部技术文档与业务知识库、把新沉淀的排障经验写入知识库，或者直接查询汇率、HS 编码及立刻云订单信息，可以通过立刻智能体的 MCP（Model Context Protocol，模型上下文协议）直接接入。

与 Claude 网页版/桌面版使用 OAuth 授权不同，**Claude Code 采用企业 API Key 方式接入**。管理员或被授权人员在后台创建专属 Key、勾选所需工具并复制配置后，即可在本地终端环境中快速打通企业能力。

本文面向控制台管理员与开发者，介绍如何创建并授权 API Key、如何配置到 Claude Code，以及常见问题的排查处理。

一、接入前准备：确认套餐、入口与权限
------------------

1.  **适用套餐**：立刻智能体 **专业版 Pro**、**旗舰版 Ultra**（基础版暂不支持）。
2.  **功能入口**：控制台 → 外部拓展 → MCP管理。
3.  **管理权限说明**：
4.  企业管理员默认拥有全部 MCP 管理与开放 API 权限配置能力。
5.  若由指定员工负责配置，该员工须单独获得 **“MCP管理”** 权限（该权限依赖“API设置”，且不包含在“全部标准功能”授权模式中，需管理员单独勾选）。
6.  **注意**：为 Key 开通“MCP 接入”的开放 API 权限，仍只有**企业管理员**可以修改。
7.  _提示：使用 API Key 接入时，可用工具完全由企业套餐、Key 的能力授权与工具开关决定，不受员工个人业务权限限制。_

二、第一步：在立刻智能体控制台配置 API Key
-------------------------

### 1\. 新建并保存专属 Key

1.  进入 **外部拓展 → API设置**，点击新建一个 Key，建议单独命名为 **“Claude Code 接入”**。
2.  **重要提示**：完整 Key 只在新建时显示一次，请立即复制并妥善保存；后续在页面上只能查看 Key 前缀。建议为不同平台分别创建独立的 Key，方便后续独立管理工具开关与调用频率。

### 2\. 开通 MCP 和对应底层能力

1.  由**企业管理员**进入 **系统设置 → 开放 API 权限**，启用 **“MCP 接入”**，勾选刚刚创建的“Claude Code 接入” Key 并保存。
2.  根据你在 Claude Code 中需要使用的高级工具，在同一页面为该 Key 开通对应的底层能力：

| **需要使用的工具** | **需要为 Key 开通的能力** |
| --- | --- |
| 知识检索、智能体问答 | AI 会话 |
| 新增知识 | 知识库写入 |
| 可推送群列表、推送通知 | 推送通知 |
| HS 编码、汇率查询、舱单查询、立刻云查单 | 无需额外勾选能力（按套餐与工具开关控制） |

### 3\. 选择需要向 Claude Code 开放的工具

1.  进入 **外部拓展 → MCP管理 → 对外开放**，在“可用 Key”中选中刚才创建的 Key。
2.  在下方 **“工具清单”** 中按需开启工具：
3.  通常只读工具（如知识检索、智能体问答、HS 编码、汇率查询）默认开启。
4.  **“新增知识”**（会直接写入企业知识库）和 **“推送通知”**（会对外发送群消息且发出后不可撤回）默认关闭，开启时页面会进行二次确认，请按实际用途开放。
5.  **“立刻云单号查询”** 与 **“立刻云单证获取”**（仅旗舰版）默认均为关闭。如需使用，需先在 **系统设置 → 单号查询** 中配置立刻云服务地址，再回到工具清单中手动开启。
6.  _排查提示：如果某个工具开关置灰，可将鼠标悬停查看提示原因，确认是否存在套餐不支持、Key 缺少能力授权或工具暂不可用等情况。_

三、第二步：复制配置并接入 Claude Code
-------------------------

### 1\. 复制平台专属配置

1.  在 **外部拓展 → MCP管理 → 对外开放** 页面的 **“接入配置”** 区域，选择 **Claude Code** 平台。
2.  点击 **“复制配置”**，控制台会自动带入本企业的专属代码（`customer_code`），生成形如下方的标准服务地址与配置结构：
3.  `[https://agent.likelic.com/mcp?customer_code=你的企业代码](https://agent.likelic.com/mcp?customer_code=你的企业代码)`

### 2\. 填写到 Claude Code 并替换 Key

1.  按照页面说明，将复制的 MCP 配置粘贴到 Claude Code 的配置文件（如 `.mcp.json` 或全局配置）或通过命令行添加。
2.  将配置中的 Key 占位符替换为你第一步保存的 **完整 API Key**。
3.  **安全规范**：API Key 必须按照标准配置放入请求头（Headers）中，**切勿直接拼接到 URL 地址后面**。

### 3\. 检查开通状态并试用

1.  回到立刻智能体控制台，选中该 Key，点击 **“检查开通状态”**，确认 Key 状态、企业套餐与 MCP 接入权限均显示正常（_注：“检查开通状态”本身免费、不占调用次数，也不会产生调用记录_）。
2.  在终端启动 Claude Code，发起一次自然语言工具调用测试，随后前往控制台 **“调用记录”** Tab 中核对调用结果。

四、第三步：在 Claude Code 中调用工具实战示例
-----------------------------

接入成功后，你可以在终端与 Claude Code 交互时，直接让它调用企业工具辅助开发或处理业务：

1.  **查内部文档与沉淀技术知识**
2.  _“从企业知识库查一下，AI 应收录入接口和业务流程是怎么使用的？”_
3.  _“帮我把刚才整理的 webhook 签名校验排障步骤，新增一条问答到企业知识库中。”_
4.  **查询业务数据（汇率 / HS 编码）**
5.  _“帮我查询‘笔记本电脑’的 HS 编码及申报详情。”_
6.  _“查询美元兑人民币汇率，并换算 1,000 美元。”_
7.  **查询立刻云订单与获取单证（旗舰版）**
8.  _“查询企微群（群ID：xxxx）对应的这票订单（单号：XXXX），并获取提单文件下载链接。”_
9.  _使用提示：调用立刻云工具需提供订单号、群渠道（企微或 QQ）与群标识（可在目标群发送“群ID”获取，或让 Claude Code 调用“可推送群列表”查询）。单次订单查询最多返回 10 票信息；单证获取最多返回 5 份文件（≤50MB）的文件名与下载链接。_
10.  **自动化群通知推送**
11.  _“先查询当前可推送通知的群列表，然后向‘技术运维群’发送一条部署完成通知。”_

五、工具能力、计费与开关管理规则
----------------

### 1\. 工具能力与计费一览

| **工具名称** | **可以做什么** | **适用套餐** | **计费规则** |
| --- | --- | --- | --- |
| **知识检索** | 按问题检索企业知识库，返回命中的问答原文 | 专业版 / 旗舰版 | 只计向量化 Token |
| **智能体问答** | 向企业智能体提问，获取与开放 API 一致的回答 | 专业版 / 旗舰版 | 按实际消耗扣除套餐 Token |
| **新增知识** | 向企业知识库新增一条问答 | 专业版 / 旗舰版 | 只计向量化 Token |
| **HS 编码查询** | 按商品名称搜索编码，或查询编码详情 | 专业版 / 旗舰版 | 成功出站扣技能点，技术失败自动冲正 |
| **汇率查询** | 查询汇率并换算金额 | 专业版 / 旗舰版 | 免费 |
| **可推送群列表** | 查询当前可推送通知的群 | 专业版 / 旗舰版 | 免费 |
| **推送通知** | 向指定群发送通知 | 专业版 / 旗舰版 | 占用推送通知额度 |
| **舱单查询** | 按提运单号查询舱单状态 | 仅旗舰版 | 成功出站扣技能点，技术失败自动冲正 |
| **立刻云单号查询** | 查询指定客户群可见的单票信息 | 仅旗舰版 | 立刻智能体侧免费（占用立刻云共用查询频率） |
| **立刻云单证获取** | 获取指定订单的单证文件下载链接 | 仅旗舰版 | 立刻智能体侧免费（占用立刻云共用查询频率） |

### 2\. Key 管理与频率限制注意事项

1.  **独立控制与联动**：工具开关按 Key 分别设置。关闭某个工具后，该 Key 通过 MCP 调用“智能体问答”时，也不能再间接调用对应技能。
2.  **写入工具安全保护**：当 Key 被停用或移出相关能力授权时，已开启的写入类工具（新增知识、推送通知）会**自动关闭**；后续重新启用或重新授权后，需手动再次开启，不会自动恢复。
3.  **调用频率共用**：MCP 与开放 API 共用同一个 Key 的每分钟调用上限（RPM），Claude Code 建立连接、列出工具（List Tools）等握手请求也会计入调用次数。