OpsLevel

OpsLevel MCP Server

[!WARNING] Este servidor MCP auto-hospedado está obsoleto. Novos usuários devem preferir o servidor MCP hospedado em https://app.opslevel.com/mcp, que não requer instalação local ou gerenciamento de binário e permanece automaticamente atualizado.

Usando o servidor MCP hospedado

O servidor hospedado usa OAuth — sem token de API, binário ou segredo de cliente para gerenciar. Para qualquer ferramenta de IA que suporte servidores MCP remotos, o único valor que você precisa configurar é a URL:

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

Seu cliente descobre a configuração OAuth automaticamente e abre um navegador para você fazer login no OpsLevel e conceder acesso. Notas:

• A autenticação é OAuth 2.1 (Registro Dinâmico de Cliente + código de autorização com PKCE) — seu cliente MCP lida com isso para você, incluindo a atualização dos tokens de acesso de curta duração.
• O transporte é streamable HTTP (não SSE). Se o seu cliente perguntar, escolha a opção HTTP / streamable-HTTP.
• Consulte a documentação da sua ferramenta de IA para saber exatamente onde adicionar um servidor MCP remoto.

Este servidor MCP (Model Context Protocol) fornece ferramentas para IAs interagirem com sua conta OpsLevel.

Recursos

Atualmente, o servidor MCP usa apenas acesso somente leitura à sua conta OpsLevel e pode ler dados dos seguintes recursos:

• Actions
• Campaigns
• Checks
• Components
• Component Dependencies (components that a component depends on)
• Component Dependents (components that depend on a component)
• Documentation (API & Tech Docs)
• Domains
• Filters
• Infrastructure
• Repositories
• Systems
• Teams
• Users

Configuração

1. Instale o servidor MCP
   1. Homebrew - brew install opslevel/tap/opslevel-mcp
   2. Docker - docker pull public.ecr.aws/opslevel/mcp:latest
      Você também pode usar uma versão fixada confira a galeria para as tags disponíveis
   3. Manual - Visite nossa página de releases do GitHub e baixe o binário para o seu sistema operacional.
2. Você precisará de um Token de API para autorizar o servidor MCP a falar com sua conta por meio de uma variável de ambiente.
3. Configure a configuração MCP para a ferramenta de IA de sua escolha.

Claude

Claude Desktop

1. Edite o arquivo no caminho especificado de acordo com a documentação do Claude Desktop
   1. Mac OS - ${HOME}/Library/Application\ Support/Claude/claude_desktop_config.json
   2. Windows - %APPDATA%\Claude\claude_desktop_config.json
2. Inicie (ou reinicie) o Claude Desktop

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

VS Code

VS Code User Settings

1. Abra o menu Configurações (Command + Vírgula) e selecione a aba correta no topo da página para o seu caso de uso
   1. Workspace - configura o servidor no contexto do seu workspace
   2. User - configura o servidor no contexto do seu usuário
2. Selecione Features → Chat
3. Certifique-se de que "Mcp" está habilitado
   1. Talvez seja necessário que o administrador do Github habilite os recursos "preview" nas configurações do CoPilot para a organização.
4. Clique em "Edit in settings.json" em "Mcp > Discovery" para ter a configuração abaixo
   1. Também é possível editar o arquivo diretamente
      1. (Mac OS) ${HOME}/Library/Application\\ Support/Code/User/settings.json
5. Inicie (ou reinicie) o 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 Docs

1. Abra o menu Cursor e selecione Settings → Cursor Settings → MCP
2. Clique em "Add new global MCP server"
3. Adicione a configuração abaixo

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

Warp

Warp

1. Acesse suas configurações MCP em Settings > AI > Manage MCP Servers. O Warp fornece instruções para outras formas de acessar esta lista.
2. Pressione o botão adicionar
3. Adicione a configuração abaixo

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

Windsurf

Windsurf

1. Navegue até Windsurf - Settings > Advanced Settings
2. Role até a seção Cascade e você encontrará a opção de adicionar um novo servidor
3. Edite o mpc_config.json com a configuração abaixo
4. Reinicie o Windsurf

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

Docker

Se você não instalou o binário diretamente e em vez disso puxou a imagem docker, precisará ajustar as configurações MCP acima para suportar a execução do servidor via docker

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