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 选项。
• 请查阅 AI 工具的文档，了解添加远程 MCP 服务的具体位置。

此 MCP（模型上下文协议）服务为 AI 提供了与 OpsLevel 账户交互的工具。

功能

目前，MCP 服务对 OpsLevel 账户仅具有只读访问权限，并可读取以下资源中的数据：

• 操作
• 活动计划
• 检查
• 组件
• 组件依赖项（某个组件所依赖的组件）
• 组件依赖方（依赖某个组件的组件）
• 文档（API 和技术文档）
• 域
• 筛选器
• 基础设施
• 仓库
• 系统
• 团队
• 用户

设置

1. 安装 MCP 服务
   1. Homebrew - brew install opslevel/tap/opslevel-mcp
   2. Docker - docker pull public.ecr.aws/opslevel/mcp:latest
      你也可以使用固定版本，查看 gallery 了解可用标签。
   3. 手动安装 - 前往我们的 GitHub releases 页面，下载适用于你操作系统的二进制文件。
2. 你需要一个 API Token，通过环境变量授权 MCP 服务与你的账户通信。
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. 你可能需要让 Github 管理员在组织的 CoPilot 设置中启用“preview”功能。
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 镜像，则需要调整上述 MCP 配置，以支持通过 Docker 运行服务。

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