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

# Metrito no Claude e no ChatGPT

> Conecte o Metrito ao seu assistente de IA e pergunte sobre campanhas, criativos e vendas em português

Conecte o Metrito ao Claude, ao ChatGPT ou a qualquer cliente compatível com MCP (Model Context Protocol) e pergunte sobre seus dados em português. O assistente lê gasto, vendas atribuídas, criativos e funil direto do seu projeto e responde com tabelas. No Claude e no ChatGPT, a resposta vem como um painel visual.

```
https://api.metrito.com/mcp
```

## O que você pode perguntar

* "Quais anúncios tão dando mais resultado nos últimos 3 meses?"
* "Onde eu tô perdendo venda?"
* "O que mudou essa semana comparado com a anterior?"
* "Me mostra o funil da campanha de Black Friday."
* "Quanto eu gastei em criativo que não vendeu nada em outubro?"

Você não precisa saber o nome de nenhuma ferramenta. O assistente escolhe sozinho qual consulta fazer.

***

## Conectar

> [tab] Claude
>
> **1. Abra os conectores**
>
> No [claude.ai](https://claude.ai) ou no Claude Desktop, abra **Configurações** e vá em **Conectores**.
>
> **2. Adicione o Metrito**
>
> Clique em **Adicionar conector personalizado**, dê o nome **Metrito** e cole a URL `https://api.metrito.com/mcp`.
>
> **3. Autorize**
>
> Clique em **Conectar**. Você vai para a tela do Metrito: faça login, escolha a workspace e clique em **Autorizar acesso**.

> [tab] ChatGPT
>
> **1. Ative o modo de desenvolvedor**
>
> No ChatGPT, abra **Configurações**, vá em **Aplicativos e conectores** e, em **Avançado**, ative o **Modo de desenvolvedor**.
>
> **2. Crie o conector**
>
> Em **Aplicativos e conectores**, clique em **Criar**, dê o nome **Metrito**, cole a URL `https://api.metrito.com/mcp` e escolha autenticação **OAuth**.
>
> **3. Autorize**
>
> Faça login no Metrito, escolha a workspace e clique em **Autorizar acesso**. Depois, ative o Metrito na conversa pelo botão **+**.

> [tab] Claude Code
>
> No terminal:
>
> ```bash theme={null}
> claude mcp add --transport http metrito https://api.metrito.com/mcp
> ```
>
> Depois, dentro do `claude`, rode `/mcp`, escolha **metrito** e faça login no navegador.

> [tab] Outros clientes
>
> Clientes que aceitam OAuth (Cursor, VS Code, Goose e outros) só precisam da URL `https://api.metrito.com/mcp`.
>
> Para automações sem login, use uma [API Key](https://docs.metrito.com/api-reference/authentication.md) com o escopo `data:read` no cabeçalho:
>
> ```json theme={null}
> {
>   "mcpServers": {
>     "metrito": {
>       "type": "http",
>       "url": "https://api.metrito.com/mcp",
>       "headers": { "Authorization": "Bearer mtk_live_SUA_CHAVE" }
>     }
>   }
> }
> ```

> [!NOTE]
>
> O assistente só enxerga a workspace que você autorizou. Para consultar outra workspace, conecte de novo escolhendo a outra.

***

## Ferramentas

### Análise

| Ferramenta | Para que serve |
| - | - |
| `top_creatives` | Melhores criativos por ROAS e piores por gasto sem retorno, com miniatura. |
| `creative_report` | Gasto, vendas, CTR, hook e retenção por criativo, somando os anúncios da mesma peça. |
| `campaign_funnel` | Funil de impressão até venda, da campanha ou do projeto inteiro. |
| `what_changed` | O que mudou contra o período anterior: hoje, ontem, 7 ou 30 dias. |
| `find_bottleneck` | A etapa do funil que mais piorou contra o histórico da própria conta. |

### Consulta

| Ferramenta | Para que serve |
| - | - |
| `list_projects` | Projetos da workspace, com logo. |
| `get_project_info` | Moeda, fuso e integrações do projeto. |
| `list_connections` | Contas de anúncio, checkouts e WhatsApp conectados. |
| `list_fields` | Métricas e dimensões disponíveis. |
| `query_metrics` | Consulta livre, por período, campanha, conjunto ou anúncio. |

### Ação

| Ferramenta | Para que serve |
| - | - |
| `update_ad_objects` | Pausa, ativa ou muda orçamento de campanhas, conjuntos e anúncios. |

> [!WARNING]
>
> `update_ad_objects` mexe em campanha no ar e precisa do escopo `data:write`. O Claude e o ChatGPT costumam pedir sua confirmação antes de usá-la. Confira o que vai mudar antes de aprovar.

***

## Como ler as respostas

* **Vendas atribuídas:** só contam as vendas que o Metrito ligou a um anúncio. O painel mostra também o total de vendas do projeto, para você ver quanto ficou sem atribuição.
* **Amostra baixa:** linhas com menos de 3 mil impressões ou 100 cliques aparecem marcadas. Leia como sinal inicial, não como veredito.
* **Dado parcial:** se o período pedido começa antes dos dados de anúncio do projeto, a resposta avisa. Gasto que falta não é gasto zero.
* **Criativo sem venda:** não desligue só por isso. Anúncio também ajuda outros a vender. Olhe a campanha antes.

***

## Segurança

* O acesso é por workspace. Uma conexão nunca lê projetos de outra workspace.
* As ferramentas de análise e consulta só leem dados.
* Para revogar o acesso, remova o conector no seu assistente e apague a chave em **Configurações > Chaves de API** no Metrito.


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