アダプターを接続
許可したいアクセスを持つ API トークンを使い、MCP アダプターの接続先を Semaphore インスタンスに設定します。
アシスタントはスクリプトを支援してくれます。しかし、テンプレートの作成、入力の設定、ジョブのスケジュールには、まだ画面の切り替えとコンテキストの繰り返しが必要です。
MCP を使い、AI クライアントから Semaphore の設定、タスク開始、結果の確認ができます。アクセスできるリソースと操作は、設定された API 用 ID が決めます。
一度接続すれば、Claude Code から Semaphore を操作できます。MCP アダプターは、Semaphore API を呼び出すツールをクライアントに提供します。
許可したいアクセスを持つ API トークンを使い、MCP アダプターの接続先を Semaphore インスタンスに設定します。
MCP クライアントにアダプターを登録します。利用可能なツールが Claude Code に表示されます。
有効にしたツールと権限を使い、テンプレートの作成、入力の更新、ジョブのスケジュール、実行の調査を行えます。
「プロジェクト内で直近に失敗したタスクを見つけ、出力を読み、次に確認すべきことを提案してください。何も変更しないでください。」
アシスタントは、アダプターが公開する周辺のテンプレートやプロジェクト情報と、タスク出力の関連付けを支援できます。タスクを指定し、証跡から何が言えるかを問い、診断と変更案を区別すると有用です。ツールの対応範囲はアダプターのバージョンによって異なるため、必要な読み取り操作が実際に利用できることを確認してください。
文書化された MCP アダプターでは、設定済みの SEMAPHORE_API_TOKEN が、クライアントから渡されるトークンより常に優先されます。グローバルトークンがない場合、HTTP リクエストは各クライアントの Bearer トークンを転送できます。共有トークンは権限と API 上の ID を共有するものであり、アシスタントを使う個々の人間への確実な帰属情報は提供しません。
アダプターには読み取りだけでなく変更操作のツールも含まれます。チャットから開始する場合も、タスク実行やテンプレート変更は運用操作です。人による確認はクライアントとワークフローの設計上の選択であり、MCP 自体が強制するものではありません。リスクの低い調査から始め、動作をテストしてから許可する操作を広げてください。
Semaphore のセルフホストは、そのサービスの稼働場所を制御するものです。アシスタントクライアントが、返されたログやメタデータをモデルプロバイダーへ送ることを防ぐものではありません。接続を有効にする前に、クライアントとモデルのデプロイを確認し、シークレットを含む出力を避け、ネットワーク外へ送ってよいコンテキストを決めてください。
ここで説明する構成は、Semaphore REST API と通信する別の MCP アダプターを使います。製品に組み込まれた公式アシスタントではありません。アダプターが対応する操作を互換クライアントへ公開し、クライアントとモデルが会話の体験を提供します。機能と保守状況は Semaphore のリリースとは独立して変わる場合があるため、接続前にツール一覧、認証、デプロイモデルを確認してください。
アダプターが実際に選択した API トークンの ID を使用します。文書化されたアダプター実装では、設定済みのグローバル SEMAPHORE_API_TOKEN がクライアントのトークンより優先されます。グローバルトークンのない HTTP モードでは、クライアントごとの Bearer トークンを転送できます。そのため共有トークンは、権限と API 上の ID を共有するものであり、アシスタントと会話する各ユーザーへの確実な帰属を示すものではありません。複数ユーザーを追加する前に、デプロイモードを意識して選んでください。
はい。ただし、意図した境界は Semaphore の ID と、検証済みのアダプターおよびクライアント設定で強制してください。変更を避けるというチャットの指示は、基盤となるトークンの権限を制限する代わりにはなりません。具体的なタスクと、そのコンテキストおよび出力の取得に必要な読み取り操作から始めます。運用操作へ連携を広げる前に、アシスタントの説明が返された証跡に基づいていることを確認してください。
はい。アシスタントクライアントとモデルのデプロイによっては送信されます。Semaphore のセルフホストは、アプリケーションの稼働場所を決めるものですが、接続されたクライアントが返されたコンテキストを外部へ転送することを防ぎません。ログ、メタデータ、アダプターのホスティング、モデル処理を含むデータ経路全体を確認してください。タスク出力には機密値が含まれうるため、接続を有効にする前に公開できる範囲を決め、適切な認証情報とプロジェクトアクセスを選びます。
タスク識別子を指定し、アダプターの対応ツールでステータスと出力を読むようアシスタントに依頼します。返された証跡から、失敗したステップの説明や確認事項の提案ができます。特に Playbook、認証情報、対象インフラを変更する前には、提案を元のタスクログと照らし合わせてください。
いいえ。MCP アダプターは、Semaphore REST API を使って、対応する操作を互換性のあるアシスタントクライアントに公開します。タスクの実行と結果の記録は引き続き Semaphore が担います。Web UI で元のタスクを開けば、会話やモデルの説明から独立して出力を確認できます。
はい。設定した API 用 ID がそのプロジェクトにアクセスでき、必要な操作にアダプターが対応していれば使えます。既知のタスクから始め、読み取りツールが返す情報を確認してください。連携から既存の実行記録を調べるだけなら、Playbook やスクリプトを書き換える必要はありません。
タスクの調査自体が自動化を再実行したり修復したりすることはありません。アダプターが変更操作のツールを公開する場合があるため、利用できる操作はバージョン、クライアント設定、API 権限によって異なります。読み取り専用にするという方針は、基盤となる ID の権限で強制し、実行操作を許可する前に対象のプロジェクトとタスクを正確に確認してください。