领星MCP

一、什么是MCP

二、怎么启用

2.1 在领星AI助手中启用

1. 管理员需要在【业务配置】-【开放接口】-【MCP】中启用MCP功能（仅限付费用户）
2. 打开领星ERP系统，进入AI助手模块
3. 勾选MCP即可调用领星数据
4. 在对话框提问，AI自动识别并查询数据，返回结果

2.2 获取领星MCP配置地址

1. 直接在ERP中打开AI助手
2. 点击【管理MCP】
3. 点击复制服务器URL——链接会自动复制到剪切板，直接粘贴到三方应用即可

注意：该链接仅有当前领星帐号的数据权限，即通过该URL查询到的数据范围与当前登录帐号在ERP中的权限一致。

2.3 获取鉴权密钥（X-Mcp-Key）

MCP服务需要鉴权才能调用，除了服务器URL外，还需要一个鉴权密钥：

1. 在【管理MCP】页面，点击 复制鉴权密钥（X-Mcp-Key）
2. 该密钥与当前领星帐号绑定，用于验证调用者身份

重要：

• 服务器URL和鉴权密钥是两个独立的值，缺一不可。
• 鉴权密钥请妥善保管，请勿分享给他人，以免数据泄露。
• 如果密钥泄露，可在【管理MCP】页面重新生成。

三、如何在第三方应用中使用

领星MCP支持接入任何支持自定义MCP工具的AI平台（如Cursor、ChatGPT、Claude、Gemini、Trae、通义千问等），配置方法通用。

3.1 配置要素

接入领星MCP需要两个值：

完整配置格式如下：

{
  "mcpServers": {
    "lingxing-mcp": {
      "type": "streamableHttp",
      "url": "https://openmcp.lingxing.com/mcp-servers/lingxing-mcp",
      "headers": {
        "X-Mcp-Key": "<你的鉴权密钥>"
      }
    }
  }
}

说明：如果你的日常使用是以某个固定用户身份进行操作，可以将用户身份参数拼接到URL中，这样在构建或调用AI Agent时无需重复传入，简化调用过程。

3.2 在各AI工具中配置

在Cursor中配置

1. 打开Cursor，进入 Settings > MCP
2. 点击 + Add new global MCP server
3. 配置如下（将URL和X-Mcp-Key替换为你自己的值）：

{
  "mcpServers": {
    "lingxing-mcp": {
      "url": "https://openmcp.lingxing.com/mcp-servers/lingxing-mcp",
      "transport": "streamable_http",
      "headers": {
        "X-Mcp-Key": "<你的鉴权密钥>"
      }
    }
  }
}

4. 保存后，在AI对话中即可调用领星数据

在Trae中配置

1. 在Trae中，进入 设置 > MCP，单击 + 添加 MCP > 手动添加
2. 在手动配置中填入以下信息，将URL和X-Mcp-Key替换为你的值：

{
  "mcpServers": {
    "lingxing-mcp": {
      "url": "https://openmcp.lingxing.com/mcp-servers/lingxing-mcp",
      "headers": {
        "X-Mcp-Key": "<你的鉴权密钥>"
      }
    }
  }
}

3. 将该MCP添加到智能体，在AI对话中@智能体即可使用

在其他AI工具中配置

领星MCP可与任何支持自定义工具的AI平台集成，通用配置步骤：

1. 获取MCP Server URL 和 X-Mcp-Key 鉴权密钥
2. 在AI工具的MCP/工具管理中，选择"添加自定义MCP工具"
3. 填入服务器URL，传输方式选择 HTTP Streaming / Streamable HTTP
4. 在请求头（Headers）中添加 X-Mcp-Key: <你的鉴权密钥>
5. 保存后即可在对话中使用

提示：若需为团队分享使用该服务，建议将URL中的用户身份参数设置为变量，通过Header传入，以实现不同人使用AI服务时能正确鉴权。

四、工具能力

五、常见问题

Q1：MCP和普通API有什么区别？

A：普通API需要写代码对接，MCP是标准化协议（Model Context Protocol），配置更简单，AI助手能直接理解并调用，无需手动写代码。你只需要用自然语言提问，AI会自动选择合适的Tool并返回结果。

Q2：数据是实时的吗？

A：是的，数据与ERP页面数据一致，实时同步。

Q3：查询有次数限制吗？

A：目前无查询次数限制。但是每秒钟只能查询1次（QPS=1）。

Q4：MCP配置后未生效怎么办？

A：此问题通常是由于以下原因导致：

1. 配置的工具集过多：配置的工具集过多可能导致大模型无法正确选择工具。请尝试移除其他MCP工具，仅保留必要的工具。
2. 提示词不够精确：当提示词不够精确时，模型可能无法正确调用工具。请使用更具体的查询，例如："查一下ASIN B0XXXXXX的FBA库存情况"。
3. 权限未开通：确保MCP Server已在对应空间中启用，且当前帐号拥有相关数据的查看权限。

Q5：鉴权失败怎么办？

A：请按以下步骤排查：

1. 检查X-Mcp-Key是否配置：MCP服务需要鉴权密钥才能调用。请确认在AI工具的MCP配置中，headers里已添加 "X-Mcp-Key": "<你的鉴权密钥>"。仅配置URL而不配置鉴权头，会导致鉴权失败。
2. 检查密钥是否正确：在ERP的【AI助手】-【管理MCP】页面重新复制鉴权密钥，确保复制完整、无多余空格。
3. 检查MCP功能是否启用：需要超级管理员在【业务配置】-【开放接口】-【MCP】中启用MCP功能（仅限付费用户）。
4. 检查帐号权限：MCP Server URL与当前领星帐号的数据权限绑定，请确认帐号是否拥有相关数据的查看权限。
5. 检查URL协议：服务器URL应使用 https:// 协议，而非 http://。

Q6：领星MCP支持哪些AI工具？

A：领星MCP支持任何支持自定义MCP工具的AI平台，包括但不限于：OpenClaw、WorkBuddy、Cursor、ChatGPT、Claude、Gemini、Trae、通义千问、Manus、百度千帆等。传输方式为 Streamable HTTP（HTTP Streaming）。

Q7：不同帐号获取的MCP URL有什么区别？

A：MCP Server URL与当前领星帐号的数据权限绑定。不同帐号获取的URL可查询的数据范围不同，取决于该帐号在ERP中的权限配置。请勿将个人MCP URL和鉴权密钥分享给他人使用，以免数据泄露。