Routebase

routebase-mcp

AI エージェントが Routebase の API を操作できるようにします。 これは、ドキュメント、モックサーバー、コントラクトテスト、モニタリングがすべて 1 つの OpenAPI 仕様から生成される API ライフサイクルプラットフォーム、Routebase 用のコネクターです。エージェントは同じ仕様を使い、人間のチームと同じロールベースの権限のもとで、エンドポイントやスキーマの設計、コントラクトテストとセキュリティテストの実行、モックの管理、ドキュメントの公開、モニターの確認を行います。課金情報と組織へのアクセスは読み取り専用です。

接続方法は 2 つあります。クライアントが stdio にしか対応していない場合を除き、ホステッドエンドポイントを選んでください。

ホステッドエンドポイント（推奨）

https://mcp.routebase.dev

OAuth 2.1 と動的クライアント登録に対応した Streamable HTTP です。Routebase アカウントでサインインするだけで、インストールもキーのローテーションも必要ありません。静的な認証情報を使うクライアントは、代わりに X-API-Key ヘッダーを送信できます。

US リージョンのアカウントでは、https://mcp.routebase.dev/?region=us を使用してください。指定を間違えると、エラーではなく、ツールがないコネクターとして表示されます。

stdio ブリッジ

ローカルプロセスしか起動できないクライアントの場合：

ROUTEBASE_API_KEY=rb_… npx routebase-mcp

Routebase の Settings → API Keys で API キーを生成します。対話型セットアップを使うと、適切な設定が自動的に書き込まれます。

npx routebase-mcp init

または、手動で追加してください。Claude Code（.mcp.json）と Cursor（.cursor/mcp.json）では、同じブロックを使用できます。

{
  "mcpServers": {
    "routebase": {
      "command": "npx",
      "args": ["-y", "routebase-mcp", "--stdio"],
      "env": {
        "ROUTEBASE_API_KEY": "rb_…"
      }
    }
  }
}

Codex は、CLI と IDE 拡張機能で共通の ~/.codex/config.toml を読み込みます。

[mcp_servers.routebase]
command = "npx"
args = ["-y", "routebase-mcp@latest", "--stdio"]

[mcp_servers.routebase.env]
ROUTEBASE_API_KEY = "rb_…"

VS Code は Streamable HTTP に直接対応しているため、ブリッジは必要ありません。.vscode/mcp.json では、トップレベルのキーとして mcpServers ではなく servers を使い、各エントリーに type が必要です。また、展開されるのは ${input:…} のみなので、キーをコミット対象のファイルに含めずに済みます。ブロック全体については、MCP クイックスタートを参照してください。

環境変数	必須	説明
ROUTEBASE_API_KEY	✅	認証用の API キーです。Settings → API Keys で作成してください。
ROUTEBASE_REGION	US アカウント	アカウントのホームリージョンです。us または eu を指定します（デフォルト：eu）。指定しない場合、US キーは無効なキーであるかのように扱われます。
ROUTEBASE_LOG_LEVEL	–	verbose · debug · info · warning · error · fatal（デフォルト：warning）。ログは stderr に出力されます。stdout は MCP プロトコル用に確保されています。

stdio ブリッジの仕組み

npm パッケージは小さなシムです。初回実行時に、プラットフォーム用の自己完結型 CLI バイナリを releases.routebase.dev からダウンロードし、公開時にパッケージへ埋め込まれた SHA-256 チェックサムと照合して検証します（一致しない場合は実行を拒否するフェイルクローズ方式です）。バイナリは ~/.routebase/bin/<version>/ にキャッシュされます。

対応プラットフォーム： macOS（arm64、x64）、Windows（x64）、Linux（x64）。Node.js ≥ 18 が必要です。

このリポジトリの内容

ファイル	目的
bin/routebase-mcp.js	routebase-mcp npm パッケージとして公開される stdio シム
server.json	MCP Registry 用マニフェスト（dev.routebase/routebase）
plugin.json、mcp.json	Agent Plugins 1.0 マニフェスト
package.json、checksums.json	公開パッケージのメタデータと、このバージョンで固定されているバイナリの SHA-256 チェックサム

このリポジトリは、公開済みのコネクターをミラーしたもので、ここにあるすべてのファイルは Routebase の独自リポジトリにあるリリースパイプラインによって書き込まれます。各リリースでは npm パッケージとまったく同じ内容がここにプッシュされ、タグが付けられるため、ここで変更しても npm には反映されません。プルリクエストではなく、イシューを作成してください。

リンク

• 製品：https://routebase.dev/mcp-server/
• 各クライアント向け MCP クイックスタート：https://docs.routebase.dev/mcp-quickstart/
• API キーとスコープ：https://docs.routebase.dev/mcp-authentication/
• CLI リファレンス：https://docs.routebase.dev/mcp-cli-reference/
• npm：https://www.npmjs.com/package/routebase-mcp

ライセンス

このリポジトリのシムはMITライセンスです。ダウンロードされるRoutebase CLIバイナリには、Routebaseの利用規約が適用されます。