コンテンツにスキップ
Documentation

コード、CI、ランナーファーム、QA向けのMCP

この CHAMPREP MCPサーバー これにより、AIアシスタントが 連携して動作するようになります CHAMPREP コード, ランナーファーム そして QA に代わって: プロジェクトとそのクローンURLの検索、パイプラインの確認、ジョブログの閲覧、 ランナーおよびランナープールの管理、QAスキャンの追跡、および検出結果のトリアージを行います。このアシスタントは 常に あなた:ご自身の役割、プラン、組織のポリシー、 および(キーAPIを指定した場合)そのキーのスコープは、Webアプリとまったく同じように適用されます。

AIクライアントを https://ai-api.champrep.com/mcp/v1 以下の説明のとおり MCPサーバー. ブラウザでのサインインは、 キーボード操作を行うユーザー向けです。スクリプトやCIでは、 キーAPIを使用してください。ここで重要なスコープは以下の通りです:

サービス読み取り専用読み取りと変更
CHAMPREP Codecode:read_apicode:api
ランナーファームrunner_farm:readrunner_farm:write
QAqa:readqa:write

アカウントが膨大なカタログ(約1,000件以上の 操作、Codeだけでもほぼこの数に相当します)にアクセスできるようになると、クライアントには、読み取りごとに1つのツールではなく、 2つのヘルパーツールが表示されます: champrep_search_tools そして champrep_read. アシスタントは、いくつかの平易な単語で検索を行い、 必要な正確な入力を読み取り、その後操作を実行します。次のような検索です。 ジョブログ, 最新のパイプライン, runner タグ, グループプロジェクト または 品質ゲート 動作:各単語が個別に照合され、 最も一致度の高いものが先に表示されます。このモードでは、読み取り処理が champrep_read; カタログが小さい場合、各操作は個別の ツールとして一覧表示されます。変更には常に固有の名前が付けられたツールが割り当てられるため、クライアントは実行前に 確認を求めることができます。

プロジェクト、グループ、およびクローン

Section titled “プロジェクト、グループ、およびクローン”
  • アクセス可能なプロジェクト、またはグループのすべての サブグループを含むすべてのプロジェクトを一覧表示します。各プロジェクトには、HTTPSおよびSSHのクローンURLが付属しています。
  • グループ全体をクローンします。 MCPは実行できません git お使いのマシンでは実行できません。代わりに クローン計画をご依頼ください: code_clone_group_plan グループ内のすべてのプロジェクト (サブグループを含む)を一覧表示し、すぐに実行可能な git clone グループのフォルダ構成を 維持するコマンドです。すでに存在するフォルダはスキップされるため、 リストを再度実行することができます。POSIXシェルで手動で実行するか、ローカルの コーディングエージェント(Claude Code、Codex、Cursor)にターミナル内で実行させることができます。
  • SSHによるクローン作成には、CodeプロファイルにSSHキーが必要です。HTTPSによるクローン作成では、 ユーザー名と、Codeで作成した個人用アクセストークンの入力が求められます。トークンを チャットに貼り付けることは絶対に避けてください。

  • ブランチごとのパイプラインステータス、ブランチの最新のパイプライン、パイプラインの ジョブ、およびテストレポートの概要。
  • ジョブログ。 ジョブのログを確認できます。長いログの場合、アシスタントは バイト範囲を指定して部分ごとに読み込むため、失敗したジョブの末尾にすぐに移動できます。
  • 新しいパイプラインを実行したり、パイプラインを再試行またはキャンセルしたり、手動ジョブを実行したり、 個々のジョブを再試行またはキャンセルしたりできます。
  • ジョブアーティファクトの一覧表示とダウンロード(小規模なアーカイブ。大規模なアーカイブは Codeからダウンロードされます)。

  • ランナー、プロジェクトのランナー(プロジェクト自身のもの、所属グループの もの、および使用可能なインスタンスのランナー)、およびグループのランナーを、ステータス、オンライン 状態、タグ、一時停止状態、最後の通信日時とともに一覧表示します。
  • ランナーの詳細や実行済みのジョブ、およびそのランナーで待機中の ジョブ数を確認できます。
  • 新しいランナーを登録します。 アシスタントは、プロジェクトまたはグループの Codeの「新しいランナー」ページを開きます。そこでランナートークンを取得できますが、このトークンは アシスタントには一切表示されません。
  • ランナーの変更:タグの追加や削除、一時停止や再開、 説明の変更、タグなしジョブの実行可否、保護設定、および最大 タイムアウトの設定が可能です。タグは新しいリスト全体として送信されるため、アシスタントは まずランナーを読み込みます。各変更は、承認された後にのみ実行されます。
  • 割り当て 既存のプロジェクトランナーを、ご自身が管理している別のプロジェクトに割り当てることができます。
  • 削除 ランナーを割り当てるか、プロジェクトから切り離すことができます。破壊的な操作 (詳細は 承認が必要な事項).
  • どのランナーを誰が変更できるかはコードで決定されます。プロジェクトおよびグループのランナーを変更するには 「メンテナー」または「オーナー」のロールが必要で、インスタンスのランナーを変更するには「コード管理者」のロールが必要です。
  • また、アシスタントは、Code内のランナーの設定ページへの 直接リンクを提供することもできます。

