プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

opsgate

作者:gkdis6バージョン 0.8.0i★ 2iパソコンで動く公式サイト ↗
レジストリ名io.github.gkdis6/opsgate

インストール方法

What it does

Kubernetes MCP server where AI proposes changes and you approve each with a passkey on your phone.

  • Connects パソコンで動く
  • Account or key No key needed
  • Category チャット・メール

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気6/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア18/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

opsgate をインストールして。https://mcp.popnx.com/i/gkdis6-opsgate.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月13日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

先にパソコンへ Docker を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server opsgate を入れてください。順番に:1) docker --version で Docker があるか確認。なければ https://www.docker.com/products/docker-desktop/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "opsgate": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/gkdis6/opsgate:v0.8.0", "-config", "/etc/opsgate/opsgate.yaml" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、opsgate のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Docker を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    docker --version
    • バージョン番号(例 Docker version …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: Docker Desktop を入れます:Mac は Docker.dmg を開いてアイコンを「アプリケーション」へドラッグ(Mac に合わせて Apple silicon か Intel を選ぶ)· Windows は Docker Desktop Installer.exe をダブルクリック · 入れたら Docker Desktop アプリを開いたままにします。curl コマンドは不要です

    Docker のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: docker --version

    一度入れれば、Docker を使うすべてのツールで使えます

  2. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  3. この設定を貼り付けて保存

    {
      "mcpServers": {
        "opsgate": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "ghcr.io/gkdis6/opsgate:v0.8.0",
            "-config",
            "/etc/opsgate/opsgate.yaml"
          ]
        }
      }
    }
  4. Claude を終了してもう一度開く

  5. 試してみる

    opsgate を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が opsgate を使っていると言うか、回答に opsgate のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ opsgate につなげません

opsgate はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · opsgate につなげるアプリを使う

  • 先にパソコンへ Docker を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • 先にパソコンへ Docker を入れてください(1 回だけ)
  • 先にパソコンへ Docker を入れてください(1 回だけ)
  • 先にパソコンへ Docker を入れてください(1 回だけ)

B · チャット・メール の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

