opsmaxx

@opsmaxx/mcp

stdio MCP クライアントを、実行中の OpsMaxx デスクトップアプリに接続します。

npx -y @opsmaxx/mcp

このパッケージが必要な理由

OpsMaxx はすでに 127.0.0.1 で Streamable HTTP 経由の MCP サーバーを公開しています。また、Authorization ヘッダーを指定して HTTP サーバーに接続できるクライアント（Claude Code、Codex）は、直接そのサーバーを使うべきです。コマンドは 1 つです。

opsmaxx claude

一方、対応できないクライアントもあります。特に Claude Desktop は、claude_desktop_config.json から url も headers も読み込まないため、HTTP MCP サーバーを指定できません。このパッケージは、そのようなクライアント向けのアダプターです。stdio で受け取り、認証付き HTTP で送信します。

できること、できないこと

これはプロトコルのリレーです。すべてのメッセージを変更せず、双方向に転送します。ツール、セッション、ポリシーに関するロジックは含まれていません。アクセスグループ、承認、シークレットのマスキング、監査ログはすべてアプリ内で管理されるため、stdio クライアントも HTTP クライアントとまったく同じ扱いを受けます。

接続先は 127.0.0.1 のみです。サーバーではなく、状態も保持しません。また、OpsMaxx が許可していないものにアクセスすることもできません。

OpsMaxx が起動している必要があります。また、AI & MCP でブリッジを有効にしてください。

設定

まず環境変数を確認し、その後 opsmaxx CLI がすでにキャッシュしているセッションを使います。

変数	説明
OPSMAXX_MCP_TOKEN	AI & MCP → AI Agents → New AI agent session で取得するセッショントークン
OPSMAXX_MCP_PORT	ブリッジのポート。AI & MCP → Security に表示されます
OPSMAXX_MCP_URL	ポートの代わりに指定する完全なエンドポイント。例：http://127.0.0.1:5177/mcp

いずれも設定されていない場合は、CLI がキャッシュしているセッションを読み込みます。そのため、opsmaxx claude を一度実行すれば十分で、トークンを貼り付ける必要はありません。

Claude Desktop

{
  "mcpServers": {
    "opsmaxx": {
      "command": "npx",
      "args": ["-y", "@opsmaxx/mcp"],
      "env": {
        "OPSMAXX_MCP_TOKEN": "your-session-token",
        "OPSMAXX_MCP_PORT": "5177"
      }
    }
  }
}

その後、Claude Desktop を再起動してください。

トークンについて

トークンは 1 つのワークスペースと 1 つのアクセスグループに限定されており、本来ならクライアントの設定に手動で貼り付けるシークレットと同じものです。SSH キーでもボールトのパスワードでもありません。このトークンを持つエージェントにも、SSH パスワード、秘密鍵、データベース認証情報、ホスト名、対話型の root シェルが渡されることはありません。詳しくは 脅威モデルをご覧ください。

ライセンス

MIT。ソースコード：https://github.com/OpsMaxx/OpsMaxx