Rollbar

Acesse dados de projetos do Rollbar para monitoramento e depuração de erros.

GitHub
28
Experimente este MCPPatrocinado

Documentação

rollbar-mcp-server

Um servidor Model Context Protocol (MCP) para Rollbar.

Recursos

Este servidor MCP implementa o tipo de servidor stdio, o que significa que sua ferramenta de IA (ex.: Claude, Cursor) o executará diretamente; você não executa um processo separado nem se conecta via http.

Configuração

Token de acesso da conta

Configure um único Token de Acesso da Conta Rollbar e deixe todas as ferramentas funcionarem em todos os projetos dessa conta:

  • ROLLBAR_ACCOUNT_ACCESS_TOKEN (variável de ambiente), ou
  • accountToken (uma chave de nível superior em .rollbar-mcp.json, junto com projects/token/apiBase)

Para criar um: no Rollbar, vá para configurações da conta → Tokens de Acesso da Conta, crie um novo token nomeado e habilitado, e escolha o escopo leitura (ou leitura e escrita, se você planeja usar update-item). Copie o segredo completo gerado imediatamente — o Rollbar só o exibe uma vez — e armazene-o com segurança (um gerenciador de segredos ou a configuração de ambiente do seu shell, não versionado no controle de código-fonte).

{
  "accountToken": "acct_tok_abc123"
}

Se você quiser controles mais rígidos em alguns projetos, dê ao token da conta o escopo de leitura para que você possa ler todos os projetos e, em seguida, liste explicitamente os poucos projetos que precisam de update-item com seus próprios tokens de projeto de leitura+escrita. Eles substituem o token da conta apenas para aquele projeto, conforme a regra de precedência abaixo (token de projeto explícito sempre vence).

{
  "accountToken": "acct_tok_abc123",
  "projects": [
    { "name": "backend", "token": "tok_backend_readwrite" }
  ]
}

As configurações de token de projeto não mudam em nada com este recurso: se você não definir um token de conta, nada no comportamento das configurações existentes de projeto único ou múltiplo será diferente. Os dois modos também podem coexistir: se um nome de project corresponder a um projeto explicitamente configurado que tenha seu próprio token, o token do próprio projeto será sempre usado para aquele projeto, mesmo quando um token de conta também estiver presente.

Configuração por projeto para acesso mais seguro

