> ## 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 para agentes de IA

> Dê a agentes de IA e assistentes de codificação acesso aos seus dados do AppSignal através do servidor MCP ou da CLI.

Seus dados de monitoramento são mais úteis onde você já está trabalhando. O AppSignal MCP conecta agentes de IA e editores diretamente aos seus dados, e a AppSignal CLI leva os mesmos dados para o seu terminal, com saída legível por máquina para os agentes consumirem.

<CardGroup cols={2}>
  <Card title="AppSignal MCP" icon="plug" href="/mcp-server">
    Conecte o Claude, Cursor, Windsurf, Zed, VS Code ou GitHub Copilot aos seus erros, traces, logs e métricas.
  </Card>

  <Card title="AppSignal CLI" icon="terminal" href="/cli">
    Acompanhe logs, inspecione incidentes e gerencie triggers a partir do seu shell, em saída legível por humanos ou JSON.
  </Card>
</CardGroup>

<h2 id="which-one-to-use">
  Qual usar
</h2>

Ambos alcançam os mesmos dados. Eles diferem na forma como o agente se comunica com o AppSignal.

* **MCP** é um endpoint HTTP hospedado em `https://appsignal.com/api/mcp`. Configure seu editor ou app de chat nele uma vez, e o agente consulta o AppSignal diretamente, sem etapa de instalação. Veja [Configurar o AppSignal MCP](/mcp/setup) para sua ferramenta e a [Referência de ferramentas do MCP](/mcp/reference) para o que ele expõe.
* **A CLI** é um binário único que você mesmo executa. Os agentes a operam executando comandos e lendo `--output json`. Use-a quando quiser que o agente trabalhe no mesmo shell dos seus testes e deploys, ou quando o ambiente restringir o tráfego de saída.

<h2 id="teach-your-agent-the-cli">
  Ensine a CLI ao seu agente
</h2>

A CLI inclui uma habilidade de agente: um conjunto de instruções que ensina o Claude, Codex ou OpenCode quando recorrer ao `appsignal-cli` e como ler sua saída.

```sh Shell theme={null}
appsignal-cli skill install
```

Veja a página [Habilidade do agente](/cli/skill) para saber o que ela instala e como mantê-la atualizada.

<h2 id="what-agents-can-reach">
  O que os agentes conseguem alcançar
</h2>

As duas superfícies leem os dados que o AppSignal já tem. Se sua aplicação não está enviando logs, um agente não pode consultá-los.

* Erros e incidentes de exceção
* Incidentes de performance e traces
* Logs, incluindo views salvas e métricas derivadas de log
* Métricas e dashboards
* Triggers de Anomaly detection
* Aplicações, namespaces e deploy markers

<Note>
  Um agente usando MCP ou a CLI age como você, com seu acesso aos dados da sua organização. Autentique a [CLI](/cli/authentication) na máquina onde o agente é executado, e trate o acesso MCP da mesma forma que trata o seu próprio.
</Note>

<h2 id="building-your-own-integration">
  Construindo sua própria integração
</h2>

Se você quiser consultar ou enviar dados a partir do seu próprio código em vez de um agente, use a [API do AppSignal](/api).

<h2 id="documentation-an-agent-can-read">
  Documentação que um agente pode ler
</h2>

Todas as páginas aqui são servidas como Markdown simples em sua URL com a extensão `.md`, para que um agente possa ler a documentação tanto quanto os dados.

Os [tutoriais de Ruby e Rails](/tutorials), produzidos com o GoRails, são escritos para os dois públicos: passo a passo do framework com requisitos em tabelas, etapas em ordem e um resultado explícito para cada etapa. Eles documentam o Rails, não o AppSignal. Esse é o contexto que um agente lendo uma métrica de uma aplicação Rails não tem de outra forma.

Se você quiser que sua própria aplicação responda em Markdown, o [tutorial de renderização de Markdown](/tutorials/ruby/markdown-renderer) aborda o tipo MIME `text/markdown` que o Rails 8.1 adicionou.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.