MCPサーバー

ベースURLを設定する方法との違い

どちらも利用できますが、解決する課題が異なります。エージェントのベースURLをFastMetalに向けると、セッション全体が1つのFastMetalモデルで動作します。一方MCPサーバーを使えば、現在のモデルをそのまま使いながら、FastMetalをツールとして呼び出せます。

• 作業中のモデルを切り替えることなく、別のモデルにセカンドオピニオンを求められます。
• エージェント内で画像を生成・編集できます。ツール呼び出しが必要なため、テキストのベースURL設定では実現できません。
• セッションの途中で、最新のモデル料金や残高を確認できます。

エンドポイントと認証

Streamable HTTPで接続し、FastMetalのAPIキーをベアラートークンとして送信します。APIを直接利用する際と同じキーです。なお api.fastmetal.ai は推論APIのホスト名であり、MCPのルートは存在しませんのでご注意ください。

https://mcp.fastmetal.ai/mcp

Claude Code

MCP CLIでサーバーを追加します。Claude Codeは起動時に環境変数を展開するため、キー自体が設定ファイルに書き込まれることはありません。事前にシェルの設定ファイルで FASTMETAL_API_KEY をexportしてください。

claude mcp add --transport http fastmetal https://mcp.fastmetal.ai/mcp \
  --header "Authorization: Bearer ${FASTMETAL_API_KEY}"

セッション内で /mcp を実行すると接続を確認できます。FastMetalのツールがツール一覧に表示されます。

Codex CLI

Codexの設定ファイルにサーバーを追加します。サーバーの管理には codex mcp コマンドを使用します（Codexには /mcp スラッシュコマンドはありません）。

[mcp_servers.fastmetal]
url = "https://mcp.fastmetal.ai/mcp"

[mcp_servers.fastmetal.http_headers]
Authorization = "Bearer sk-your-fastmetal-key"

その他のクライアント

カスタムヘッダー付きのリモートMCPサーバーに対応したクライアントであれば利用できます。Cursor、OpenCode、Claude Desktopなどが該当し、多くは次の形式のJSONを受け付けます。

{
  "mcpServers": {
    "fastmetal": {
      "type": "http",
      "url": "https://mcp.fastmetal.ai/mcp",
      "headers": {
        "Authorization": "Bearer sk-your-fastmetal-key"
      }
    }
  }
}

利用できるツール

11個のツールを提供しています。モデル情報の取得と残高確認は無料で、それ以外は通常の料金が発生します。

動画はプロンプトの内容にかかわらず、モデルごとの定額が1本あたりに課金されます(料金一覧はツールの説明に記載)。課金はジョブが受理された時点で行われるため、get_video は何度呼び出しても無料です。キーごとに1日の動画利用予算があります(デフォルト¥1,250)。ダウンロードリンクには有効期限があるため、エージェントにファイルの保存を指示してください。

curlでの動作確認

プロトコルは単一のPOSTで行うJSON-RPC 2.0です。Acceptヘッダーには application/json と text/event-stream の両方を指定する必要があります。これによりStreamable HTTPのリクエストとして識別されます。

curl -X POST https://mcp.fastmetal.ai/mcp \
  -H "Authorization: Bearer $FASTMETAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"quota","arguments":{}}}'

レスポンスはServer-Sent Eventsとして返るため、JSONの結果は data: 行に包まれて届きます。主なメソッドは initialize、tools/list、tools/call です。

トラブルシューティング