Configurar o AppSignal MCP

​

Autenticação

• OAuth — faça login com sua conta AppSignal uma vez. Esse login expõe o toolset do AppSignal MCP disponível para você. A configuração mais simples para cada agente deste guia: cada um se conecta diretamente ao endpoint.
• Bearer token — gere um token MCP de longa duração. Cada token pode ter escopo para aplicações específicas, ser configurado para expor tools específicas, e ser definido para expor automaticamente novas tools conforme são lançadas. Melhor quando você quer limitar o que um agente pode fazer.

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

​

Configuração

​

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

1. No chat do Claude Code, execute /mcp para abrir a lista de servidores MCP e a visualização de status.

2. Se o AppSignal ainda não estiver listado, selecione Add server. Informe AppSignal como nome, escolha HTTP (remote) como transporte, informe https://appsignal.com/api/mcp como URL, deixe os headers vazios para OAuth e escolha o escopo desejado.

3. Abra a entrada do AppSignal na lista de servidores MCP. Se ela mostrar Needs Auth, selecione Authenticate.

4. No navegador, selecione Continue connecting para concluir o fluxo do connector iniciado pelo Claude.

5. No AppSignal, escolha sua organização e, opcionalmente, as aplicações a expor, depois selecione Allow access.

6. Volte ao VS Code e confirme que o Claude Code se reconecta e mostra o AppSignal como Connected.

claude mcp login "claude.ai AppSignal"

​

Claude app

1. No Claude, abra Settings e depois Connectors.
2. 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.
3. Selecione Connect e depois conclua o login no AppSignal quando solicitado.
4. 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.
5. Abra Tool permissions do connector para escolher quando o Claude pode chamar cada tool. As tools são agrupadas em read-only e write/delete, e você pode definir um grupo inteiro ou uma única tool como always allow, ask for approval ou never allow. Só são listadas as tools que seu login expõe.

​

Cursor

1. Abra as configurações do Cursor.
2. Abra a aba Customize, selecione MCPs e depois selecione + Add New MCP Server.
3. Selecione User, informe os valores abaixo no arquivo JSON que se abre e salve sua configuração.

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

{
  "mcpServers": {
    "appsignal": {
      "url": "https://appsignal.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_TOKEN>"
      }
    }
  }
}

• OAuth: deixe headers de fora. O Cursor abre uma aba do navegador onde você concede acesso e escolhe os escopos de autorização, depois finaliza a conexão.
• Bearer token: inclua o header Authorization. O Cursor autoriza com os escopos configurados no token e se conecta sem abrir uma aba.

​

Devin

1. Execute Devin: Cascade MCP Registry na paleta de comandos para abrir o Cascade MCP marketplace.
2. Selecione Add custom MCP.
3. Informe os valores abaixo no mcp_config.json que se abre, depois salve.
4. Selecione o controle de atualização ao lado do servidor para recarregá-lo.

{
  "mcpServers": {
    "appsignal": {
      "serverUrl": "https://appsignal.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_TOKEN>"
      }
    }
  }
}

​

Zed

1. Abra Settings → AI → General → MCP servers → Configure, ou execute agent: open settings na paleta de comandos (Cmd+Shift+P) e selecione MCP servers.
2. Selecione Add server, depois Add remote server.
3. Informe appsignal como nome e https://appsignal.com/api/mcp como URL.
4. Se estiver usando um token em vez de OAuth, adicione um header Authorization.

{
  "context_servers": {
    "appsignal": {
      "url": "https://appsignal.com/api/mcp"
    }
  }
}

{
  "context_servers": {
    "appsignal": {
      "url": "https://appsignal.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_TOKEN>"
      }
    }
  }
}

​

VS Code

1. Execute MCP: Add Server na paleta de comandos (Cmd+Shift+P).
2. Escolha HTTP (HTTP or Server-Sent Events) como o tipo.
3. Informe https://appsignal.com/api/mcp como URL e appsignal como nome.
4. Escolha se quer salvar na configuração Workspace ou Global.

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

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

​

GitHub Copilot CLI

copilot mcp add appsignal https://appsignal.com/api/mcp

​

Gemini CLI

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

{
  "mcpServers": {
    "appsignal": {
      "httpUrl": "https://appsignal.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_MCP_TOKEN>"
      }
    }
  }
}

gemini mcp add --transport http appsignal https://appsignal.com/api/mcp

gemini mcp add --transport http appsignal https://appsignal.com/api/mcp \
  --header "Authorization: Bearer <YOUR_MCP_TOKEN>"

​

OpenAI Codex

codex mcp add appsignal --url https://appsignal.com/api/mcp

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

​

Verificar a conexão

• Claude Code: execute claude mcp list — o AppSignal deve aparecer como ✔ Connected. No Claude Code dentro do VS Code, execute /mcp para abrir a visualização de servidores MCP e confirmar que o connector aparece como conectado.
• Codex: execute codex mcp list. A coluna Auth mostra OAuth ou Bearer token para um servidor configurado corretamente. Dentro de uma sessão, /mcp lista os servidores conectados e suas tools.
• GitHub Copilot CLI: execute copilot mcp list — o AppSignal deve estar listado com o tipo http. Em uma sessão de terminal do GitHub Copilot, /mcp show appsignal deve, eventualmente, chegar a Status: Connected.
• Gemini CLI: execute /mcp list dentro de uma sessão. Se o AppSignal estiver faltando mesmo com uma configuração correta, verifique se você confiou na pasta.
• Zed: abra Settings → AI → MCP servers. O indicador ao lado de appsignal fica verde e seu tooltip mostra “Server is active”.
• VS Code: abra o Copilot Chat e selecione o ícone de tools. O VS Code inicia servidores MCP por demanda, então o AppSignal fica inativo até que algo o use.
• Cursor: abra a lista de MCPs nas configurações, onde appsignal aparece em Connected com um indicador verde e uma contagem de tools.
• Devin: abra o Cascade MCP marketplace, onde appsignal aparece em Installed como Enabled com sua contagem de tools.

​

Obtendo ajuda

• 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