Pular para o conteúdo principal
O AppSignal MCP está atualmente em preview. Junte-se à nossa comunidade no Discord para ajudar a testar e moldar esta implementação.
O Model Context Protocol (MCP) permite que agentes de IA e editores de código com IA, como Claude, Cursor, Windsurf, Zed, VS Code e GitHub Copilot, interajam com ferramentas e fontes de dados externas. O AppSignal MCP dá a esses agentes acesso direto aos seus dados de monitoramento: erros, traces, logs, métricas e mais. O AppSignal MCP é um endpoint HTTP público em https://appsignal.com/api/mcp. A maioria dos agentes se conecta diretamente a ele. Se preferir rodar um proxy local — por exemplo, em um ambiente que restringe o tráfego de saída — uma imagem Docker opcional está disponível.

​
O que você pode acessar

O AppSignal MCP expõe acesso de leitura e escrita aos seus dados de monitoramento em sete áreas. Cada área mapeia para uma permissão que você pode configurar ao autenticar: com um token MCP, defina cada área como read, write ou desativada; com OAuth, todas as ferramentas de leitura e escrita são expostas de uma só vez. O que você recebe de volta depende do que seus apps enviam ao AppSignal. Se seu app não está enviando logs, get_log_lines não vai retornar nada. O AppSignal MCP é um portal para dados que o AppSignal já tem. Ele não coleta novos dados por conta própria.

​
Disponível agora

  • Incidentes de erro (read + write): listar e pesquisar exceções, inspecionar stack traces, atualizar estado e severidade, atribuir responsáveis e adicionar notas
  • Performance (read): ranquear as actions mais lentas, puxar traces, percorrer árvores de spans e inspecionar atributos de spans. Baseado em samples para apps Ruby e Elixir padrão; traces OpenTelemetry para apps que enviam dados OTel
  • Detecção de anomalias (read + write): navegar por alerts, listar triggers existentes e criar, atualizar ou arquivar triggers
  • Logging (read + write): consultar linhas de log com a expression syntax do AppSignal e configurar regras de ingestão de log: filter, trigger e metrics actions. Particularmente poderoso para juntar a jornada de um cliente entre log sources, erros e traces em um único prompt — veja reconstruindo a jornada de um cliente
  • Métricas (read): descobrir categorias de métricas (incluindo host_metrics), listar nomes e tags de métricas e puxar timeseries ou valores agregados
  • Dashboards (read + write): criar dashboards e adicionar ou atualizar visualizações de chart
  • App discovery (read): listar suas aplicações, ambientes, namespaces, usuários, notifiers, log sources, log line actions e deploy markers
Para a lista completa de tools, parâmetros e prompts de exemplo, consulte a Referência de Tools do MCP.

​
Fora do escopo do toolset

Alguns recursos do AppSignal intencionalmente não são expostos por tools MCP dedicadas. Na maioria dos casos já existe uma forma melhor de acessar os dados, ou uma interface em linguagem natural não é o ajuste certo para o trabalho. Cada tool exposta também ocupa espaço no contexto do seu agente, então preferimos manter o toolset focado em vez de espelhar cada parte do app.
  • Gerenciamento de uptime monitors: resultados de uptime são armazenados como métricas (uptime_monitor_error_count e uptime_monitor_duration), então você já pode consultá-los pelas tools de métricas existentes (get_metric_names, get_metric_tags, get_metrics_timeseries e get_metrics_list). Tools dedicadas para listar ou criar uptime monitors não estão no roadmap no momento.
  • Gerenciamento de notifier, usuário e deploy marker: criar ou modificar isso requer permissões de owner e tem consequências reais: um prompt mal interpretado poderia conceder acesso à pessoa errada ou redirecionar alertas. Operações administrativas como essas são melhor tratadas na UI do AppSignal, onde são explícitas e fáceis de auditar. Você ainda pode ler notifiers, usuários e deploy markers via get_app_resources.
  • Ingestão de métricas personalizadas e signals: o caminho de ingestão do AppSignal roda em endpoints dedicados otimizados para entrega de alta vazão, e o AppSignal MCP não foi projetado para enviar dados. Para enviar métricas personalizadas, use a integração do AppSignal na sua aplicação.

​
No roadmap se houver demanda

  • Consulta de process monitors: acesso de leitura aos dados de cron e heartbeat process monitor. Queremos medir o interesse antes de adicionar isso.
Essas são posturas atuais e podem mudar conforme a forma como os agentes funcionam evolui. Se você esbarrar em uma limitação com o toolset atual, nos conte na comunidade do Discord para que possamos avaliar.

​
Autenticação

