OpsLevel MCP Server

OpsLevel MCP サーバー

警告

このセルフホスト可能な MCP サーバーは非推奨です。 新規ユーザーには、ホスト型 MCP サーバー https://app.opslevel.com/mcp を推奨します。ローカルへのインストールやバイナリの管理が不要で、自動的に最新の状態に保たれます。

ホスト型 MCP サーバーの利用

ホスト型サーバーは OAuth を使用するため、管理が必要な API トークン、バイナリ、クライアントシークレットはありません。リモート MCP サーバーに対応した AI ツールで設定する値は、URL だけです。

{
    "mcpServers": {
        "opslevel": {
            "url": "https://app.opslevel.com/mcp"
        }
    }
}

クライアントは OAuth の設定を自動的に検出し、ブラウザーを開いて OpsLevel へのログインとアクセス許可を求めます。補足事項：

• 認証には OAuth 2.1（動的クライアント登録＋PKCE を使用した認可コードフロー）を使用します。短期間で期限切れになるアクセストークンの更新も含め、MCP クライアントが処理します。
• トランスポートにはストリーミング可能な HTTP（SSE ではありません）を使用します。クライアントで選択を求められた場合は、HTTP／ストリーミング可能な HTTP を選択してください。
• リモート MCP サーバーを追加する場所については、使用する AI ツールのドキュメントを参照してください。

この MCP（モデルコンテキストプロトコル）サーバーは、OpsLevel アカウントとやり取りするためのツールを AI に提供します。

機能

現在、MCP サーバーが OpsLevel アカウントにアクセスする際は読み取り専用で、次のリソースからデータを読み取ることができます。

• アクション
• キャンペーン
• チェック
• コンポーネント
• コンポーネントの依存先（あるコンポーネントが依存するコンポーネント）
• コンポーネントの依存元（あるコンポーネントに依存するコンポーネント）
• ドキュメント（API と技術ドキュメント）
• ドメイン
• フィルター
• インフラストラクチャ
• リポジトリ
• システム
• チーム
• ユーザー

セットアップ

1. MCP サーバーをインストールします
   1. Homebrew - brew install opslevel/tap/opslevel-mcp
   2. Docker - docker pull public.ecr.aws/opslevel/mcp:latest
      固定バージョンも使用できます。利用可能なタグについてはギャラリーをご覧ください
   3. 手動 - GitHub のリリースページにアクセスし、お使いのオペレーティングシステム用のバイナリをダウンロードします。
2. 環境変数を使用して MCP サーバーがアカウントに接続できるようにするには、API トークンが必要です。
3. お好みの AI ツール用に MCP 設定をセットアップします。

Claude

Claude Desktop

1. Claude Desktop のドキュメントに記載されているパスにあるファイルを編集します
   1. Mac OS - ${HOME}/Library/Application\ Support/Claude/claude_desktop_config.json
   2. Windows - %APPDATA%\Claude\claude_desktop_config.json
2. Claude Desktop を起動（または再起動）します

{
    "mcpServers": {
        "opslevel": {
            "command": "opslevel-mcp",
            "env": {
                "OPSLEVEL_API_TOKEN": "XXXXXXX"
            }
        }
    }
}

VS Code

VS Code のユーザー設定

1. 設定メニュー（Command + Comma）を開き、ページ上部で用途に応じたタブを選択します
   1. Workspace - ワークスペースのコンテキストでサーバーを設定します
   2. User - ユーザーのコンテキストでサーバーを設定します
2. Features → Chat を選択します
3. 「Mcp」が有効になっていることを確認します
   1. 組織の CoPilot 設定で「preview」機能を有効にするよう、Github 管理者に依頼する必要がある場合があります。
4. 「Mcp > Discovery」の下にある「Edit in settings.json」をクリックし、以下の設定を追加します
   1. ファイルを直接編集することもできます
      1. (Mac OS) ${HOME}/Library/Application\\ Support/Code/User/settings.json
5. VS Code を起動（または再起動）します

{
    "chat.agent.enabled": true,
    "chat.mcp.discovery.enabled": true,
    "mcp": {
        "inputs": [
          {
            "type": "promptString",
            "id": "opslevel_token",
            "description": "OpsLevel API Token",
            "password": true
          }
        ],
        "servers": {
            "opslevel": {
                "type": "stdio",
                "command": "opslevel-mcp",
                "env": {
                    "OPSLEVEL_API_TOKEN": "${input:opslevel_token}"
                }
            }
        }
    }
}

Cursor

Cursor のドキュメント

1. Cursor メニューを開き、「Settings」→「Cursor Settings」→「MCP」を選択します
2. 「Add new global MCP server」をクリックします
3. 以下の設定を追加します

{
  "mcpServers": {
    "opslevel": {
      "command": "opslevel-mcp",  
      "env": {
        "OPSLEVEL_API_TOKEN": "XXXXXX"
      }
    }
  }
}

Warp

Warp

1. Settings > AI > Manage MCP Servers から MCP 設定にアクセスします。Warp では、この一覧へのアクセス方法を他にも案内しています。
2. 追加ボタンを押します
3. 以下の設定を追加します

{
  "opslevel": {
    "command": "opslevel-mcp",
    "args": [],
    "env": {
      "OPSLEVEL_API_TOKEN": "XXXXXX"
    },
    "start_on_launch": true
  }
}

Windsurf

Windsurf

1. Windsurf - Settings > Advanced Settings に移動します
2. Cascade セクションまでスクロールすると、新しいサーバーを追加するオプションがあります
3. 以下の設定で mpc_config.json を編集します
4. Windsurf を再起動します

{
  "mcpServers": {
    "opslevel": {
      "command": "opslevel-mcp",  
      "env": {
        "OPSLEVEL_API_TOKEN": "XXXXXX"
      }
    }
  }
}

Docker

バイナリを直接インストールせずに Docker イメージを取得した場合は、Docker 経由でサーバーを実行できるよう、上記の MCP 設定を調整する必要があります

        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "OPSLEVEL_API_TOKEN",
          "public.ecr.aws/opslevel/mcp:latest"
        ],