MCP 与 Skill

智能报告对外暴露 3 个 MCP 服务（各 1 个工具），采用 Stream HTTP + Bearer 鉴权，与 Cursor 等 Agent 的 url 配置方式一致。

三个 MCP

MCP 路径（相对 `/api/v1`）	工具	作用
`/mcp/list-report-products/stream`	`list_report_products`	能力清单；可选 `category`: `enterprise` / `person`
`/mcp/get-report-product-guide/stream`	`get_report_product_guide`	详尽 fieldGuideMarkdown + reportWorkflow（先报表、后解读）
`/mcp/fetch-enterprise-data/stream`	`fetch_enterprise_data`	获取 reportData；含 nextStep 与 chargeNotice

生产环境 Base：https://console.haiyushuke.com/api/v1（与控制台同域 Platform）。

验证 Key 是否可用

推荐：在 Agent 中调用 list_report_products，能返回产品列表即表示 Key、IP 白名单与有效期正常。
check_mcp_connection 仅通过 POST /api/v1/mcp/invoke（stdio 桥接场景）提供；Stream MCP 配置（上表 3 个 url）不包含该工具，请勿在 mcp.json 里单独找第四个服务。

配置示例

将 sk-hyr-你的密钥 替换为控制台创建的 MCP Key：

{
  "mcpServers": {
    "haiyushuke-list-report-products": {
      "url": "https://console.haiyushuke.com/api/v1/mcp/list-report-products/stream",
      "headers": {
        "Authorization": "Bearer sk-hyr-你的密钥"
      }
    },
    "haiyushuke-get-report-product-guide": {
      "url": "https://console.haiyushuke.com/api/v1/mcp/get-report-product-guide/stream",
      "headers": {
        "Authorization": "Bearer sk-hyr-你的密钥"
      }
    },
    "haiyushuke-fetch-enterprise-data": {
      "url": "https://console.haiyushuke.com/api/v1/mcp/fetch-enterprise-data/stream",
      "headers": {
        "Authorization": "Bearer sk-hyr-你的密钥"
      }
    }
  }
}

Skill

Skill 教 Agent：调用顺序、入参规范、以及 encryptResult 时的 AES-GCM 解密（密钥为 MCP Key 的 SHA-256）。

在线加载（推荐给 Agent）：SKILL.md
一键安装页（复制 MCP、Cursor 链接、Skill 加载句）：Agent 一键安装

对 Agent 说：

请加载海宇数科「大模型智能报告」Skill：<你的官网域名>/download/haiyushuke-report-agent/SKILL.md

加密结果（可选）

fetch_enterprise_data 可传 encryptResult: true，响应使用 securePayload，解密后同样按 reportWorkflow 先整理报表再解读。

#MCP 与 Skill

#三个 MCP

#验证 Key 是否可用

#配置示例

#Skill

#加密结果（可选）

#相关链接