Você precisa de uma conta AppSignal para começar. O AppSignal MCP suporta dois métodos de autenticação — escolha o que se encaixa no agente de IA que você está configurando:
  • OAuth — faça login com sua conta AppSignal uma vez. O acesso é concedido a nível de aplicação e expõe todas as tools de leitura e escrita de uma só vez. O caminho recomendado para o GitHub Copilot CLI, e a configuração mais simples para editores que suportam servidores MCP remotos nativamente (Claude Code, VS Code) ou que podem rodar o mcp-remote como ponte (Cursor, Windsurf, Zed).
  • Bearer token — gere um token MCP de longa duração com permissões granulares por toolset. Cada token pode ser definido como read, write ou desativado por área, com escopo para aplicações específicas, e configurado para expor automaticamente novas tools conforme são lançadas. Melhor quando você quer limitar o que um agente pode fazer.
Se você está começando e seu agente suporta OAuth, esse é o caminho mais rápido. Se precisa de permissões por tool ou escopo por app, gere um token MCP. Para gerar um Bearer token:
  1. Selecione o ícone do seu perfil.
  2. Vá em Account Settings.
  3. Selecione MCP Tokens para criar um novo token.

​
Configuração

Configure o AppSignal MCP nas configurações do seu agente de IA usando o endpoint HTTP https://appsignal.com/api/mcp. Cada seção abaixo tem abas para OAuth e Bearer token — escolha o que configurou acima.
O suporte a OAuth é novo em nossos editores suportados. Se a aba OAuth apresentar erros no seu editor, use a aba Bearer token e nos avise em nossa comunidade no Discord para que possamos aprimorar essas instruções.

​
Claude Code

claude mcp add --transport http appsignal https://appsignal.com/api/mcp
Com OAuth, o Claude Code inicia o fluxo de login pelo navegador na primeira vez que ferramentas do AppSignal são invocadas. Veja a documentação MCP do Claude Code para as flags de transporte e referência da CLI.

​
Cursor

Edite ~/.cursor/mcp.json: 
{
  "mcpServers": {
    "appsignal": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://appsignal.com/api/mcp"]
    }
  }
}
A configuração OAuth usa o mcp-remote como ponte local para o endpoint HTTP. O fluxo de login pelo navegador abre na primeira vez que o Cursor se conecta. Veja a documentação MCP do Cursor para o schema completo.

​
Windsurf

Edite ~/.codeium/windsurf/mcp_config.json: 
{
  "mcpServers": {
    "appsignal": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://appsignal.com/api/mcp"]
    }
  }
}
Veja a documentação MCP do Windsurf para o schema completo e notas sobre OAuth.

​
Zed

Abra seu arquivo de configurações do Zed e adicione a seção context_servers: 
{
  "context_servers": {
    "appsignal": {
      "settings": {},
      "enabled": true,
      "url": "https://appsignal.com/api/mcp"
    }
  }
}
Quando o header Authorization é omitido, o Zed inicia o fluxo padrão MCP OAuth contra o AppSignal. Veja a documentação MCP do Zed para o schema completo de context_servers.

​
VS Code

Se você estiver rodando o GitHub Copilot e estiver logado em uma conta corporativa, certifique-se de definir “MCP servers in Copilot” como “Enabled” nas configurações da sua organização > Copilot > Policies. Configurações do GitHub Copilot Adicione isto ao seu .vscode/mcp.json: 
{
  "servers": {
    "appsignal": {
      "type": "http",
      "url": "https://appsignal.com/api/mcp"
    }
  }
}
Com OAuth, o VS Code inicia o fluxo de login na primeira vez que ferramentas do AppSignal são usadas. Veja a documentação MCP do VS Code para variáveis de input e headers.

​
GitHub Copilot CLI

O GitHub Copilot CLI usa OAuth para autenticação MCP. Execute o seguinte para adicionar o AppSignal:
Bash
copilot mcp add appsignal https://appsignal.com/api/mcp
Siga o prompt OAuth para autorizar o AppSignal. Uma vez conectado, as ferramentas do AppSignal estarão disponíveis nas sessões do Copilot CLI. Veja a documentação MCP do GitHub Copilot CLI para o fluxo interativo /mcp add e a localização do arquivo de configuração.

​
Obtendo ajuda

Encorajamos você a participar da nossa comunidade no Discord, onde você pode:
  • Obter ajuda com a configuração do AppSignal MCP
  • Compartilhar feedback e sugestões
  • Conectar-se com outros desenvolvedores que usam o AppSignal MCP
  • Manter-se atualizado sobre novos recursos e melhorias
Procure pelo canal dedicado #mcp, onde nossa equipe acompanha e responde ativamente às perguntas.