前提条件
- バージョン 2.x 以降のセルフホスト Jenkins インスタンス(クラウドホスト Jenkins はサポートされていません)。
- サーバーにインストールされた Jenkins MCP Server Plugin。デフォルト MCP ポートは
9090です。 - ルート URL の設定と認証情報の作成に必要な Jenkins の管理者アクセス。
クラウドホスト Jenkins サービスはサポートされていません。この接続には Jenkins MCP Server Plugin が必要です。
セットアップ
ルート URL を設定する
MCP Server Plugin は Jenkins がルート URL を設定していることを要求し、正しいジョブリンクを返します。Jenkins スクリプトコンソールで以下を実行します。
接続の詳細
| フィールド | 説明 | 例 |
|---|---|---|
| URL | Jenkins インスタンスのベース URL | http://192.168.1.100:9090 |
| Username | Jenkins ユーザー名 | admin |
| API Token | Jenkins 管理者パスワードまたは API トークン | — |
必要な権限
Jenkins ユーザーに以下の権限を付与してください。- Overall: Read
- Job: Read, Discover
- View: Read
エージェントの機能
接続後、エージェントは Jenkins パイプラインの監視と調査を行えます。| 機能 | 説明 |
|---|---|
| ビルド監視 | ジョブの一覧表示とビルド状態の確認 |
| ログ分析 | ビルドログの取得と検索 |
| テスト結果 | テスト結果の確認 |
| SCM 統合 | Git の変更とコミットの確認 |
| ジョブコントロール | ビルドのトリガーとパイプラインの再実行 — 承認が必要 |
接続の確認
プロンプト例
トラブルシューティング
接続タイムアウト
接続タイムアウト
Jenkins が稼働しており、CloudThinker からポート 9090 にアクセスできるか確認してください。URL フィールドには
localhost ではなくホスト IP アドレスを使用してください。ジョブリストが空
ジョブリストが空
ルート URL が設定されていないか、スクリプトコンソールコマンドが失敗しています。セットアップのスクリプトコンソールコマンドを再実行して再接続してください。
認証が失敗する
認証が失敗する
ユーザー名または API トークンが間違っているか、ユーザーに必要な権限がありません。認証情報を確認し、Jenkins ユーザーが Overall Read、Job Read、View Read アクセスを持っているか確認してください。
セキュリティ
- 最小権限 — エージェントがユースケースに必要な権限のみを付与します。まず読み取り専用から始め、後から拡張してください。
- デフォルトで読み取り専用 — エージェントにこの接続で変更を行わせる場合を除き、読み取り専用の認証情報を使用してください。
- 認証情報のローテーション — 通常のスケジュールに従ってキーとトークンをローテーションしてください。接続を更新すると、CloudThinker が新しい値を自動的に取得します。
- オフボーディング時に失効 — 接続を削除するか、チームメンバーが退職する際には、プロバイダー側で認証情報を無効化してください。
- 専用ユーザー — 必要なジョブとビューのみにスコープした CloudThinker 専用の Jenkins ユーザーを作成してください。
- ネットワーク分離 — Jenkins ポート 9090 を CloudThinker の IP 範囲に制限するか VPN を使用してください。Jenkins UI を公共インターネットに公開しないようにしてください。
関連情報
MCP 接続
Model Context Protocol でカスタムツールを接続する
Kubernetes 接続
Kubernetes クラスターを接続する