在 AI 助手中使用 MetalAPI（MCP）

MCP 服务器的作用

MetalAPI 在 https://metalapi.com/mcp 运行一个 Model Context Protocol 服务器。连接后，您的助手即可在对话中查询实时和历史价格、换算金额、绘制时间序列图表，以及查看您的套餐和用量。

有两种连接方式：

• 登录（OAuth）：适用于 Claude、ChatGPT 以及其他支持自定义连接器的应用。您只需登录 MetalAPI（或创建免费账户）并批准连接。
• API 密钥：适用于 Claude Code、Cursor、VS Code 以及任何可以发送请求头的客户端。请使用控制台中的密钥。

Claude（claude.ai 和 Claude Desktop）

1. 打开 Settings → Connectors，选择 Add custom connector。
2. 将其命名为 MetalAPI，并输入 URL https://metalapi.com/mcp。
3. 点击 Connect，登录 MetalAPI，然后点击 Allow。

之后就可以提问，例如：“今天黄金每克多少欧元？”

ChatGPT

在 Settings → Apps & Connectors 中，使用 URL https://metalapi.com/mcp 和 OAuth 身份验证创建一个连接器（开发者模式）。ChatGPT 会打开 MetalAPI 登录页面；批准连接后，即可使用这些工具。

Claude Code

使用您的 API 密钥添加服务器：

claude mcp add --transport http metalapi https://metalapi.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

# 也可以改为登录而不使用密钥：添加时不带 --header，然后在 Claude Code 中运行 /mcp。

Cursor

将 MetalAPI 添加到 ~/.cursor/mcp.json（或项目中的 .cursor/mcp.json）：

{
  "mcpServers": {
    "metalapi": {
      "url": "https://metalapi.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code（GitHub Copilot）

创建 .vscode/mcp.json；VS Code 会询问一次密钥并将其安全存储：

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

工具

• get_latest_prices、get_historical_prices、convert、get_timeseries、get_fluctuation、get_ohlc、get_carat_prices：市场数据。每次调用与 REST API 完全一样，计为您套餐的一次请求，数据时效性与您的套餐一致。
• list_symbols、get_account、list_plans、list_api_keys：免费。
• get_upgrade_link：生成用于升级到更高套餐的安全 Stripe 结账链接。助手可以准备链接，但只有您本人才能付款。
• create_api_key：为您自己的应用创建密钥（仅限通过登录方式连接时）。

面向 AI 编程助手

正在使用 AI 编程工具开发集成？让它读取 llms.txt、完整版 llms-full.txt 或 OpenAPI 规范；这些文件描述了每个端点、参数和响应。

安全

通过登录建立的连接会列在控制台的 Settings → Connected apps 中，您可以随时断开连接。API 密钥可以在 API keys 中轮换或吊销；MCP 配置中的密钥与代码中的密钥同样敏感。