Configurar o AppSignal MCP - AppSignal Documentation

O AppSignal MCP é um endpoint HTTP público em https://appsignal.com/api/mcp. Autentique-se uma vez e depois adicione o endpoint à sua ferramenta de IA usando as instruções do seu editor ou app.

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:

Selecione o ícone do seu perfil.
Vá em Account Settings.
Selecione MCP Tokens para criar um novo token.

O formulário do token tem duas listas longas de checkboxes: as aplicações às quais o token terá escopo e as permissões a expor. Cada lista tem um botão Select all no cabeçalho que marca ou desmarca todas as caixas de uma só vez.

Configuração

Configure o AppSignal MCP nas configurações do seu agente de IA usando o endpoint HTTP https://appsignal.com/api/mcp. Cada uma das seções a seguir tem abas para OAuth e Bearer token — escolha o que você configurou na seção Autenticação.

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

claude mcp add --transport http appsignal https://appsignal.com/api/mcp \
  --header "Authorization: Bearer your-mcp-token"

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"]
    }
  }
}

{
  "mcpServers": {
    "appsignal": {
      "url": "https://appsignal.com/api/mcp",
      "headers": {
        "Authorization": "Bearer your-mcp-token"
      }
    }
  }
}

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"]
    }
  }
}

{
  "mcpServers": {
    "appsignal": {
      "serverUrl": "https://appsignal.com/api/mcp",
      "headers": {
        "Authorization": "Bearer your-mcp-token"
      }
    }
  }
}

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"
    }
  }
}

{
  "context_servers": {
    "appsignal": {
      "settings": {},
      "enabled": true,
      "url": "https://appsignal.com/api/mcp",
      "headers": {
        "Authorization": "Bearer your-mcp-token"
      }
    }
  }
}

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.

Adicione isto ao seu .vscode/mcp.json:

{
  "servers": {
    "appsignal": {
      "type": "http",
      "url": "https://appsignal.com/api/mcp"
    }
  }
}

{
  "inputs": [
    {
      "type": "promptString",
      "id": "appsignal_mcp_token",
      "description": "AppSignal MCP Token",
      "password": true
    }
  ],
  "servers": {
    "appsignal": {
      "type": "http",
      "url": "https://appsignal.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:appsignal_mcp_token}"
      }
    }
  }
}

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.

Gemini CLI

O Gemini CLI lê os servidores MCP a partir de ~/.gemini/settings.json (nível de usuário) ou .gemini/settings.json em um projeto. Adicione o AppSignal em mcpServers:

{
  "mcpServers": {
    "appsignal": {
      "httpUrl": "https://appsignal.com/api/mcp"
    }
  }
}

{
  "mcpServers": {
    "appsignal": {
      "httpUrl": "https://appsignal.com/api/mcp",
      "headers": {
        "Authorization": "Bearer your-mcp-token"
      }
    }
  }
}

Deixe headers de fora para usar OAuth: quando o endpoint retorna 401, o Gemini CLI descobre o fluxo e abre o login pelo navegador. Você também pode adicionar o servidor pela linha de comando com gemini mcp add appsignal https://appsignal.com/api/mcp. Veja a documentação MCP do Gemini CLI para o schema completo de mcpServers e os comandos gemini mcp.

Claude app

O Claude app — o Claude.ai na web e os apps para desktop e mobile — conecta-se ao AppSignal MCP como um custom connector via OAuth. Não há opção de Bearer token no app.

No Claude, abra Settings e depois Connectors.
Selecione Browse, pesquise por appsignal e abra o connector do AppSignal. Se ele não estiver listado, selecione Add custom connector e informe a URL https://appsignal.com/api/mcp.
Selecione Connect e depois conclua o login no AppSignal quando solicitado.
Inicie um chat e tente um prompt como “List my AppSignal applications”. Você pode conectar ou desconectar o AppSignal a qualquer momento em Settings → Connectors.

Custom connectors estão disponíveis nos planos Free, Pro, Max, Team e Enterprise; o Free é limitado a um custom connector. No Team e no Enterprise, um administrador da organização gerencia os connectors disponíveis. Veja o guia de custom connectors do Claude para mais detalhes.

OpenAI Codex

O Codex conecta-se ao AppSignal MCP como um servidor streamable HTTP. Adicione-o pelo Codex app e autentique com OAuth, ou configure-o em um arquivo com um Bearer token. Para adicioná-lo no Codex app:

Abra Settings, depois MCP servers, e selecione Add server.
Escolha o transporte Streamable HTTP, informe o nome appsignal e a URL https://appsignal.com/api/mcp e salve.
Selecione Authenticate ao lado do servidor AppSignal.
Na tela de autorização do AppSignal, escolha sua organização e, opcionalmente, as aplicações a expor (deixe-as desmarcadas para expor todas) e depois selecione Allow access.

Para configurar o Codex por um arquivo, edite ~/.codex/config.toml (ou .codex/config.toml em um projeto). Defina bearer_token_env_var com o nome de uma variável de ambiente que contém um token MCP:

[mcp_servers.appsignal]
url = "https://appsignal.com/api/mcp"
bearer_token_env_var = "APPSIGNAL_MCP_TOKEN"

Depois defina APPSIGNAL_MCP_TOKEN no seu ambiente. Veja a documentação MCP do Codex para http_headers, OAuth e o schema completo de mcp_servers.

Verificar a conexão

Depois de adicionar o servidor, confirme que seu agente consegue alcançá-lo antes de depender dele.

Claude Code: execute claude mcp list — o AppSignal deve aparecer como ✔ Connected — ou execute /mcp dentro de uma sessão para inspecionar o servidor e suas tools.
Outros editores: abra o painel MCP ou de context-server nas configurações do editor, onde o AppSignal deve aparecer como conectado.

