# Eqvero MCP 接入：Claude Code

## 接入内容

Eqvero 提供港美股公司数据、公告原文检索、公司研究与金融计算。 MCP 提供工具连接；Skill 提供研究方法说明，不是连接的前提。

## 安装前

1. 检查当前客户端、操作系统与现有 MCP 配置，说明拟修改的位置和范围；用户确认后合并，保留其他服务器。
2. 需要 Eqvero 专用 API Key，账号须有 API/MCP 权益。创建入口：https://eqvero.com/zh-cn/developers?tab=keys。没有 Key 时请用户在本机安全输入；不要要求把完整 Key 发到聊天。
3. 不改模型、账号全局设置或其他搜索工具；不覆盖有效凭证，不把 Key 写进 URL、日志、公开仓库或共享文件。

## 配置

服务地址: https://eqvero.com/api/mcp
传输: Streamable HTTP
认证: Authorization: Bearer <EQVERO_API_KEY>
服务器名称: eqvero

在 Claude Code 使用的终端运行命令。

```sh
claude mcp add --transport http eqvero https://eqvero.com/api/mcp --header "Authorization: Bearer <EQVERO_API_KEY>"
```

示例中的占位符需要在客户端安全配置中替换为真实 Key，不要把示例当成已经配置成功。Eqvero 当前不提供 OAuth 登录或无 Key 连接。其他客户端的字段可能不同，请按该客户端支持的 HTTP MCP 配置处理，不照抄本节格式。

## 验证连接

列出当前服务器的工具，然后用 query 为 AAPL、limit 为 1 执行 companies_search。返回实际公司名称、股票代码与 ID 才算只读查询通过。配置需要重载或重启时，明确说明尚未生效，不能把“已写配置”说成“已连通”。

`companies_search({"query":"AAPL","limit":1})`

不要为安装测试调用 research_create、analytics_create 或任何收费任务。401 检查 Key，402 检查账号权益/额度，403 检查授权范围；不要自动创建或吊销其他 Key。

## 可选：安装研究 Skill

公开源码：https://github.com/LJK0719/eqvero-skill。用户需要研究方法说明时，再读取 README 和 SKILL.md，按客户端支持的 Skill 范围安装。未经确认不全局安装，不执行下载内容附带的任意脚本。

## 使用研究与计算

用户明确提出研究或计算需求后再创建任务。保存返回的任务 ID，使用 research_get / analytics_get 读取状态和结果。离开页面或断开 MCP 连接不会取消已接受任务。

创建、追问和重试使用稳定 idempotencyKey；同一操作重发时复用它，输入改变时才创建新操作。响应丢失时可调用 research_submission 查询是否已接受，不要用新 key 再提交。只有明确停止时才调用取消接口。