> ## Documentation Index > Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt > Use this file to discover all available pages before exploring further. # AppSignal MCP 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)][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][github-repo] 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](/mcp/reference#reconstructing-a-customer-journey) * **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](/mcp/reference). ### 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](/metrics/custom), 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](https://discord.com/channels/1361347709839085671/1387797163513348146) para que possamos avaliar. ## Autenticação Você precisa de uma [conta AppSignal][appsignal-sign-up] 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`][mcp-remote] como ponte (Cursor, Windsurf, Zed). * **Bearer token** — gere um [token MCP][appsignal-mcp-token] 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 ```bash OAuth theme={null} claude mcp add --transport http appsignal https://appsignal.com/api/mcp ``` ```bash Bearer token theme={null} 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][claude-code-mcp] para as flags de transporte e referência da CLI. ### Cursor Edite `~/.cursor/mcp.json`: ```json OAuth theme={null} { "mcpServers": { "appsignal": { "command": "npx", "args": ["-y", "mcp-remote", "https://appsignal.com/api/mcp"] } } } ``` ```json Bearer token theme={null} { "mcpServers": { "appsignal": { "url": "https://appsignal.com/api/mcp", "headers": { "Authorization": "Bearer your-mcp-token" } } } } ``` A configuração OAuth usa o [`mcp-remote`][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][cursor-mcp] para o schema completo. ### Windsurf Edite `~/.codeium/windsurf/mcp_config.json`: ```json OAuth theme={null} { "mcpServers": { "appsignal": { "command": "npx", "args": ["-y", "mcp-remote", "https://appsignal.com/api/mcp"] } } } ``` ```json Bearer token theme={null} { "mcpServers": { "appsignal": { "serverUrl": "https://appsignal.com/api/mcp", "headers": { "Authorization": "Bearer your-mcp-token" } } } } ``` Veja a [documentação MCP do Windsurf][windsurf-mcp] para o schema completo e notas sobre OAuth. ### Zed Abra seu arquivo de configurações do Zed e adicione a seção `context_servers`: ```json OAuth theme={null} { "context_servers": { "appsignal": { "settings": {}, "enabled": true, "url": "https://appsignal.com/api/mcp" } } } ``` ```json Bearer token theme={null} { "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][zed-mcp] 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`: ```json OAuth theme={null} { "servers": { "appsignal": { "type": "http", "url": "https://appsignal.com/api/mcp" } } } ``` ```json Bearer token theme={null} { "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][vscode-mcp] 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 Bash theme={null} 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][copilot-cli-mcp] 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][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. [appsignal]: https://www.appsignal.com [appsignal-sign-up]: https://appsignal.com/users/sign_up [appsignal-mcp-token]: https://appsignal.com/users/mcp_tokens [discord]: https://discord.gg/fT2cbMuQSJ [github-repo]: https://github.com/appsignal/appsignal-mcp [mcp]: https://modelcontextprotocol.io/introduction [mcp-remote]: https://www.npmjs.com/package/mcp-remote [claude-code-mcp]: https://code.claude.com/docs/en/mcp [cursor-mcp]: https://cursor.com/docs/mcp [windsurf-mcp]: https://docs.windsurf.com/windsurf/cascade/mcp [zed-mcp]: https://zed.dev/docs/ai/mcp [vscode-mcp]: https://code.visualstudio.com/docs/copilot/chat/mcp-servers [copilot-cli-mcp]: https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers