返回技能市场

LinkFox 包装的领星(Lingxing)ERP 技能「linkfox-lingxing-erp」:由 LinkFox Skills 仓库收录分发,封装领星官方 OpenAPI 文档与脚本用法,底层仍直连 openapi.lingxing.com(非 LinkFox 自建网关)。覆盖约 373 个接口场景,含广告报表 SP/SB/SD、订单与 Listing、库存仓库、财务与 FBA、源表、采购、客服、多平台广告与订单等。当用户提到领星、Lingxing、领星开放接口、领星 ERP 数据、领星广告报表、领星订单/库存/利润、领星 SID、Lingxing OpenAPI、Lingxing ERP data、LinkFox 领星、linkfox-lingxing-erp 时触发。分模块参数见 references/api.md 及各 references/*.md;需 LINGXING_APP_ID 与 LINGXING_APP_SECRET。

版本: 1.0.1分类: 文档处理
中文

SKILL.md

安装领星官方 MCP

只引导安装领星官方 MCP,不封装、代调或讲解任何领星业务 Tool/API。

官方依据

  • 只以领星官方指引为准:https://www.lingxing.com/help/article/mcp
  • 将服务器 URL、按钮名称、传输方式或配置字段与官方页面不一致时,以官方页面的当前内容为准。

必须执行的流程

  1. 识别当前 Agent 所在客户端及其 MCP 安装方式。可先只读检查是否已有 lingxing-mcp 连接;不要发现、列出或调用领星业务工具。
  2. 告知前置条件:领星付费用户需由超级管理员在【业务配置】→【开放接口】→【MCP】启用功能,当前帐号还需拥有相应权限。
  3. 在索取任何配置值前,完整读取 references/install.md,按其中“必须向用户展示的图文引导”发送文字和领星官方截图。不得只发一句“去获取 X-Mcp-Key”。
  4. 让用户亲自在领星 ERP 中复制两项配置:
    • 当前帐号对应的 MCP Server URL;
    • X-Mcp-Key 鉴权密钥。
  5. 优先通过当前客户端的安全凭据输入、Secret Store 或私密配置界面接收密钥。若客户端没有安全输入通道,让用户按 references/install.md 在本地自行填写配置,并只回复“已配置”;不要要求用户在普通聊天中粘贴完整密钥。
  6. 使用当前客户端原生的 MCP 添加方式保存连接:名称使用 lingxing-mcp,传输方式使用 Streamable HTTP / HTTP Streaming,URL 使用用户从领星复制的完整值,请求头名严格使用 X-Mcp-Key。
  7. 保存前向用户说明将写入哪个客户端、使用哪个服务器域名,并只显示掩码后的密钥。若用户已明确要求安装或配置,可直接继续;否则先取得明确同意。
  8. 仅验证 MCP 连接、鉴权和工具发现是否成功。不得为了验证而调用任何会读取或写入领星业务数据的工具。
  9. 成功后只报告连接已安装及验证结果。后续数据任务交由已安装的领星官方 MCP 处理,不在本 skill 中提供调用方法。

安全边界

  • 不代替用户登录领星,不索取帐号密码或验证码,不替用户创建、复制、重新生成或轮换密钥。
  • 将 MCP Server URL 与 X-Mcp-Key 都视为敏感配置;不要回显、记录到日志、提交到仓库或写进示例文件。
  • 不把真实密钥放进 shell 命令、命令历史、截图、测试输出或故障报告。
  • 若用户已在聊天中粘贴密钥,不要复述或使用该值;将其视为已暴露,让用户先在【管理MCP】中手动重新生成,再通过安全方式提供新密钥。
  • 若怀疑泄露,停止配置并让用户在【管理MCP】页面手动重新生成。

故障排查范围

只排查安装与鉴权:

  • 未看到 MCP 功能:确认付费资格及超级管理员是否已启用。
  • 鉴权失败:确认 URL 使用 https://、Header 名为 X-Mcp-Key、密钥复制完整且无多余空格。
  • 权限不符:说明服务器 URL 与当前领星帐号权限绑定,让用户换用正确帐号重新复制。
  • 客户端不支持自定义 Streamable HTTP MCP:明确说明该客户端无法按此方式安装,并引导用户查看客户端官方 MCP 支持文档。

不要通过 curl、Python、OpenAPI 或 MCP Tool 调用来诊断,不要查询库存、订单、利润、广告、Listing 或其他业务数据。

评论与讨论

0/2000

还没有评论,分享你的体验吧。