マージリクエストの一覧表示、閲覧、オープン、更新、承認、マージを行います。また、マージ リクエストやイシューへのコメント、イシューの一覧表示、作成、更新も可能です。承認時には、 アシスタントが読み取ったターゲットブランチが指定されるため、ターゲットが変更されたマージリクエストが 誤って承認されることはありません。

  • Runner Farmのアカウントとワークスペース、ご自身の役割、およびご契約プランの マシンクラスと上限数。
  • コードホスト接続:接続の一覧表示や内容の確認、接続の 名前変更、一時停止、再開、ラベル付けが可能です。
  • プール:プールのリスト表示や内容(待機時間を含む)の確認、プールの作成、名前の変更、 一時停止、再開、または スケール (同時実行やジョブのタイムアウト)を管理し、「最近削除された」から プールや接続を復元できます。
  • クレジットと使用状況:クレジット残高、月ごとの使用状況、クラス、プール、または プロジェクトごとの使用状況、およびクレジット台帳。
  • ジョブ:実行中、保留中、および拒否されたジョブ、および個々のジョブの詳細が表示されます。
  • コードホストとそのランナートークン、およびコネクタのシークレットの連携、は Runner Farmアプリで行われます。アシスタントが安全なリンクを提供し、認証情報は 一切確認されません。
  • リポジトリ:接続済みおよび利用可能なリポジトリを一覧表示し、それらを有効化して 同期します。コードCHAMPREPプロジェクトも同様です。
  • スキャン:スキャンを開始し、そのステータスを確認し、ログ(シークレットは伏せられています)を 閲覧し、スキャンの集計を確認できます。
  • 検出結果:フィルタを使用して検出結果を一覧表示し、 却下 理由とコメントを添えて 検出結果を却下するか、再オープンできます。
  • 品質ゲート:リポジトリまたはブランチに対するゲートの判定結果で、各 条件と不合格の理由が表示されます。QAに接続されているCHAMPREPCode、 GitHub、およびGitLabBitbucketのリポジトリで機能します。
  • プレビュー: プレビュービルドを開始する ブランチのプレビューを開始し、プレビュー一覧を表示し、その ログやビルドログを確認し、プレビュー期間を延長したり、公開設定を変更したりできます。シークレットを必要とするリポジトリは、 QAアプリから起動されます。
  • クラウドIDE: IDEセッションを開始してください リポジトリまたは空のワークスペースで実行し、 その後、QAアプリ内のそのページへのリンクから開いてください。セッションを一覧表示し、内容を確認してください。 セッションのアクセストークンは、アシスタントには一切表示されません。
  • プレビューまたはIDEセッションの開始には、ご利用のプランのQA割り当てが使用され、 承認後にのみ実行されます。

  • 「acme/platform グループ内のすべてのプロジェクトについて、最新のパイプラインステータスを一覧表示してください。」
  • 「acme/web の最後のパイプラインで失敗したジョブのログを表示してください。」
  • 「acme/web 内のパイプライン 4211 の失敗したジョブを再試行してください。」
  • 「acme/web はどのランナーを使用しており、どのランナーがオフラインになっていますか?」
  • 「ランナー 12 にタグ gpu を追加してください。」 (アシスタントが現在のタグを読み取り、 新しいリストの承認を求めます。)
  • 「明日のメンテナンスが終了するまで、ランナー12を一時停止してください。」
  • 「acme/web の feature/login ブランチの QA プレビューを開始してください。」
  • 「acme/web でクラウド IDE セッションを開く。」
  • 「グループ acme に対して新しいランナーを登録してください。」 (Codeの「new-runner」ページが表示されます。)
  • 「acme グループ内のすべてのプロジェクト( サブグループを含む)に対するクローンコマンドを教えてください。」
  • 「現在、acme/web でランナーを待機しているジョブはいくつありますか?」
  • 「Runner Farm プール『build-large』を、同時実行ジョブ数 20 件にスケールアップしてください。」
  • 「今月、マシンクラスごとに、ランナーファームのクレジットをどれくらい使用しましたか?」
  • 「acme/web の QA スキャンを開始し、完了したら知らせてください。」
  • 「acme/web にある、未解決の重大度の高い QA 所見を一覧表示してください。」
  • 「QA-0970は誤検知として却下してください。このキーはテストフィクスチャです。」
  • 「acme/webはmainブランチで品質ゲートを通過していますか?」

  • 読み込み (一覧、詳細、ログ、使用方法)は、何も変更しません。大規模なカタログでは これらは経由して実行されます champrep_read.
  • 変更点 (パイプラインやジョブの実行、再試行、キャンセル、マージリクエストの 開く・マージ、コメントの追加、変更、一時停止、再開、ランナーの割り当て、プールの 作成・スケーリング、スキャンの開始、検出結果の却下、QAプレビューやIDEセッションの開始) それぞれに専用のツールがあります。MCPクライアントによって、確認の求め方が異なりますので、 変更を許可する前に、承認設定をご確認ください。
  • 破壊的な操作 (パイプラインの削除、ランナーの削除またはプロジェクトからの切り離し、 プールの削除、実行中のすべてのランナーファームジョブの停止)は、 接続が破壊的な操作を許可し、URLが ?destructive=true。詳細については、 MCPサーバー.
  • すべての変更は、ユーザーの役割とプランに基づいて、サービスによって再度確認されます。

