> ## Documentation Index
> Fetch the complete documentation index at: https://devs.izap.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Analytics MCP

> Conecte um cliente de IA ou seu próprio código ao servidor iZap Analytics MCP.

O **servidor iZap Analytics MCP** expõe ferramentas de analytics e gerenciamento de
assistentes via **Streamable HTTP** em `{origin}/mcp`. Conecte o Claude, o ChatGPT ou
seu próprio agente e chame as ferramentas diretamente — com a mesma lógica de
negócio e autenticação da API REST.

| Ambiente | URL do MCP                        |
| -------- | --------------------------------- |
| Produção | `https://api.izap.ai/mcp`         |
| Staging  | `https://api-staging.izap.ai/mcp` |

## Conectar

A autenticação é OAuth 2.0 (clientes interativos a inicializam automaticamente) ou
um Bearer JWT para código servidor-a-servidor. Registre-o como um servidor MCP HTTP
remoto:

```json theme={null}
{
  "mcpServers": {
    "izap": {
      "type": "http",
      "url": "https://api.izap.ai/mcp",
      "headers": { "Authorization": "Bearer ${IZAP_TOKEN}" }
    }
  }
}
```

## Catálogo de ferramentas

Todas as ferramentas aceitam um `business_id` (UUID) opcional; omita-o para usar
sua primeira empresa.

| Ferramenta                         | Finalidade                                                    |
| ---------------------------------- | ------------------------------------------------------------- |
| `list_connected_assistants`        | Lista os assistentes de IA da conta                           |
| `get_today_message_stats`          | Contagens de chats / mensagens / pessoas únicas para uma data |
| `get_today_assistant_ratio`        | Proporção de mensagens IA-vs-humano para uma data             |
| `get_conversation_duration`        | Duração média/mínima/máxima de conversa para uma data         |
| `search_today_messages`            | Busca por palavra-chave nas mensagens de uma data             |
| `get_assistant_instructions`       | Lê o prompt e as instruções de um assistente                  |
| `create_ai_assistant`              | Cria um novo assistente                                       |
| `update_ai_assistant_instructions` | Atualiza o prompt/instruções de um assistente                 |

## Notas

* **Datas** são strings ISO-8601 (ex.: `2026-04-15`); **fuso horário** é um nome
  IANA (ex.: `America/Sao_Paulo`).
* `search_today_messages` tem limite de taxa por usuário, por dia.
* Erros de servidor aparecem como erros de ferramenta MCP (`isError: true`) com a
  mensagem `Error <status>: <detail>`; um `401` significa que o token deve ser
  renovado.

<Card title="Construa com o MCP no seu código" icon="code" href="/pt/api-reference/authentication">
  Obtenha um token e use o SDK MCP em Python ou TypeScript para chamar essas
  ferramentas a partir da sua própria aplicação ou agente.
</Card>