AIアシスタントでMetalAPIを使う（MCP）

MCPサーバーでできること

MetalAPIはhttps://metalapi.com/mcpでModel Context Protocolサーバーを提供しています。接続すると、アシスタントがチャット上で、リアルタイムや過去の価格の照会、金額の換算、時系列データのグラフ化、プランと使用量の確認を行えるようになります。

接続方法は2つあります：

• サインイン（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をクリックします。

あとは、たとえば「今日の金価格はユーロ建てで1グラムいくら？」のように質問してください。

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

~/.cursor/mcp.json（プロジェクト単位なら.cursor/mcp.json）にMetalAPIを追加します：

{
  "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とまったく同じく、各呼び出しがプランの1リクエストとしてカウントされ、プランで許可される鮮度のデータが返されます。
• 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の設定ファイルに記載したキーは、コード内のキーと同じく機密情報として扱ってください。