Projeto único: variável de ambiente

  • ROLLBAR_ACCESS_TOKEN: token de acesso para o seu projeto Rollbar.
  • ROLLBAR_API_BASE (opcional): substitui a URL base da API (padrão: https://api.rollbar.com/api/1).

Vários projetos: arquivo de configuração

Crie .rollbar-mcp.json no seu diretório de trabalho ou diretório pessoal, ou defina ROLLBAR_CONFIG_FILE para apontar para um caminho personalizado. Um modelo versionado está disponível em rollbar-mcp-example.json; copie-o para .rollbar-mcp.json e preencha com seus tokens reais.

Atalho para projeto único:

{ "token": "tok_abc123" }

Vários projetos:

{
  "projects": [
    { "name": "backend",  "token": "tok_abc123" },
    { "name": "frontend", "token": "tok_xyz789" }
  ]
}

Ordem de busca do arquivo de configuração:

  1. Variável de ambiente ROLLBAR_CONFIG_FILE
  2. .rollbar-mcp.json no diretório de trabalho atual
  3. ~/.rollbar-mcp.json no diretório pessoal
  4. Variável de ambiente ROLLBAR_ACCESS_TOKEN ou ROLLBAR_ACCOUNT_ACCESS_TOKEN (projeto único ou conta inteira, compatível com versões anteriores)

Se um arquivo de configuração existir, mas for inválido, o servidor encerra com erro em vez de recorrer a uma fonte de configuração de prioridade mais baixa.

Escopos necessários:

  • Ferramentas somente leitura (get-item-details, get-deployments, get-version, get-top-items, list-items, get-replay, list-projects, list-occurrences) funcionam com um token de conta com escopo leitura.
  • update-item exige um token de conta com escopo leitura e escrita: cada chamada com token de conta resolve o projeto de destino via GET /projects primeiro (leitura) e depois faz a solicitação PATCH (escrita). Um token somente escrita falhará na etapa de resolução do projeto antes mesmo de chegar à atualização.
  • Assim como nos tokens de projeto, prefira um token com escopo de leitura, a menos que você precise especificamente de update-item.

Se o servidor detectar que apenas ROLLBAR_ACCESS_TOKEN está definido (sem token de conta explícito), ele faz uma verificação única e em cache contra GET /projects para ver se esse token é realmente um token de conta; se for, o modo de conta é ativado automaticamente. Um token com escopo de projeto único continua funcionando exatamente como antes.

Ferramentas

list-projects(): Veja com quais projetos Rollbar este servidor pode conversar. Se você estiver usando um token de projeto único, isso apenas confirma o único projeto configurado. Se você estiver usando um token de conta que alcança vários projetos, é assim que você encontra o nome ou id do projeto para passar no parâmetro project das outras ferramentas.

get-item-details(counter, max_tokens?, project?): Obtenha o panorama completo de um único item do Rollbar: seus detalhes mais a ocorrência mais recente, para que você não precise consultar o item e depois buscar o erro mais recente separadamente. Informe o contador do item (o número que você vê na interface do Rollbar).

max_tokens (padrão 20000) limita o tamanho dos dados de ocorrência na resposta. Algumas ocorrências carregam muitos detalhes (stack traces longos, dados de requisição), então isso evita que uma única consulta de item infle demais a resposta. O project opcional seleciona qual projeto usar, pelo nome configurado ou pelo nome/id real do projeto no modo token de conta. Exemplo de prompt: Diagnose the root cause of Rollbar item #123456

get-deployments(limit, project?): Liste os deploys recentes de um projeto, para que você possa alinhar quando um deploy foi publicado com quando os erros começaram ou pararam. project opcional quando vários projetos estão configurados ou no modo token de conta. Exemplo de prompt: List the last 5 deployments ou Are there any failed deployments?

get-version(version, environment, project?): Consulte o desempenho de uma versão específica (como um git SHA) em um ambiente, incluindo quando ela apareceu pela primeira e última vez nas ocorrências. Útil para verificar se uma versão específica introduziu ou corrigiu um problema. project opcional quando vários projetos estão configurados ou no modo token de conta.

get-top-items(environment, project?): Veja o que está realmente quebrando agora. Retorna os itens com mais ocorrências nas últimas 24 horas para o ambiente informado, para que você priorize o que analisar primeiro em vez de varrer a lista completa de itens. project opcional quando vários projetos estão configurados ou no modo token de conta.

list-items(status?, level?, environment?, page?, limit?, query?, project?): Pesquise e filtre itens do Rollbar em vez de puxar a lista inteira. Filtre por status (padrão active, para que itens resolvidos e silenciados fiquem fora do caminho), level e environment, ou pesquise por texto em query. Use page e limit para controlar quantos resultados voltam de uma vez. project opcional quando vários projetos estão configurados ou no modo token de conta.

list-occurrences(counter, limit?, page?, last_id?, max_tokens?, project?): Consulte as ocorrências reais por trás de um item do Rollbar, não apenas o resumo do item. Informe o contador do item e ele retorna as instâncias individuais, cada uma com seu próprio timestamp, ambiente e detalhe do erro.

Use limit para controlar quantas ocorrências voltam (padrão 3, máximo 100), e page ou last_id para navegar por mais delas. last_id é paginação baseada em cursor: passe o id da última ocorrência recebida e você obterá o próximo lote depois dela. Adicionamos isso porque números de página simples podem pular ou repetir resultados se as ocorrências mudarem entre chamadas, e last_id não tem esse problema, então use-o ao paginar muitas ocorrências. Se você passar ambos, last_id vence. As ocorrências dentro de uma página são sempre ordenadas por timestamp (mais recentes primeiro), então a última que você vê é confiavelmente a certa para devolver como last_id.

Os dados de ocorrência podem crescer rápido, especialmente para erros com stack traces grandes ou payloads de requisição. max_tokens (padrão 20000, mínimo 100) limita aproximadamente o tamanho total da resposta, em cerca de max_tokens * 4 caracteres. Criamos isso porque, sem um limite, algumas ocorrências poderiam estourar o que cabe em uma conversa. Cada ocorrência solicitada ainda aparece na resposta, no entanto. Em vez de descartar alguma delas para ficar dentro do orçamento, a ferramenta reduz as maiores passo a passo, mantendo os campos mais úteis (nível, ambiente, mensagem de exceção e similares) pelo maior tempo possível antes de cair para apenas um id e timestamp. Um campo de nível superior _truncation informa quando isso aconteceu. Se o seu limit e max_tokens realmente não couberem nem uma versão mínima de cada ocorrência, você receberá um erro claro pedindo para reduzir limit ou aumentar max_tokens, em vez de uma página silenciosamente incompleta.

Alguns itens do Rollbar são, na verdade, grupos de vários itens agrupados. A API pública do Rollbar ainda não consegue listar ocorrências corretamente para esses casos, então chamar esta ferramenta em um item de grupo retorna uma mensagem explícita de group_item_not_supported informando isso, em vez de mostrar silenciosamente uma lista vazia que parece que o item não tem ocorrências.

project opcional quando vários projetos estão configurados. Exemplo de prompt: Show me the last 3 occurrences of item #24265

get-replay(environment, sessionId, replayId, delivery?, project?): Busque os metadados e o payload de um session replay para uma sessão específica, para que você veja o que um usuário realmente fez antes de um erro.

Por padrão (delivery="file"), o JSON do replay é gravado em um arquivo temporário no disco e a ferramenta retorna o caminho do arquivo. Isso funciona em qualquer lugar, mas o arquivo permanece até você limpá-lo manualmente. Defina delivery="resource" para receber um link rollbar:// que clientes compatíveis com MCP podem ler diretamente, sem deixar arquivo para trás, mas isso só funciona quando o servidor conversa apenas com um único projeto (modo token de projeto único ou modo token de conta com exatamente um projeto). Se você estiver configurado para vários projetos, use delivery="file" e passe project explicitamente.

project opcional quando vários projetos estão configurados ou no modo token de conta. Exemplo de prompt: Fetch the replay 789 from session abc in staging.

update-item(itemId, status?, level?, title?, assignedUserId?, resolvedInVersion?, snoozed?, teamId?, project?): Altere o status, nível, título, responsável, versão resolvida, estado de adiamento ou equipe proprietária de um item, para que você possa agir diretamente no item em vez de mudar para a interface do Rollbar.

Isso exige acesso de escrita: um token de projeto com escopo write, ou um token de conta com escopo read e write. Um token somente leitura falhará aqui, mesmo funcionando bem em todas as outras ferramentas. project opcional quando vários projetos estão configurados ou no modo token de conta. Exemplo de prompt: Mark Rollbar item #123456 as resolved ou Assign item #123456 to user ID 789.

Como usar

Claude Code

Configure seu .mcp.json da seguinte forma.

Usando uma variável de ambiente (projeto único):

{
  "mcpServers": {
    "rollbar": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@rollbar/mcp-server@latest"],
      "env": {
        "ROLLBAR_ACCESS_TOKEN": "<project read/write access token>"
      }
    }
  }
}

