MCP アクセス
Repovio ステートレスなモデル コンテキスト プロトコル エンドポイントを公開します
/mcp。認証されたユーザーが表示する可能性のある同じリポジトリ、ワークフロー実行、失敗キュー、承認キュー、概要、傾向への読み取り専用アクセスを提供します。 Repovio。
の MCP サーバーはローカルを読み取ります Repovio データベース。プロバイダーの変更 API の呼び出し、同期の開始、ワークフローの承認、または変更は行いません。 Repovio 構成。
アクセストークンを作成する
設定を開き、**を選択しますMCP ** タブにアクセスし、名前付きトークンを作成します。有効期限はオプションです。作成ダイアログから完全なトークンをコピーします。 Repovio はそれを 1 回だけ表示し、SHA-256 ハッシュのみを保存します。
トークンの取り消しは、次のリクエストで有効になります。ユーザーを削除すると、トークンも削除されます。すべてのリクエストがデータベースからの現在の承認を解決するため、ユーザーのロールまたはリポジトリ メンバーシップへの変更はすぐに適用されます。
クライアントを構成する
公共を利用する Repovio 起源に続いて /mcp そして、認可ヘッダーでトークンを送信します。
URL: https://repovio.example.com/mcp
Authorization: Bearer repovio_mcp_REPLACE_WITH_TOKEN
最初のリリースのターゲット MCP エディターやコマンドライン クライアントなど、カスタム HTTP ヘッダーをサポートするクライアント。提供しません OAuth 検出を必要とするホストとの互換性は主張しません。 MCP OAuth 流れ。
URL、クエリ パラメータ、追跡された構成ファイル、シェル履歴、またはログにはトークンを決して置かないでください。クライアントのシークレット ストレージまたはバージョン管理されていない環境変数を優先します。
利用可能なツール
| ツール | 目的 |
|---|---|
list_repositories | 表示可能な追跡リポジトリをリストします。 |
get_repository | 表示されている 1 つの追跡リポジトリを読み取ります。 |
list_workflow_runs | クエリ正規化された可視ワークフローが実行されます。 |
list_needs_attention | 最新のターミナルの実行が失敗したワークフロー コンテキストを一覧表示します。 |
list_awaiting_approval | プロバイダーの承認を待っている現在表示されている実行をリストします。 |
get_dashboard_summary | 包括的な時間範囲における目に見えるワークフローの健全性を要約します。 |
get_workflow_trend | 目に見える成功と失敗の傾向バケットを集計します。 |
リスト ツールのデフォルトは 1 ページあたり 25 件の結果で、最大 100 件を受け入れます。ツールの出力には、構造化された JSON と一致するテキスト表現が含まれます。日付には ISO 8601 UTC 値が使用されます。
サーバーは、MCP リソース、プロンプト、タスク、サブスクリプション、プロバイダー アクション、または構成ツールを意図的にアドバタイズしません。
リバースプロキシ要件
POST /mcpを/api/v1/mcpに書き換えずにAPIコンテナに転送します。Authorization、Origin、Content-Type、Accept、MCP-Protocol-Version、Mcp-Method、およびMcp-Nameを転送します。- リバース プロキシで TLS を使用し、認証ヘッダーやリクエスト クエリ文字列をログに記録しません。
- 許可されているすべてのブラウザーのオリジンを
CORS_ORIGINに追加します。Originヘッダーのないリクエストは、ネイティブ クライアントに対して引き続きサポートされます。現在のオリジンは、設定された許可リストと一致する必要があります。
トークン管理
ユーザーは、設定 の MCP アクセス タブで自分のトークンを管理します。システム管理者は、安全なトークンのメタデータを検査し、「ユーザー」ページからトークンを取り消すことができますが、そのハッシュまたはプレーンテキストのシークレットを取得したり、別のユーザーに代わってトークンを作成したりすることはできません。
トークンの状態を管理する
トークン リストには、名前、ステータス、安全なプレフィックス、作成/最後に使用されたタイムスタンプ、およびオプションの有効期限が表示されます。名前には最大 100 文字を含めることができます。取り消しには確認が必要です。取り消されたトークンまたは期限切れのトークンは、今後のリクエストを認証できません。空のリストは、ユーザーのトークンが存在しないことを意味します。ロードエラーの場合は再試行が必要です。 1 回限りの表示を閉じる前に、新しいトークン全体をコピーします。管理者トークン ダイアログでは、リスト/取り消しのみが許可され、別のユーザーの作成は許可されません。