开发文档

MCP 接入

把 Qovia 接进 Claude、Cursor、VS Code 等支持 MCP 的 AI 工具，AI 可以自己查找并调用 63 个实时数据接口。用同一个 API Key，计费和直接调用 API 完全一样。

创建 API Key API 参考

服务地址与认证

https://api.qovia.ai/mcp

协议: Streamable HTTP，无状态：每个请求独立处理，直接返回 JSON，不保持会话，也不需要长连接。
认证: 和 API 用同一个 Key，放在 MCP 连接的请求头里：Authorization: Bearer sk-qovia-…（也可以用 x-api-key）。查找和查看接口不需要 Key，调用和查余额需要。

接入客户端

把下面的配置里的 Key 换成你自己的。改完重启客户端，工具列表里会出现 qovia。

Claude Code

终端

claude mcp add --transport http qovia https://api.qovia.ai/mcp \
  --header "Authorization: Bearer $QOVIA_KEY"

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "qovia": {
      "url": "https://api.qovia.ai/mcp",
      "headers": {
        "Authorization": "Bearer sk-qovia-…"
      }
    }
  }
}

VS Code

Key 在第一次使用时输入，不写进文件：

.vscode/mcp.json

{
  "servers": {
    "qovia": {
      "type": "http",
      "url": "https://api.qovia.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${input:qovia-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "qovia-key",
      "description": "Qovia API key",
      "password": true
    }
  ]
}

Claude Desktop

Claude Desktop 的远程连接器走 OAuth，这里用 mcp-remote 转接（需要本机装有 Node.js）：

claude_desktop_config.json

{
  "mcpServers": {
    "qovia": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.qovia.ai/mcp",
        "--header",
        "Authorization:${QOVIA_AUTH}"
      ],
      "env": {
        "QOVIA_AUTH": "Bearer sk-qovia-…"
      }
    }
  }
}

其他客户端

任何支持 Streamable HTTP 的 MCP 客户端都能接：地址填上面的 URL，再加一个请求头 Authorization: Bearer sk-qovia-…。

工具

默认只给 AI 4 个工具，接口再多也不占它的上下文：先查找，再看参数，然后调用。

MCP 工具
工具	作用	需要 Key
`search_endpoints`	按关键词（中英文都行）和平台查找接口，返回 id、标题、单价和是否已上线。	不需要
`get_endpoint`	查看一个接口：说明、参数（JSON Schema）、参数示例、返回示例和价格。	不需要
`call_endpoint`	执行接口，返回数据和扣费信息（charged_usd、余额、免费额度）。	需要
`get_account`	查看 Key 的余额、套餐、每分钟上限和本月剩余免费额度。不扣费。	需要

直连工具

想让 AI 直接看到具体接口，在地址后面加 ?tools=all，或者只要某几个平台：

https://api.qovia.ai/mcp?tools=douyin,bilibili

每个已上线的接口会多出一个同名工具，名字是接口 id 把点换成下划线（raw.douyin.video → raw_douyin_video），参数就是接口的参数。默认的 4 个工具仍然保留。

示例

AI 收到一个数据问题时，通常这样调用：

工具调用

用户：「这条抖音 7681194457378688292 的点赞和评论多少？」
→ search_endpoints {"query": "douyin video"}
→ get_endpoint {"endpoint_id": "raw.douyin.video"}
→ call_endpoint {"endpoint_id": "raw.douyin.video", "params": {"item_id": "7681194457378688292"}}
← data.metrics.likes / comments，meta.charged_usd = 0.0015

计费与安全

MCP 的每次调用都走和 API 完全相同的流程：鉴权、权限范围、参数校验、限流、计费和用量日志都一样。
只有成功且有数据的调用才扣费；空结果和失败不扣费。可用免费额度的接口先用免费额度。
每分钟上限按账户算，和 API、控制台调试台共用。
出错时工具返回 error.code（和 API 的错误码一致）和 HTTP 状态，限流时还有 retry_after_seconds。

给 AI 单独建一个 Key

建议为 AI 工具单独创建 API Key，只勾选它需要的接口范围（scope）。不用时可以在控制台随时吊销，不影响你的其他程序。