APIキーは必要ですか？

ホスト型サーバーはキー不要です。キーなしは共有枠で、IPごとに毎分10回、毎時100回が上限です。レートは15分遅延します。

FreeプランでもMCPを使えますか？

Freeを含む全プランでMCPを使えます。Freeのキーには月5,000回、毎分10回の専用枠があり、レートは15分遅延します。

Claudeはライブレートを取得できますか？

有料プランで取得できます。キーなしとFreeは15分遅延します。Claudeは返されたタイムスタンプを引用すべきです。レートは参考値で、決済や取引には使えません。

ローカルブリッジをキーなしで使えますか？

`ALLOW_ANONYMOUS=true`を設定しない限りAPIキーが必要です。Node.js 20以降が必要です。ホスト型サーバーはStreamable HTTPでキーなしの直接接続を受け付けます。

Claudeで為替レートを取得

ホスト型MCPサーバーでClaudeに為替レートを渡せます。接続にAPIキーは不要です。キーなしとFreeは15分遅延し、有料プランはライブレートを取得できます。

無料APIキーを取得リクエストを試す

Claude Codeにホスト型サーバーを追加

次のコマンドでClaude Codeにホスト型MCPサーバーをキーなしで追加します。

接続先は末尾のスラッシュを含むhttps://api.exchangerate.dev/v1/mcp/で、Streamable HTTPを使います。ツールの検出と呼び出しはキー不要です。

シェル

claude mcp add --transport http exchangerate-dev https://api.exchangerate.dev/v1/mcp/

キーで自分の割当枠を使用

次のコマンドでAPIキーを指定すると、自分の割当枠と上限が適用されます。

Authorization: Bearer YOUR_API_KEYを送信します。Freeは月5,000回、毎分10回です。MCPツール呼び出しはAPI呼び出し1回と数え、対応するRESTリクエストと分単位の上限と月間割当枠を共有します。

シェル

claude mcp add --transport http exchangerate-dev https://api.exchangerate.dev/v1/mcp/ --header "Authorization: Bearer YOUR_API_KEY"

ローカルブリッジで接続

次のコマンドでローカルのnpmブリッジからClaude Codeを接続します。

Node.js 20以降とAPIキーが必要です。コマンドは二重ハイフンの前の-eでEXCHANGERATE_API_KEYを設定します。キーなしで使うにはALLOW_ANONYMOUS=trueが必要です。

シェル

claude mcp add exchangerate-dev -e EXCHANGERATE_API_KEY=YOUR_API_KEY -- npx -y @nusantara-ventures/exchangerate-mcp

Claude Desktopを設定

次の設定をClaude Desktopの設定ファイルに追加し、YOUR_API_KEYを置き換えます。

macOSでは~/Library/Application Support/Claude/claude_desktop_config.json、Windowsでは%APPDATA%\Claude\claude_desktop_config.jsonです。

Claude Desktopはターミナルの環境変数を読まないため、envにEXCHANGERATE_API_KEYを指定します。保存後、Claude Desktopを完全に終了して再起動します。サーバーの読み込みは起動時に一度です。

claude_desktop_config.json

{  "mcpServers": {    "exchangerate-dev": {      "command": "npx",      "args": [        "-y",        "@nusantara-ventures/exchangerate-mcp"      ],      "env": {        "EXCHANGERATE_API_KEY": "YOUR_API_KEY"      }    }  }}

Claudeにレートを質問

「今、100ユーロは何円？」と質問します。Claudeはfrom、to、amountを受け取るconvertを使えます。応答にはレート、換算額、USD経由での算出を示すフラグが含まれます。

「9月1日のUSDからIDRへのレートは？」にはget_rangeかget_rateを使います。最新レートはget_rateにbaseとquoteを指定し、期間内のレートはget_rangeで取得します。

「どの通貨を調べられる？」はlist_currencies、「どの中央銀行がレートを公表している？」はlist_official_rate_tablesを使います。

Claudeが取得、実行できること

9つのツールでレート、通貨情報、ドキュメントにアクセスできます。ほかに、get_usd_indexは独自計算のUSD指数を返し、search_docsはドキュメントを検索し、get_official_rateは政府公表レートを返します。

応答にはsource、market_session、data_updated_atと、レートは参考値で決済や取引には使えない旨の注意が含まれます。Claudeは返された時刻を引用すべきです。

start_checkoutは確認後にのみプランの購入画面を開きます。Claudeは自ら購入しません。

接続エラーへの対処

Claude Desktopにツールが出ない場合は設定JSONを確認します。末尾の余分なカンマがよくある原因です。

無効なAPIキーはHTTP 401を返します。429は分単位の上限か月間割当枠への到達を示します。再試行時刻まで待ちます。