Gatewerk

@gatewerk/mcp

Gatewerk MCP サーバーを使うと、AI エージェントは Claude Desktop、Claude Code、Cursor、Windsurf、または任意のModel Context Protocolクライアントからレビューを読み、判断できます。Gatewerk のレビュー／テンプレート／フィードバック／監査／チェーン／ノート API を MCP ツールとして公開し、API キーが持つ権限の範囲内で利用できます。

Gatewerkは、AI エージェント向けのオープンソースでセルフホスト可能なレビューレイヤーです。人間のために行われる作業は、人間が判断します。

クイックスタート

npx @gatewerk/mcp init

init コマンドは Gatewerk の URL、API キー、任意のレビュアーのメールアドレスを尋ねた後、MCP クライアントの設定に貼り付ける設定ブロックを出力します。

設定を手動で記述することもできます。

{
  "mcpServers": {
    "gatewerk": {
      "command": "npx",
      "args": ["-y", "@gatewerk/[email protected]"],
      "env": {
        "GATEWERK_URL": "https://api.gatewerk.com",
        "GATEWERK_API_KEY": "gwk_...",
        "GATEWERK_REVIEWER": "[email protected]"
      }
    }
  }
}

GATEWERK_REVIEWER は任意です。設定すると、MCP サーバー経由で行われた判断はそのレビュアーに帰属します。設定しない場合は、API キーの識別情報が使用されます。

利用可能なツール

ツールは、API キーに付与されたスコープに基づいて自動的にフィルタリングされます。reviews:read のみを持つキーには、gatewerk_decide_review は表示されません。

レビュー

• gatewerk_create_review — 新しいレビューリクエストを送信します（スコープ：reviews:create）
• gatewerk_list_reviews — フィルターを指定してレビューを一覧表示します（スコープ：reviews:read）
• gatewerk_get_review — テンプレートのメタデータとともにレビューを取得します（スコープ：reviews:read）
• gatewerk_decide_review — レビューを承認／却下／編集／再試行します［非推奨。gatewerk_take_review_action を推奨］（スコープ：reviews:decide）
• gatewerk_take_review_action — レビューに対して設定可能なアクションを実行します。組み込みのアクション ID とテンプレート固有のアクション ID に対応しています（スコープ：reviews:decide）
• gatewerk_list_review_actions — レビューのテンプレートで利用可能なアクションを確認します（スコープ：reviews:read）

テンプレート

• gatewerk_list_templates — テンプレートを一覧表示します（スコープ：templates:read）
• gatewerk_create_template — テンプレートを定義します（スコープ：templates:write）
• gatewerk_update_template — テンプレートを変更します（スコープ：templates:write）
• gatewerk_delete_template — テンプレートを削除します（スコープ：templates:write）

チェーン

• gatewerk_start_chain_run — 定義から複数ステップのレビューチェーンを開始します（スコープ：templates:write）
• gatewerk_get_chain_run — ID でチェーンの実行とステップを取得します（スコープ：reviews:read）
• gatewerk_get_chain_for_review — レビューのチェーンコンテキストを取得します（スコープ：reviews:read）

ノート

• gatewerk_create_note — ノートを投稿します。1 件以上のレビュー／テンプレート／チェーンの実行に任意でピン留めできます（スコープ：notes:write）
• gatewerk_list_notes — フィルター（作成者、タグ、対象、共有／非公開）を指定してノートを一覧表示します（スコープ：notes:read）

クエリと統計

• gatewerk_query_feedback — 学習用に過去の判断をクエリします（スコープ：feedback:read）
• gatewerk_query_audit — 監査証跡をクエリします（スコープ：audit:read）
• gatewerk_get_stats — レビュー指標と日次の推移を取得します（スコープ：stats:read）

認証

適切なスコープを持つ Gatewerk API キーが必要です。次の場所で作成してください。

• クラウド： https://app.gatewerk.com → Settings → API Keys
• セルフホスト：Gatewerk インスタンスの /settings/api-keys ページ

一般的なスコープの組み合わせ：

• エージェント（自分のレビューの読み取りと新規レビューの作成）：reviews:create、feedback:read
• レビュアー（受信トレイでの操作）：reviews:read、reviews:decide、templates:read、notes:read、notes:write
• 管理者（すべての機能）：すべてのスコープ

環境変数

変数	必須	説明
GATEWERK_API_KEY	はい	API キー（gwk_...）
GATEWERK_URL	いいえ	Gatewerk のベース URL（デフォルトは http://localhost:3100）
GATEWERK_REVIEWER	いいえ	判断の帰属先として使用するレビュアーのメールアドレス

リンク

• ウェブサイト：https://gatewerk.com
• アプリ：https://app.gatewerk.com
• ソース：https://github.com/gatewerk/gatewerk
• ドキュメント：https://gatewerk.com/docs
• ライセンス：Apache-2.0（MCP SDK パッケージ。サーバーは AGPL-3.0-only）