鲸海MCP接入指南-3步接入AI Agent企业数据能力

STEP 01

第一步：获取 API Key 并复制通用配置

获取专属 API Key 后使用统一正式 MCP Endpoint，兼容 Streamable HTTP 与 SSE，覆盖企业工商、风险司法、知识产权、经营动态、高管背景和历史沿革。

复制前确认

登录或注册后进入用户后台，系统会为账号生成专属 API Key。
将 JSON 中的 YOUR_API_KEY 替换为自己的 Key。
正式环境使用统一 MCP 地址，Streamable HTTP 与 SSE 客户端均可接入，工具域由鲸海 MCP 服务自动路由。
保存配置后，重启或刷新 AI 工具的 MCP 列表。

jinghai-mcp-config.json

{
  "mcpServers": {
    "jinghai-mcp": {
      "url": "https://www.kqdaas.com/mcp/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

STEP 02

第二步：MCP 接入，选择你的 AI 工具

请按客户端实际能力选择自动或手动接入。新客户端优先使用 Streamable HTTP。

W

WorkBuddy ★ 腾讯云出品

适合构建具备鲸海企业数据能力的国产 Agent 工作流。直接在对话中发送配置，WorkBuddy 自动完成 MCP 接入。

领取 API Key

接入步骤

在 WorkBuddy 对话框输入「请配置鲸海MCP」，并粘贴上方通用 JSON。
将 YOUR_API_KEY 替换为你的真实鲸海 API Key。
重启 WorkBuddy 或刷新当前会话，使配置生效。
发送「查询示例科技股份有限公司的股东结构」，看到 jinghai-company (get_business_shareholder) 运行成功。

WorkBuddy 对话框请配置鲸海MCP { "mcpServers": ... }鲸海企业实时数据

[ 配置 ]

# 直接将通用配置 JSON 发送给 WorkBuddy 对话框
# WorkBuddy 自动完成 MCP 配置，无需手动编辑文件

[ 验证 ]

# 在对话框中问一句：
"查询示例科技股份有限公司的股东结构"
# → 看到 jinghai-company (get_business_shareholder) 运行成功
# → 返回主要股东、持股比例、持股数，说明接入成功

Q

QoderWork ★ 阿里 Qoder 出品

面向文档、数据分析和生成场景，原生支持 MCP。对话中一句话即可调用鲸海实时企业数据。

领取 API Key

接入步骤

在 QoderWork 对话框输入「请配置鲸海MCP」，并粘贴通用 JSON。
QoderWork 自动完成 MCP 配置，无需手动编辑文件。
发送「查询示例科技股份有限公司的股东结构」。
看到 jinghai-company (get_business_shareholder) 运行成功，即说明接入成功。

[ 配置 ]

# 直接将通用配置 JSON 发送给 QoderWork 对话框
# QoderWork 自动完成 MCP 配置，无需手动编辑文件

[ 验证 ]

# 在对话框中问一句：
"查询示例科技股份有限公司的股东结构"
# → 看到 jinghai-company (get_business_shareholder) 运行成功
# → 返回主要股东、持股比例、持股数，接入成功

C

QClaw 手动 MCP 配置

当前不使用市场连接或一键授权。请在 QClaw 的 MCP 配置入口手动新增鲸海远程 MCP 服务。

领取 API Key

接入步骤

打开 QClaw 的 MCP / 连接器配置，选择新增自定义 MCP。
选择 Streamable HTTP，粘贴上方通用 JSON 或填写统一 URL 与 Authorization Header。
保存后重启或刷新 MCP 工具列表，确认 jinghai-mcp 已加载。
使用企业全称发送查询，确认出现 get_business_info 等真实工具调用结果。

[ 配置 ]

# QClaw：新增自定义 MCP / 远程 MCP
# Transport: Streamable HTTP
# URL: https://www.kqdaas.com/mcp/api/mcp
# Header: Authorization: Bearer YOUR_API_KEY

[ 验证 ]

# 在 QClaw 对话框问一句：
"查询成都乐云互动网络技术有限公司的工商信息"
# → 看到 get_business_info 运行成功
# → 返回企业基础信息等实时字段，非网络搜索

I

IMA 暂不支持自定义 MCP

IMA 当前没有面向普通用户的自定义远程 MCP 配置入口；鲸海 MCP 暂不能通过 IMA 手动接入。

查看通用客户端

接入步骤

当前无需复制 API Key 或尝试手动粘贴 MCP JSON。
IMA 的 MCP 页面仅支持其官方市场内已上架的服务。
鲸海 MCP 暂未以 IMA 官方市场服务提供。
请改用 Trae、Cursor、Claude Code、Codex、Cline 或其他支持自定义 MCP 的客户端。

[ 当前状态 ]

# IMA 暂不支持普通用户手动配置自定义 MCP
# 请勿将 API Key 粘贴到不受支持的入口
# 等待鲸海 MCP 在 IMA 官方市场上架后再使用

[ 替代方案 ]

# 使用“通用 MCP 配置”页中的 JSON
# 在支持自定义 MCP 的 AI 客户端完成接入

M

MiniMax 手动 MCP 配置

请在 MiniMax 客户端的第三方 MCP 配置入口手动添加鲸海 MCP，不使用官网市场或一键授权流程。

领取 API Key

接入步骤

在 MiniMax 的 MCP 工具列表中选择「配置第三方 MCP」。
新增服务名称 jinghai-mcp，协议选择 Streamable HTTP。
填写统一 URL 与 Authorization Header，保存并确认工具列表加载完成。
使用企业全称发起一次基础工商查询验证。

[ 配置 ]

# MiniMax：配置第三方 MCP
# Name: jinghai-mcp
# Transport: Streamable HTTP
# URL: https://www.kqdaas.com/mcp/api/mcp
# Header: Authorization: Bearer YOUR_API_KEY

[ 验证 ]

# 在 MiniMax 对话框问一句：
"查询成都乐云互动网络技术有限公司的工商信息"
# → 看到 get_business_info 运行成功
# → 返回企业基础信息等实时字段，非网络搜索

L

LobsterAI 手动 MCP 配置

当前请在 LobsterAI 的 MCP 设置或配置文件中手动新增鲸海远程 MCP，不使用市场连接流程。

领取 API Key

接入步骤

打开 LobsterAI 的 MCP 设置，选择新增远程 MCP 服务。
粘贴上方通用 JSON；如为表单配置，选择 Streamable HTTP。
填写统一 URL 和 Authorization Header 后保存，重新加载工具列表。
使用企业全称查询基础工商信息，确认返回工具调用结果。

[ 配置 ]

# LobsterAI：新增远程 MCP
# Transport: Streamable HTTP
# URL: https://www.kqdaas.com/mcp/api/mcp
# Header: Authorization: Bearer YOUR_API_KEY

[ 验证 ]

# 在 LobsterAI 对话框问一句：
"查询成都乐云互动网络技术有限公司的工商信息"
# → 看到 get_business_info 运行成功
# → 返回企业基础信息等字段，接入成功

T

Trae（字节跳动）

AI IDE，MCP 原生支持。适合在编码、脚本和数据分析工作流中直接调用鲸海企业数据。

领取 API Key

接入步骤

进入 Trae 设置 → MCP → 手动添加 → 原始配置（JSON）。
粘贴上方通用配置 JSON，并保存。
MCP 页面确认 jinghai-mcp 已连接并已加载工具列表。
对话中询问「查询示例科技股份有限公司的工商登记信息」。

[ 配置 ]

# Trae：设置 → MCP → 手动添加 → 原始配置（JSON）
# 粘贴通用配置后保存，确认 jinghai-mcp 已连接

[ 验证 ]

# 对话框中问一句：
"查询示例科技股份有限公司的工商登记信息"
# → 返回法定代表人、成立日期、注册资本等字段，接入成功

⚒

通用 MCP 配置

任何支持 MCP 协议的 AI 工具均可使用。Cursor、Claude Code、Cline、Codex、自研 Agent 等都能按同一套配置接入鲸海。

复制通用 JSON

接入步骤

打开客户端的「添加 MCP 服务 / MCP 配置」入口。
选择粘贴 JSON，或按表单方式手动录入 Server。
把统一 MCP URL 和 Authorization Header 填入配置；新客户端优先选择 Streamable HTTP。
客户端 MCP 面板出现 jinghai-mcp 且显示已连接。

方式 A：粘贴 JSON

{
  "mcpServers": {
    "jinghai-mcp": {
      "url": "https://www.kqdaas.com/mcp/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

方式 B：表单项填

类型：Streamable HTTP（推荐）/ SSE
名称：jinghai-mcp
URL：https://www.kqdaas.com/mcp/api/mcp
HTTP Header：Authorization: Bearer YOUR_API_KEY
计费说明：每次成功调用扣 1 积分

恭喜，已完成激活！

你的 API Key 已在 AI 应用中产生真实调用。下一步可以探索更多高价值场景：KYB 主体核验、风险黑名单扫描、知识资产盘点、经营动态追踪。

探索 Skills 场景模板查看完整数据能力

STEP 03

第三步：验证真实企业数据链路

鲸海正式环境当前统一使用 MCP，成功返回真实企业字段后再开始业务调用。

# 1. 配置统一 MCP 地址（支持 Streamable HTTP 与 SSE）
https://www.kqdaas.com/mcp/api/mcp

# 2. 使用自己的 API Key 完成 initialize
Authorization: Bearer YOUR_API_KEY

# 3. 首次业务验证
tools/call: get_business_info
company_name: 成都乐云互动网络技术有限公司

READY CHECK

接入成功后，你应该看到这些结果

工具列表

AI 工具内出现 jinghai-mcp，并加载 get_business_info 等鲸海企业数据工具。

授权状态

首次调用不再提示鉴权失败，用户后台的 API Key 最近调用时间会更新。

对话效果

询问企业核验、供应商风险、投研尽调时，Agent 会自动选择对应 MCP 工具。

FAQ

常见问题

在线调试会消耗调用次数吗？

接入真实账号后，在线运行会按照工具计费规则消耗 MCP 调用次数；示例输出仅用于查看返回结构，不扣减额度。

鲸海 MCP 如何计费？

任意 MCP 工具每次成功调用扣减 1 积分，每积分 0.05 元；新用户注册成功赠送 1,000 积分。工具不会再按风险、知产或 Skill 类型额外加价。

为什么配置中不直接展示真实 API Key？

API Key 属于敏感凭证。页面使用 YOUR_API_KEY 占位，正式使用时请在用户后台复制自己的 Key 后替换。

为什么现在是统一 MCP 地址？

正式环境对外统一暴露一个 jinghai-mcp 服务入口，兼容 Streamable HTTP 与 SSE。新客户端优先使用 Streamable HTTP，已有 SSE 客户端也可继续接入。

用户 API Key 应该配置到哪个地址？

用户专属 API Key 请配置到 https://www.kqdaas.com/mcp/api/mcp。这是鲸海面向外部客户的统一 MCP 代理入口，会将请求转发到正式服务并完成用户积分统计。

MCP 的正确调用顺序是什么？

推荐使用 Streamable HTTP：向统一地址 POST initialize，随后发送 notifications/initialized、tools/list 和 tools/call。SSE 客户端可按客户端原生 SSE 流程连接同一地址，Authorization Header 保持一致。

为什么会出现 Invalid request parameters？

部分上游服务对带有空 params 的 tools/list 请求不兼容。鲸海代理已自动兼容这种请求；如果客户端仍提示错误，请刷新 MCP 工具列表或重新加载 MCP 配置。

如何确认已经接入成功？

不要只看客户端显示“已连接”。使用企业全称调用 get_business_info，能够返回企业名称、经营状态、法定代表人等真实字段，才表示数据链路验证成功。

现在支持安装鲸海 CLI 吗？

当前正式环境使用 MCP 接入，鲸海 CLI 尚未发布为可安装的 npm 包，请不要执行 CLI 安装命令。

如何查看调用记录？

登录用户后台后，可以查看 API Key、积分余额、调用消耗、订单账单和后续开放的调用日志。

3 步跑通，5 分钟接入 AI 工具

第一步：获取 API Key 并复制通用配置

复制前确认

第二步：MCP 接入，选择你的 AI 工具

WorkBuddy ★ 腾讯云出品

接入步骤

[ 配置 ]

[ 验证 ]

QoderWork ★ 阿里 Qoder 出品

接入步骤

[ 配置 ]

[ 验证 ]

QClaw 手动 MCP 配置

接入步骤

[ 配置 ]

[ 验证 ]

IMA 暂不支持自定义 MCP

接入步骤

[ 当前状态 ]

[ 替代方案 ]

MiniMax 手动 MCP 配置

接入步骤

[ 配置 ]

[ 验证 ]

LobsterAI 手动 MCP 配置

接入步骤

[ 配置 ]

[ 验证 ]

Trae（字节跳动）

接入步骤

[ 配置 ]

[ 验证 ]

通用 MCP 配置

接入步骤

方式 A：粘贴 JSON

方式 B：表单项填

恭喜，已完成激活！

第三步：验证真实企业数据链路

接入成功后，你应该看到这些结果

常见问题