Claude Code MCPで経済データを使う

クイックスタート

1. https://narwhalapi.com/signup で無料のキーを取得し、NARWHAL_API_KEY としてエクスポートしてください。
2. すべてのプロジェクトで使うには、--scope user、HTTP トランスポート、Authorization ヘッダーを指定して add コマンドを実行します。
3. claude mcp list、claude mcp get narwhal、またはセッション内の /mcp で接続を確認します。

MCPの設定

add コマンドは --scope user で、すべてのプロジェクト向けに HTTP エンドポイントと Bearer ヘッダーを登録します。--scope project では、Claude Code が共有の .mcp.json にエントリを書き込みます。このエントリには "type": "http" が必要で、URL だけで type のないエントリは無視されます。

claude mcp add --scope user --transport http narwhal https://api.narwhalapi.com/mcp \ --header 'Authorization: Bearer ${NARWHAL_API_KEY}'

{
  "mcpServers": {
    "narwhal": {
      "type": "http",
      "url": "https://api.narwhalapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${NARWHAL_API_KEY}"
      }
    }
  }
}

Claude Code はヘッダー内の ${NARWHAL_API_KEY} を展開するため、接続する前に実際のキーを環境に入れておいてください。共有の .mcp.json にあるサーバーは、対話セッションで承認が必要です。

利用できるツール

Claude Codeは、同じ接続で読み取り専用のすべてのツールグループを利用できます。初期化とツール検出は無料です。ツール呼び出しは成功するたびに1回と数え、RESTと共有するクレジットから差し引かれます。

プロンプト例

• 米国の最新のインフレ率を取得します。
• USD/IDR 為替レートの履歴を表示します。
• 現在の GBP/USD 為替レートで、GBP を USD に換算します。
• 米国の次回のCPI公式発表日を調べて。
• 取得できるパーム油の価格履歴を教えて。

よく使うワークフロー

ヒント

• サーバーを追加または接続する前に、Claude Code から使えるようターミナルの環境を保持してください。変数が未設定だと、参照の文字列がそのまま送られ、警告が出ます。
• 設定を変更する前に、/mcp で Connected、Needs authentication、Failed to connect のどれかを見分けてください。
• すべてのプロジェクトで同じ接続を使いたい場合は --scope user、設定をプロジェクトに含めたい場合は --scope project を選びます。
• 正確な URL https://api.narwhalapi.com/mcp を使ってください。末尾のスラッシュによるリダイレクトで、動作しなくなるクライアントがあるためです。

よくある質問

トラブルシューティング

関連するエージェント

• Cursor→
• Codex→
• GitHub Copilot→
• Gemini→
• Claude アプリ設定ガイド→