portkey-admin-mcp

Portkey Admin MCP サーバー

Portkey の管理 API を MCP サーバーとして提供します。プロンプト、設定、キー、分析、ガバナンス、デプロイなど、194 個のツールを利用できます。

重要

互換性の積極的な開発を進めています。 Palo Alto Networks は 2026‑05‑29 に Portkey の買収を完了し、現在 Portkey を Prisma AIRS AI Gateway の中核として紹介しています。Portkey Admin API は引き続き稼働しており、公式の OpenAPI と製品変更履歴には 2026 年 10 月までコントロールプレーンの機能が追加され続けています。そのため、本プロジェクトでは API カバレッジの拡充を再開しました。対象は Portkey 互換 API（x-portkey-api-key）であり、Prisma AIRS／Strata Cloud Manager には直接対応していません。Palo Alto は現在 Prisma AIRS の管理仕様を公開していますが、認証方式が異なり、複数の管理ベース URL とより小規模なドメインセットを使用するため、PORTKEY_BASE_URL を差し替えるだけでは対応できません。サポート対象の並行運用モデルとアダプターの基準については、Prisma AIRS 相互運用ガイドをご覧ください。

目次

ドキュメント

クイックスタート

適切なスコープが設定された Portkey API キーが必要です。Portkey ダッシュボードの「API Keys」から取得してください。

バージョン 0.15.0 は MCP SDK v2 を使用し、同じエンドポイントでプロトコルリビジョン 2026-07-28 と、それより古いクライアントに対応します。HTTP セッションとリプレイ機能は廃止されています。古い設定は警告が表示され、無視されます。0.14.x からアップグレードする前に、互換性と非推奨機能を確認してください。

Claude Code

claude mcp add -e PORTKEY_API_KEY=your_key portkey-admin -- npx -y portkey-admin-mcp

Cursor / Windsurf / VS Code

MCP 設定（.cursor/mcp.json、.windsurf/mcp.json、または .vscode/mcp.json）に追加します：

{
  "mcpServers": {
    "portkey-admin": {
      "command": "npx",
      "args": ["-y", "portkey-admin-mcp"],
      "env": {
        "PORTKEY_API_KEY": "your_api_key"
      }
    }
  }
}

直接実行

PORTKEY_API_KEY=your_key npx -y portkey-admin-mcp

stdio クライアントでツールの対象を絞り込むには、PORTKEY_TOOL_DOMAINS を設定します。

PORTKEY_API_KEY=your_key \
PORTKEY_TOOL_DOMAINS=prompts,analytics \
npx -y portkey-admin-mcp

ドメインの絞り込みは、アクセス範囲だけでなく、コンテキストコストを抑えるうえでも最も効果的です。tools/list はページ分割されており、クライアントがすべてのページで nextCursor をたどると、194 個のツールを含むカタログ全体で約 400 KB になります。クライアントが実際に必要とするドメインに絞り込めば、データ量もおおむね比例して削減できます。

git clone https://github.com/CodesWhat/portkey-admin-mcp.git
cd portkey-admin-mcp
npm install && npm run build

{
  "mcpServers": {
    "portkey-admin": {
      "command": "node",
      "args": ["/path/to/portkey-admin-mcp/build/index.js"],
      "env": {
        "PORTKEY_API_KEY": "your_api_key"
      }
    }
  }
}

できること

22 のツールドメインにわたる合計 194 個のツール。 説明付きの全リストは ENDPOINTS.md をご覧ください。

Portkey では最近、プロバイダーの認証情報を「Providers」として表す傾向が強まっていますが、現在の Admin API では /virtual-keys と /providers の両方が引き続き公開されています。このサーバーでは両方のドメインを維持しており、Virtual Keys ではプロバイダーのアクセス認証情報を管理し、Providers ではワークスペースのプロバイダー設定を管理します。

API キーのスコープ

ほとんどのツールは、「すべて選択」の権限が有効な、ワークスペーススコープのサービスキーで動作します。このキーで、プロンプト、設定、仮想キー／API キー、プロバイダー、ガードレール、ワークスペースのインテグレーション、MCP サーバー、レート制限／使用量制限、ログ、プロンプト補完、ワークスペースのユーザー管理を利用できます。

ツールが Portkey エラー AB03 とともに 403 を返した場合、エンドポイントの不具合ではなく、スコープが不足していることを意味します。

HTTP サーバー（実験的）

ステータス：HTTP トランスポートはローカルで動作し、統合テストスイートでテストされていますが、これは概念実証です。このサーバーのホスト版はなく、現時点でホスト型デプロイメントを目指していません。サポート対象のトランスポートとして stdio（npx）を使用してください。

このサーバーはリモートアクセス用に Streamable HTTP をサポートしています。

HTTP 認証はサーバーへのアクセスを制御しますが、別々の Portkey テナントを偽装するものではありません。認証されたすべてのプリンシパルは、設定済みの同じ PORTKEY_API_KEY を使用し、その認証情報で許可される有効なすべてのツールとスコープを呼び出すことができます。異なる信頼レベルを設定するには、それぞれ別の Portkey 認証情報と PORTKEY_TOOL_DOMAINS 許可リストを使って、別々のインスタンスまたはデプロイメントを実行してください。