先にパソコンへ Docker を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server opsgate を入れてください。順番に:1) docker --version で Docker があるか確認。なければ https://www.docker.com/products/docker-desktop/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user opsgate -- docker run -i --rm ghcr.io/gkdis6/opsgate:v0.8.0 -config /etc/opsgate/opsgate.yaml 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、opsgate のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Docker を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    docker --version
    • バージョン番号(例 Docker version …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: Docker Desktop を入れます:Mac は Docker.dmg を開いてアイコンを「アプリケーション」へドラッグ(Mac に合わせて Apple silicon か Intel を選ぶ)· Windows は Docker Desktop Installer.exe をダブルクリック · 入れたら Docker Desktop アプリを開いたままにします。curl コマンドは不要です

    Docker のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: docker --version

    一度入れれば、Docker を使うすべてのツールで使えます

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

    claude mcp add --scope user opsgate -- docker run -i --rm ghcr.io/gkdis6/opsgate:v0.8.0 -config /etc/opsgate/opsgate.yaml
  4. Claude Code で /mcp と入力

    opsgate が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    opsgate を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が opsgate を使っていると言うか、回答に opsgate のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

先にパソコンへ Docker を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server opsgate を入れてください。順番に:1) docker --version で Docker があるか確認。なければ https://www.docker.com/products/docker-desktop/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "opsgate": { "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/gkdis6/opsgate:v0.8.0", "-config", "/etc/opsgate/opsgate.yaml" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、opsgate のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Docker を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    docker --version
    • バージョン番号(例 Docker version …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: Docker Desktop を入れます:Mac は Docker.dmg を開いてアイコンを「アプリケーション」へドラッグ(Mac に合わせて Apple silicon か Intel を選ぶ)· Windows は Docker Desktop Installer.exe をダブルクリック · 入れたら Docker Desktop アプリを開いたままにします。curl コマンドは不要です

    Docker のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: docker --version

    一度入れれば、Docker を使うすべてのツールで使えます

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. Cursor の AI チャットを Agent モードで開く

  4. 試してみる

    opsgate を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が opsgate を使っていると言うか、回答に opsgate のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

先にパソコンへ Docker を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server opsgate を入れてください。順番に:1) docker --version で Docker があるか確認。なければ https://www.docker.com/products/docker-desktop/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "opsgate": { "type": "stdio", "command": "docker", "args": [ "run", "-i", "--rm", "ghcr.io/gkdis6/opsgate:v0.8.0", "-config", "/etc/opsgate/opsgate.yaml" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、opsgate のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Docker を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    docker --version
    • バージョン番号(例 Docker version …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: Docker Desktop を入れます:Mac は Docker.dmg を開いてアイコンを「アプリケーション」へドラッグ(Mac に合わせて Apple silicon か Intel を選ぶ)· Windows は Docker Desktop Installer.exe をダブルクリック · 入れたら Docker Desktop アプリを開いたままにします。curl コマンドは不要です

    Docker のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: docker --version

    一度入れれば、Docker を使うすべてのツールで使えます

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. VS Code の AI チャットを Agent モードで開く

  4. 試してみる

    opsgate を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が opsgate を使っていると言うか、回答に opsgate のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?opsgate を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user opsgate -- docker run -i --rm ghcr.io/gkdis6/opsgate:v0.8.0 -config /etc/opsgate/opsgate.yaml

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "opsgate": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/gkdis6/opsgate:v0.8.0",
        "-config",
        "/etc/opsgate/opsgate.yaml"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "opsgate": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/gkdis6/opsgate:v0.8.0",
        "-config",
        "/etc/opsgate/opsgate.yaml"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "opsgate": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/gkdis6/opsgate:v0.8.0",
        "-config",
        "/etc/opsgate/opsgate.yaml"
      ]
    }
  }
}

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
npm/PyPIにない
接続方法
パソコンで動く
最新バージョンi
0.8.0
レジストリ公開日i
2026年11月11日
コードの最終更新i
2026年11月17日
作者
gkdis6
パッケージ
oci: ghcr.io/gkdis6/opsgate:v0.8.0
ウェブサイト
gkdis6.github.io
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント gkdis6 で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:一昨日

  • ✓ 合格

    ライセンスがある

    Apache-2.0を使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