Opcionalmente, inclua ROLLBAR_API_BASE no bloco env para direcionar um endpoint de API que não seja de produção.

Usando um token de acesso de conta (todos os projetos da conta, sem necessidade de tokens por projeto):

{
  "mcpServers": {
    "rollbar": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@rollbar/mcp-server@latest"],
      "env": {
        "ROLLBAR_ACCOUNT_ACCESS_TOKEN": "<account access token>"
      }
    }
  }
}

Usando um arquivo de configuração (projeto único ou vários):

{
  "mcpServers": {
    "rollbar": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@rollbar/mcp-server@latest"],
      "env": {
        "ROLLBAR_CONFIG_FILE": "/path/to/.rollbar-mcp.json"
      }
    }
  }
}

Codex CLI

Adicione ao seu ~/.codex/config.toml:

[mcp_servers.rollbar]
command = "npx"
args = ["-y", "@rollbar/mcp-server@latest"]
env = { "ROLLBAR_ACCESS_TOKEN" = "<project read/write access token>" }

Ou com um arquivo de configuração:

[mcp_servers.rollbar]
command = "npx"
args = ["-y", "@rollbar/mcp-server@latest"]
env = { "ROLLBAR_CONFIG_FILE" = "/path/to/.rollbar-mcp.json" }

