Perforce Agentic Gateway

PAG — Perforce Agentic Gateway

Perforce Agentic Gateway（PAG）は、トークン効率に優れたコードモードを提供するローカル MCP ゲートウェイです。AI クライアントは一度だけ設定して PAG に接続し、ほかのすべての MCP サーバーは PAG 経由で設定します。MCP ごとにツールを設定して読み込む代わりに、PAG は MCP サーバープロセスの実行を管理し、クラッシュ時には再起動して、必要な認証情報を OS のキーチェーンに保存します。

前提条件

• uv — 必須なのはこれだけです。
• Docker または Podman — コンテナーとして実行するサーバーでのみ必要です。
• 各サーバー固有の依存関係 — PAG はサーバーへのプロキシとして動作し、サーバーを同梱するわけではありません（例：npx サーバーには Node、API サーバーにはアカウントが必要です）。

クイックスタート

1. AI クライアントを接続する

PAG は uvx 経由で起動する stdio MCP サーバーとして動作します。

Claude Code の場合：

claude mcp add pag -- uvx perforce-agentic-gateway@latest

.mcp.json を使用するクライアント（Cursor など）の場合：

{
  "mcpServers": {
    "pag": {
      "command": "uvx",
      "args": ["perforce-agentic-gateway@latest"]
    }
  }
}

@latest を指定すると、起動のたびに PAG が最新の状態に保たれます。プロジェクトを固定するには、--working-directory <dir> を追加します。その他のクライアント（Codex、VS Code など）については、AI クライアントの接続を参照してください。クライアントを再起動すると、pag__* ツールが表示されます。

オンデマンドで取得するのではなく、一度だけインストールしたい場合は、uv tool install perforce-agentic-gateway を実行すると、PATH に perforce-agentic-gateway コマンドが追加されます。このコマンドは uvx perforce-agentic-gateway の代わりに実行します。詳しくはツールとしての PAG のインストールを参照してください。

2. 利用可能なものを確認する

アシスタントに尋ねます。

「PAG レジストリにはどの MCP サーバーがありますか？」

設定済みのレジストリからインストールできるものがすべて一覧表示されます。P4、BlazeMeter、Perfecto、Delphix、IPLM など、Perforce のファーストパーティーサーバーも含まれます。

3. カタログからサーバーを有効にする

Perforce 製品をサポートする MCP サーバーは、カタログから直接利用できます。作業中の内容に合ったサーバーをアシスタントに提案してもらいます。

「このプロジェクトには、どの MCP サーバーが役立ちますか？」

PAG はプロジェクトをスキャンして技術要素を検出し、カタログ内のサーバーを提案します。有効にする前には必ず確認を求めます。また、サーバーを直接指定することもできます。

「P4 サーバーを有効にしてください。」

PAG は設定にサーバーを記録して起動します。ほとんどの Perforce サーバーでは認証情報（通常はサーバー URL とアクセストークン）が必要です。その場合、アシスタントは入力用のダッシュボードへのリンクを提示します。シークレットがチャットを経由することはありません。Perforce サーバーとシークレットを参照してください。

uvx perforce-agentic-gateway view を実行すれば、いつでもカタログ全体を確認できます。PAG の使用も参照してください。

4. または、カスタムサーバーを追加する

レジストリにないもの（ローカルコマンド、コンテナー、リモート HTTP エンドポイントなど）は、直接追加できます。MCP の fetch サーバーは uvx 経由で実行でき、認証情報も不要です。そのため、セットアップなしで一連の流れを試せる便利なサーバーです。

「uvx mcp-server-fetch を実行する、fetch という名前のカスタムサーバーを追加してください。」

PAG は設定にサーバーを書き込み、起動します。

5. 実際のコマンドを実行する

「https://modelcontextprotocol.io を取得して、MCP とは何か教えてください。」

アシスタントは PAG 経由で fetch__fetch を呼び出し、取得したページの内容に基づいて回答します。

高速さを維持できる理由

AI client --one stdio connection--> PAG --> server A (command)
                                     | --> server B (remote HTTP)
                                     +-> server C (container)

PAG は、下流のすべてのツールをクライアントに転送することはありません（サーバーが 20 台あれば、ツールは 1,000 個にもなる可能性があります）。PAG が公開するのは、数が少なく固定された pag__* セットだけで、完全なカタログはゲートウェイ内に保持されます。

• pag__explore はカタログを検索します。アシスタントが求めた範囲だけが、そのコンテキストに取り込まれます。
• pag__execute は、下流のツールを呼び出す JavaScript を実行します。そのため、ループや複数サーバーへの呼び出しを、多数のラウンドトリップではなく、1 回で行えます。

仕組みの詳細（サンドボックス、修飾されたツール名、プロンプト、リソース）については、ツールとサンドボックスを参照してください。

さらに詳しく

• AI クライアントの接続 — Claude Code、Codex、VS Code、Cursor。
• PAG の使用 — サーバー、ダッシュボード、カタログとレジストリ、Perforce サーバー、ツール／サンドボックスモデルの管理。
• ダッシュボード — UI Builder を使って、サーバー上にブラウザー用ダッシュボードを構築します。
• ダッシュボードの共有 — ダッシュボードを別のプロジェクトにエクスポートし、インポートします。
• シークレット — 認証情報の入力、保存、検索。
• 設定 — config.toml の完全なリファレンス。
• トラブルシューティング — ログ記録とよくある問題の解決方法。
• リファレンス — コマンドライン、アンインストール、用語集。

フィードバック

バグ報告や機能リクエストは、GitHub のイシューからお寄せください。セットアップや実行時の問題については、まずトラブルシューティングをご確認ください。よくあるケースを取り上げています。

ライセンス

PAG の使用には、Perforce Agentic Gateway 利用規約が適用されます。