読み取り専用MCP連携
アプリ単位の読み取り専用トークンを作成し、MCPクライアントから診断ツールを利用する方法を説明します。
更新日 2026-09-15
読み取り専用 MCP 診断
Pakta は、読み取り専用の Model Context Protocol エンドポイントを /api/mcp で公開します。これは、ストリーミング可能な HTTP をサポートするアシスタント向けに、リリース インベントリ、更新決定のリプレイ、構造化されたロールアウト テレメトリを組み合わせたものです。
接続する
コンソールで [設定] → [MCP アクセス] を開きます。
資格情報を作成し、クライアント名を入力して、1 つ以上のアプリケーションを選択します。デフォルトの有効期間は 30 日です。
トークンが表示されている間にコピーします。 Pakta はダイジェストのみを保存し、完全な値を再度表示することはありません。
エンドポイント
https://<your-pakta-host>/api/mcpとAuthorization: Bearer <token>ヘッダーを使用してクライアントを構成します。
資格情報はアプリケーション スコープです。すべてのアプリケーション、チャネル、パッケージ、展開、およびテレメトリ クエリがそのスコープに対してチェックされます。アプリケーション ID または正確な名前を使用します。あいまいな名前の場合は、候補を選択せずに候補を返します。
ツール
サーバーは次の読み取り専用ツールをアドバタイズします。
| ツール | 目的 |
|---|---|
auth_status | 認証情報、有効期限、適用範囲を確認します。 |
list_apps、get_app_detail | 認可されたアプリケーションと編集された構成を検査します。 |
list_channels、list_native_versions | チャネルとネイティブ ビルド カタログを検査します。 |
list_update_packages、list_deployments | 不変パッケージとロールアウトターゲットを検査します。 |
explain_update | クライアントパラメータの現在の更新決定を再生します。再生は SDK クォータを消費したり、監視を書き込みたりしません。 |
get_patch_info | 正確なビルドのパッチ ジョブと pdiff マッピングを検査します。 |
get_request_observations | 7 日間保存されたプライバシーを保護する実際のチェック観察を読み取ります。 |
get_rollout_health、get_adoption_trend | イベント数、時間バケット、保守的なヒューリスティック ガイダンスを読み取ります。 |
diagnose_rollback | 構造化されたロールバック イベントをハッシュ、バージョン、チャネルごとにグループ化します。 |
リスト応答のデフォルトは 50 項目で、上限は 100 です。分析のデフォルトは過去 24 時間で、オプションのチャネル、ネイティブ パッケージ バージョン、および更新ハッシュ フィルターを使用して 1 日または 7 日間を受け入れます。ヘルス ルールは、サンプルの分母としきい値を公開します。デプロイメントを一時停止したり、ロールバックしたり、公開したりすることはありません。
トラブルシューティング
401: Bearer ヘッダーを送信し、トークンが完全にコピーされたことを確認し、期限切れまたは取り消されていないことを確認します。 API キーとブラウザ セッション JWT は MCP エンドポイントを認証できません。
403: リクエスト
Originを確認し、エンドポイントと同じホストを使用するか、オペレーターが構成したオリジンを使用します。有効なトークンは、選択されたスコープ外のアプリケーションを読み取ることはできません。不明なツールまたは無効な引数: MCP クライアントを再度初期化して、現在のツール スキーマを検出し、
applicationやpackageVersionなどの必須フィールドを指定します。
MCP は、オペレータが MCP_ENABLED=true を設定するまで、デフォルトで無効になっています。サーバーは、Streamable HTTP とカスタム Bearer ヘッダーをサポートするクライアントを受け入れます。 OAuth 認証はこのリリースには含まれていません。
データ境界
実際のチェックの観察には、アプリケーション、チャネル、ネイティブ ビルド、SDK バージョン、意思決定カテゴリ、および時間が含まれます。 IP アドレス、デバイス識別子、認証情報、および元のリクエストは除外されます。これらは非同期で書き込まれ、7 日間保持され、機能が有効になった後に収集ギャップが生じる場合があります。導入値はイベント数です。mark_success は、重複排除されたデバイスの導入率ではなく、起動確認を意味します。クラッシュ スタックがないと、ロールバック診断でクラッシュの根本原因を特定できません。