Em seguida, tente um prompt que chame uma tool de leitura, como “List my AppSignal applications”. Uma lista dos seus pares app_name/app_environment confirma que as tools estão funcionando. Se o agente reportar que não há aplicações, verifique se você autorizou a organização correta durante o OAuth ou se seu token MCP tem escopo para as aplicações que você espera.

Uso, logging e tratamento de dados

Limites de taxa e acesso à conta

O AppSignal não aplica nenhum limite de taxa específico para MCP. As chamadas de tools passam pela mesma infraestrutura do restante do appsignal.com e compartilham suas proteções gerais. O que controla o acesso é o plano da sua conta. Uma conta bloqueada, ou uma conta gratuita fora do período de trial e acima do limite de uso, recebe um erro em vez de dados — a mesma restrição que o restante da API do AppSignal usa.

O que o AppSignal MCP registra em log

O AppSignal registra cada chamada de tool para fins de confiabilidade e prevenção de abuso: o nome da tool, os argumentos que você passa e seus IDs de conta e usuário. O get_more_tools também registra a capacidade que você pediu. Seu email e o nome da organização podem aparecer na resposta de uma tool, mas o log armazena IDs, não esses valores. Como os argumentos são registrados, não passe segredos em parâmetros de texto livre, como consultas de log. Os logs do MCP seguem a retenção de log geral do AppSignal; não há uma janela de retenção separada para o MCP.

Tratamento de dados e conformidade

O MCP lê e escreve os mesmos dados do restante do AppSignal, então herda o tratamento de dados do AppSignal. O AppSignal é compatível com GDPR, certificado ISO/IEC 27001 e hospeda dados na UE. A cobertura HIPAA está disponível por meio de um add-on de Business Associate Agreement. Para os detalhes, veja GDPR, Segurança e Business add-ons.

Solução de problemas

O servidor não conecta, ou o OAuth falha

Recorra a um Bearer token. Gere um token MCP e use a aba Bearer token do seu editor. No Claude Code:

Bash

claude mcp add --transport http appsignal https://appsignal.com/api/mcp \
  --header "Authorization: Bearer your-mcp-token"

Depois execute claude mcp list para confirmar que o AppSignal aparece como conectado.

Nenhuma aplicação aparece

Seu login OAuth autorizou uma organização diferente, ou seu token MCP não tem escopo para os apps que você espera. Peça ao agente para “list my AppSignal applications”. Se a lista estiver vazia ou faltando apps, faça login novamente e escolha a organização correta, ou regenere o token com essas aplicações selecionadas.

”Application not found”

app_name e app_environment são comparados sem diferenciar maiúsculas de minúsculas, mas ainda assim precisam corresponder a um app que você pode acessar. O erro lista essas aplicações — tente novamente com um nome e ambiente exatos da lista.

Uma chamada de tool reporta que o acesso está restrito

Sua conta está bloqueada, ou uma conta gratuita ultrapassou o período de trial e o limite de uso. O MCP usa as mesmas regras de acesso do restante da API do AppSignal. Resolva o estado do plano ou da cobrança e tente de novo.

GitHub Copilot no VS Code não mostra nenhum servidor MCP

No Copilot Business ou Enterprise, os servidores MCP são desabilitados por padrão e controlados por uma policy da organização. Um owner da organização deve definir Settings → Copilot → Policies → Features → MCP servers in Copilot como Enabled e depois reconectar.

Uma ferramenta que deseja está faltando?

Um token MCP expõe apenas os toolsets que você selecionou ao criá-lo. Um token criado antes de uma tool ser lançada não a incluirá, a menos que você tenha configurado o token para expor novas tools automaticamente. Regenere o token, ou crie um com o toolset habilitado. O OAuth expõe todas as tools de leitura e escrita, então mude para OAuth se quiser tudo.

Escopo e roadmap

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: criar ou modificar uptime monitors não é exposto. Você ainda pode listar seus monitors e suas configurações pelo get_app_resources. Resultados de uptime são armazenados como métricas (uptime_monitor_error_count e uptime_monitor_duration), então você pode calcular o uptime por conta própria pelas tools de métricas (get_metric_names, get_metric_tags, get_metrics_timeseries e get_metrics_list).
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.

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.

​Autenticação

​Configuração

​Claude Code

​Cursor

​Windsurf

​Zed

​VS Code

​GitHub Copilot CLI

​Gemini CLI

​Claude app

​OpenAI Codex

​Verificar a conexão

​Uso, logging e tratamento de dados

​Limites de taxa e acesso à conta

​O que o AppSignal MCP registra em log

​Tratamento de dados e conformidade

​Solução de problemas

​O servidor não conecta, ou o OAuth falha

​Nenhuma aplicação aparece

​”Application not found”

​Uma chamada de tool reporta que o acesso está restrito

​GitHub Copilot no VS Code não mostra nenhum servidor MCP

​Uma ferramenta que deseja está faltando?

​Escopo e roadmap

​Fora do escopo do toolset

​No roadmap se houver demanda

​Obtendo ajuda

Autenticação

Configuração

Claude Code

Cursor

Windsurf

Zed

VS Code

GitHub Copilot CLI

Gemini CLI

Claude app

OpenAI Codex

Verificar a conexão

Uso, logging e tratamento de dados

Limites de taxa e acesso à conta

O que o AppSignal MCP registra em log

Tratamento de dados e conformidade

Solução de problemas

O servidor não conecta, ou o OAuth falha

Nenhuma aplicação aparece

”Application not found”

Uma chamada de tool reporta que o acesso está restrito

GitHub Copilot no VS Code não mostra nenhum servidor MCP

Uma ferramenta que deseja está faltando?

Escopo e roadmap

Fora do escopo do toolset

No roadmap se houver demanda

Obtendo ajuda