AI 連携（Gcad MCP）

Gcad は Model Context Protocol（MCP）に対応しています。お使いの AI アシスタントを Console につなぐと、AI がそのままメトリクス参照やコマンド実行といった運用作業を担えます。

仕組み

• Console が /mcp エンドポイントを公開します。
• 認証は Personal Access Token（PAT） のみ。ブラウザの JWT は受け付けません。
• PAT には必要最小限のスコープだけを付与します（例：gcad:server:read、gcad:server:exec）。

設定手順

1. Console の管理画面で PAT を発行し、用途に応じたスコープを選びます。
2. AI クライアント（MCP 対応）に、MCP サーバーとして次を登録します。
   • URL: https://<ホスト>/mcp
   • 認証: 発行した PAT を Bearer トークンとして指定
3. 接続すると AI 側に Gcad のツール群（サーバー一覧、メトリクス取得、コマンド実行など）が現れます。

スコープの考え方

スコープ	用途
gcad:inventory:read	サーバー一覧の閲覧
gcad:server:read	個別サーバーの状態・メトリクス参照
gcad:server:exec	サーバー上でのコマンド実行

注意

exec 系スコープはホスト上で任意コマンドを実行できる強力な権限です。AI に渡す PAT は、用途に応じて最小スコープに絞ってください。