Junie

Configure seu .junie/mcp/mcp.json da seguinte forma (variável de ambiente ou ROLLBAR_CONFIG_FILE para arquivo de configuração):

{
  "mcpServers": {
    "rollbar": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@rollbar/mcp-server@latest"],
      "env": {
        "ROLLBAR_ACCESS_TOKEN": "<project read/write access token>"
      }
    }
  }
}

Cursor

Configure os servidores MCP do Cursor (Cursor Settings → Features → MCP, ou pesquise por "MCP" nas configurações). Use uma variável de ambiente ou um arquivo de configuração.

Com uma variável de ambiente (projeto único):

{
  "mcpServers": {
    "rollbar": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@rollbar/mcp-server@latest"],
      "env": {
        "ROLLBAR_ACCESS_TOKEN": "<project read/write access token>"
      }
    }
  }
}

Com um arquivo de configuração (projeto único ou vários):

{
  "mcpServers": {
    "rollbar": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@rollbar/mcp-server@latest"],
      "env": {
        "ROLLBAR_CONFIG_FILE": "/path/to/.rollbar-mcp.json"
      }
    }
  }
}

Reinicie o Cursor (ou recarregue a janela) após alterar as configurações de MCP. Para usar uma build local em vez de npx, consulte CONTRIBUTING.md.

VS Code (incluindo GitHub Copilot)

Configure seu .vscode/mcp.json da seguinte forma (variável de ambiente ou ROLLBAR_CONFIG_FILE para arquivo de configuração):

{
  "servers": {
    "rollbar": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@rollbar/mcp-server@latest"],
      "env": {
        "ROLLBAR_ACCESS_TOKEN": "<project read/write access token>"
      }
    }
  }
}

Ou usando uma instalação de desenvolvimento local, consulte CONTRIBUTING.md.

Este é o mesmo arquivo que o modo agente do GitHub Copilot lê no VS Code. Coloque-o em .vscode/mcp.json para compartilhar o servidor com todos no repositório, ou no mcp.json do seu perfil de usuário (Command Palette → MCP: Open User Configuration) para manter seu token fora do repositório. Após salvar, inicie o servidor com MCP: List Servers → rollbar → Start e escolha as ferramentas pelo ícone 🛠️ na barra de ferramentas do modo agente do Copilot Chat.

GitHub Copilot CLI

Adicione a ~/.copilot/mcp-config.json. Observe que o Copilot CLI usa mcpServers (não o servers do VS Code) e grafa o transporte stdio como "type": "local":

{
  "mcpServers": {
    "rollbar": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "@rollbar/mcp-server@latest"],
      "env": {
        "ROLLBAR_ACCESS_TOKEN": "<project read/write access token>"
      },
      "tools": ["*"]
    }
  }
}

Ou com um arquivo de configuração, troque o bloco env por ROLLBAR_CONFIG_FILE:

{
  "mcpServers": {
    "rollbar": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "@rollbar/mcp-server@latest"],
      "env": {
        "ROLLBAR_CONFIG_FILE": "/path/to/.rollbar-mcp.json"
      },
      "tools": ["*"]
    }
  }
}

tools: ["*"] habilita todas as ferramentas do Rollbar; restrinja-o a nomes de ferramentas específicos se preferir optar por elas explicitamente. Para limitar o servidor a um único repositório em vez de toda a sua conta, coloque o mesmo JSON em .mcp.json ou .github/mcp.json na raiz do repositório — o Copilot CLI carrega a configuração no nível do projeto somente após você confirmar a confiança na pasta no primeiro lançamento, e as definições do projeto têm precedência sobre ~/.copilot/mcp-config.json.

Execute /mcp dentro de uma sessão interativa (ou copilot mcp list a partir do seu shell) para confirmar que o servidor está conectado.