未確認:バージョン付きの npm と PyPI パッケージのみ確認できます

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/gkdis6-opsgate.svg)](https://mcp.popnx.com/en/servers/gkdis6-opsgate)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

チャット・メールのほかのサーバーとの比較i

  • このカテゴリのほかの2027件のうち88%よりスターが多い
  • このカテゴリのほかの2027件のうち78%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの2027件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

opsgateは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は一昨日、最新バージョン(0.8.0)がレジストリに届いたのは8 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにDockerも必要です。

代わりに使えるものは?

同じカテゴリには:emailmd, Kite Discord Bot Builder, e2a — email for AI agents, Infobip MCP, kernelCAD

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

emailmd

Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.

作者:anypost広く使われている↓ 5432/週★ 13945 日前更新

パソコンでもクラウドでも✓ 提供元 · emailmd.dev

Infobip MCP

Infobip MCP server for omnichannel communication and messaging. SMS, RCS, WhatsApp, Viber and more.

作者:infobip初期★ 3613 か月前更新

クラウドで動く✓ 提供元 · infobip.com

kernelCAD

CAD in ChatGPT and Claude: editable parts, STEP/STL/drawings, in-chat 3D, automatic checks.

作者:w1ne初期★ 3523 日前更新

クラウドで動く✓ 提供元 · kernelcad.com
似たものと比べる
これ
opsgate
emailmdKite Discord Bot Buildere2a — email for AI agentsInfobip MCPkernelCAD
動く場所パソコンにインストールが必要クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要いいえいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえはいいいえ
基本チェック3/35/54/44/44/44/4
ライセンスApache-2.0MITAGPL-3.0Apache-2.0MITMIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

opsgate

한국어 · Website

AI proposes. Your passkey runs it.

opsgate is a self-hosted, open-source MCP server for Kubernetes with human-in-the-loop approval, written in Go, for people who run servers on their own and want to hand them to AI without handing over a shell or kubectl. Every change to your server, whether an alert rule or an AI client such as Claude, ChatGPT, Claude Code or Cursor suggests it, becomes one approval card: the exact plan, who suggested it and whether it can be undone. Approve the card with a passkey on your phone or computer, and the server runs exactly that plan, then tells you whether the service recovered. Nothing else can make a change.

Three promises:

  1. Only what you approved runs, exactly as approved. The server plans again before it runs and stops if anything changed.
  2. Nothing that deletes your data becomes a card. Restart, scale, image restore and replacing a pod its controller recreates are the whole catalog.
  3. From alert to fix in a few taps: the notification, an action, Approve.

The same card approves everyday AI changes, such as writing a note, so passkey approval is already a habit when an outage comes.

opsgate is not a shell or a general agent, not a monitoring dashboard, not on-call paging for a team, and it never repairs anything without a person.

Status: not 1.0 yet. The core loop (alerts, approval cards, passkey approval,

recovery check) is kept compatible as described in stability;

notes, the host provider and the analyzer are experimental. Changes require user authorization, allowed targets and human approval. Read restrictions

and output redaction reduce sensitive data exposure. Third-party security review

is pending; the security policy explains the protections and

remaining limitations.

The problem

Running a server alone usually leaves two gaps:

  • You find out late. Without proper alerting, you hear about an outage from users, or stumble on it yourself.
  • You know the fix but cannot reach the server. A phone SSH app works, but typing commands on a phone in the middle of an outage is slow and error-prone.

Giving an AI assistant a shell would close the second gap and open a worse one: a single wrong or irreversible command. opsgate closes both gaps and keeps every change in front of a person.

How it handles an incident

  1. Know first. opsgate watch follows the Kubernetes API and sends alerts to Discord, webhooks or email as soon as something fails. It can also put the alert in your approval inbox and push a notification to your phone. See watch alerts.
  2. Stabilize from anywhere. Tap the notification or the alert's Choose an action link. After a passkey sign-in you see the actions that fit the current state, such as restoring the last working image or restarting the workload. Pick one, review its fresh plan and approve: it runs right away. opsgate then watches the workload and tells you whether it recovered, not only that the change was applied. If it can be reversed, an Undo button appears. A phone browser is enough.
  3. Then find the cause. With the service back, ask your AI client to investigate through opsgate's read tools, or let the optional analyzer make a first pass.
  4. Remember it. The optional note provider keeps runbooks and past incidents in plain Markdown, and assistants are instructed to check them first and offer to record the outcome. See notes.

Design principles

No arbitrary commands

Only purpose-built tools exist. There is no shell tool and no Kubernetes Secrets tool.

Everything starts off

Providers, write actions and allowlists are disabled until you enable them in configuration.

Changes need a person, and approving runs them

Write tools first plan the exact change. A person approves it, by default on a web page after signing in; the server then checks the plan again and runs it once. Nobody has to go back to a chat to report the approval. Optional approval windows are explained below.

Actions come from a catalog

Alerts, the choices page and AI suggestions can only offer actions from a fixed catalog: restart, scale, restore an image and delete a pod that a controller recreates. A rule or the AI may suggest one, the button says which, and the allowlist and a person still decide.

Nothing permanently deletes your data

Note removal moves files to .trash. Pod deletion is the only delete action; it needs its own allowlist and approval, the plan warns when no controller will recreate the pod, and links refuse such pods.

Remote access is authenticated

A builtin OAuth 2.1 server works with claude.ai and ChatGPT connectors. Sign in with passkeys, GitHub or OIDC (Google included), or verify external JWTs.

Results are data for analysis

AI clients are instructed not to follow instructions embedded in logs or other results. Returned results are redacted and size-limited. The audit log records who called each tool and its outcome, with one JSON object per line.

Where it is heading

Every step of the current roadmap shipped in v0.4.0, and the three gaps found while sharpening the concept (recovery check, web approval by default, one-step phone setup) are closed in v0.5.0. Remaining ideas, such as a PostgreSQL provider and configuration reload, are listed there without commitments.

What it can do

Providers are groups of tools; enable only the groups you need.

ProviderRead toolsWrite tools (approval required)
Kubernetesclusters, overview, list, get, environment, service check, events, pod logs, remediation optionsrollout restart, scale, delete pod, restore a previous image
Host: systemd units and Docker/Compose containers on a server without Kubernetes *(experimental, off by default)*units, unit logs, containers, container logsrestart a unit, restart a container
Notes: runbooks and memory, Markdown folder or Obsidian vault *(experimental)*search, read, list, recent, links, tagscreate, append, replace, move to .trash

Scopes define the kinds of work a user can perform through opsgate: ops:read for inspection and ops:write for operations and note changes. Allowlists restrict tools and targets such as Kubernetes workloads. A scope alone does not enable an operation prohibited by configuration.

Notes can be created only inside the configured notes folder. There is no tool for creating general files at arbitrary server paths or changing Kubernetes CPU and memory requests or limits. Those resource settings can be inspected with Kubernetes detail tools. See the tool reference for arguments and limits.

Kubernetes changes

Every Kubernetes change is off until its allowlist names the target, and a person always approves. Each one can be requested from an MCP client or opened as a link (set action_approval_url on the cluster for links).

ChangeEnable withOffered by the choices page whenUndo
Rollout restartrollout_restarta container keeps restarting (not for config errors or Jobs), or keeps hitting its memory limitnone
Restore a previous imagerestore_imagean image cannot be pulled, or a new rollout crashes or stalls while an older ReplicaSet still runs readyback to the image before the restore
Delete a poddelete_poda controller-owned pod is stuck terminating or on an unreachable nodenone
Scalescale, capped by max_replicasnever by rule; from an MCP client or an AI suggestionback to the previous count

Opening a link shows a fresh plan after browser sign-in; nothing changes until someone presses Approve, and approval windows never cover links. The analyzer proposes fixes only through the read-only action_link tool and prefers the least invasive action; its buttons are marked as AI suggestions. See catalog action links and choices per failure.

How it works

The AI client analyzes results and chooses the next operation. The opsgate MCP server does not run or call an AI model; it checks and executes requested tools. Only the optional, separate opsgate-analyzer calls a model you configure.

Kubernetes tools connect to the Kubernetes API using kubeconfig or in-cluster credentials. A local instance can therefore inspect a remote cluster when network access and permissions allow it.

Clients connect over local stdio (the client starts opsgate and communicates through standard input/output) or HTTPS through a TLS reverse proxy. opsgate checks identity and policy, plans and approves writes, then handles output and auditing. OS accounts and Kubernetes RBAC constrain access to the providers.

Details: architecture · approval · authentication.

How approval works

Write tools first prepare a plan showing the target and change. By default, a person reviews and approves it on a web approval page when web approval is available. Explicit approval.require_web: false opts in to in-client elicitation; a compromised client can then approve its own writes. External/static auth and stdio keep elicitation because they have no web channel. An omitted require_web also allows elicitation with -transport stdio for mode-based files; explicit true denies stdio writes. One-call approval binds the exact arguments and plan.

Approving in the browser rechecks the plan and runs the change immediately, once. The MCP call waits up to approval.wait (default 25s with web approval, maximum 55s) and returns the result if approval comes in time. Otherwise the assistant reads it later with approval_status; repeating the call with approval_id returns the stored outcome and never applies again.

Approve from anywhere
  • Inbox. /approvals lists your pending and recent approvals, alerts waiting for a decision and their results. Open it in a normal phone or desktop browser; messenger in-app browsers often break passkeys.
  • Push. With approval.push enabled, a change requested from a chat and, with watch.inbox, a new alert send a Web Push to your devices. Tapping it opens the newest waiting approval directly. The push carries no content. On iPhone, add opsgate to the Home Screen first.
  • Undo. After scaling or restoring an image, the result offers an Undo link back to the previous state. It is a new action with its own plan and approval.

See approval inbox and notifications and undo.

Optional approval windows let a person approve a particular tool for a limited time. During that window, subsequent calls by the same user can skip a new approval prompt, including calls with different arguments on the approved target. Permission and target checks still run on every call. Windows are disabled by default, and k8s_restore_image never uses one.

Notes: runbooks and memory

With the note provider enabled, assistants are instructed to search past incidents before acting and offer to record the outcome afterward. The AI client decides whether to follow this guid

冒頭だけを表示しています。続きはリポジトリで読めます