MCPでは利用できませんなぜ実行場所
実行 git ローカルマシンでの実行(クローン、プッシュ)MCPツールはCHAMPREP、お使いのコンピュータ上ではなく、内で実行されます以下の場所からコマンドを実行してください: code_clone_group_plan、またはローカルのコーディングエージェントをご利用ください
ランナー・トークン、ランナー・ファームのランナー・トークン、またはコネクタのシークレットが表示される場合、あるいはランナー・トークンの有効期限を変更する場合認証情報は、チャット、プロンプト、ログに決して入力しないでくださいCodeのランナーページおよびRunner Farmアプリ(アシスタントがリンクを提供します)
プロジェクトのCI/CD設定の変更(例:インスタンスまたはグループランナーの有効化)Codeでは、ご本人様のみが承認できる追加の確認を求めますCode におけるプロジェクトの CI/CD 設定
クラウドIDEセッション内でのコマンドの実行やファイルの編集任意のコードの実行は、開いているIDE内で行われますQAクラウドIDE
アクセストークン、デプロイトークン、またはキーの作成、CI/CD変数の読み取り認証情報とシークレットはCode内に保持されますコード設定
保護設定の変更(保護対象のブランチ、承認ルール、メンバー、可視性)Codeでは、追加の確認が求められますコード設定
シークレットの発見を却下するシークレットの失効を確認することは、お客様ご自身の責任となりますQAアプリ
CodeとRunner Farm、およびそのコネクタシークレットの連携ペアリングコードとシークレットは認証情報ですCodeの管理画面

表示される操作も、ご利用のプラン、組織の ポリシー、サービスごとの AI 権限、および(API キーAPIの場合)そのスコープによって異なります。