PORTKEY_API_KEY=your_key \
MCP_HOST=127.0.0.1 \
MCP_PORT=3000 \
MCP_PUBLIC_BASE_URL=https://mcp.example.com \
MCP_AUTH_MODE=bearer \
MCP_AUTH_TOKEN=your_secret \
node build/server.js

または npx 経由（portkey-admin-mcp パッケージには HTTP バイナリが含まれています）：

PORTKEY_API_KEY=your_key MCP_AUTH_MODE=bearer MCP_AUTH_TOKEN=your_secret \
  npx -y -p portkey-admin-mcp portkey-admin-mcp-http

ローカルでのみ HTTP を使用する場合は、MCP_HOST をデフォルトの 127.0.0.1 のままにしてください。Docker や別のインターフェース上のリバースプロキシなど、ローカルマシンの外部からの接続を受け付ける必要がある場合に限り、MCP_HOST=0.0.0.0 を設定してください。

docker build -t portkey-admin-mcp .
docker run \
  -e PORTKEY_API_KEY=your_key \
  -e MCP_TRANSPORT=http \
  -e MCP_HOST=0.0.0.0 \
  -e MCP_PORT=3000 \
  -e MCP_AUTH_MODE=bearer \
  -e MCP_AUTH_TOKEN=your_secret \
  -e RATE_LIMIT_SINGLE_PROCESS=true \
  -p 3000:3000 \
  portkey-admin-mcp

ヘルスエンドポイント

開発

npm run dev           # stdio with hot reload
npm run dev:http      # HTTP with hot reload
npm test              # unit + contract tests
npm run test:coverage # unit + contract tests with the enforced 80% line floor
npm run test:e2e      # MCP protocol tests
npm run test:http     # HTTP endpoint smoke test
npm run smoke         # credentialed read-only Portkey API smoke suite
npm run ci            # full pipeline (lint + typecheck + coverage + build + e2e + verify)

ライブスモークテストでは、想定される認証情報スコープによる拒否と、明示的に追跡されているホステッドコントロールプレーンのルート不足をスキップとして報告します。想定外の HTTP レスポンス、ネットワークエラー、レスポンス契約の不備が発生した場合は、引き続き実行が失敗します。

list_audit_logs は Enterprise 専用のため、PORTKEY_ORGANISATION_ID が設定されていない場合、スモークテストではそのチェックをスキップします。そのルートをテストするには、組織 ID を設定してください。

必須の CI およびリリースゲートでは、すべての TypeScript ソースファイルを対象に測定し、行カバレッジが 80% 未満の場合は失敗します。CI および Coverage ワークフローのレポートには、現在の行、分岐、関数のカバレッジが表示されます。

CI ワークフロー では、スタンドアロンの Qlty CLI も実行され、解析対象の各コミットについて、リント／セキュリティの結果、重複、複雑度、メトリクスを含む quality-reports アーティファクトが公開されます。既存の Qlty 保守性およびカバレッジバッジは引き続き Cloud で生成されます。ローカル解析ではこれらのバッジは更新されません。カバレッジのアップロードと Cloud 解析では、引き続き Qlty の解析時間が消費されます。

npm run dev:http では、デフォルトで MCP_AUTH_MODE=bearer または MCP_AUTH_MODE=clerk が必要になりました。ローカルのみで認証なしのテストを意図的に行う場合は、MCP_ALLOW_UNAUTHENTICATED_HTTP=true を設定してください。

コントリビューションでは、プルリクエストを作成し、 CONTRIBUTING.md に記載されたチェックを行ってください。プロジェクトの意思決定とメンテナーの役割については、 GOVERNANCE.md に記載されています。脆弱性は SECURITY.md から報告してください。また、公開されている脅威モデルと保証ケースについては、 SECURITY-ASSURANCE.md を参照してください。

ロードマップ

リリース 0.15.0 では、MCP SDK v2 と 2026-07-28 仕様に移行します。 ロードマップでは、完了した作業と、上流の契約およびテナント検証のゲートを分けて記載しています。MCP v2 への移行は 0.15.0 でリリースされ、古いクライアントも同じエンドポイントを引き続き使用できます。その一方で、セッションとリプレイのストレージは廃止されます。互換性と非推奨項目を参照してください。

コミュニティ

質問やバグ報告はIssuesへ、幅広い議論、アイデア、サーバーの利用に関するサポートはDiscussionsへお寄せください。 保守されているパッケージ、レジストリ、マーケットプレイス、ディレクトリの各レコードは、 配布とディレクトリに記載されています。サードパーティのインデックスの更新が遅れている場合は、 このリポジトリで生成されるツールカタログを正式な情報源として扱ってください。

使用技術

LobeHub と Glama のマーケットプレイス掲載情報：

---

MIT ライセンス · r-huijts/portkey-admin-mcp-server に着想を得ています

トップに戻る