# API pública e MCP

> Ler pedidos, receita, margem, tracking, anúncios e criativos por planilhas, BI e assistentes de IA.

## Chaves

Em **Configurações → API pública**, crie uma chave com nome, escopos e validade (até 365 dias). A chave aparece uma vez só. Ela para de funcionar se vencer, se for revogada ou se a pessoa que a criou sair da organização ou perder a permissão.

| Escopo | Lê |
| --- | --- |
| `orders:read` | pedidos |
| `revenue:read` | receita |
| `profit:read` | margem estimada |
| `tracking:read` | saúde do tracking |
| `ads:read` | resumo de anúncios |
| `creatives:read` | criativos |

## Endpoints

Todos com `Authorization: Bearer <chave>`:

| Método e caminho | Escopo |
| --- | --- |
| `GET /api/v1/orders` | `orders:read` |
| `GET /api/v1/revenue` | `revenue:read` |
| `GET /api/v1/profit` | `profit:read` |
| `GET /api/v1/tracking/health` | `tracking:read` |
| `GET /api/v1/ads/overview` | `ads:read` |
| `GET /api/v1/creatives` | `creatives:read` |

A especificação completa está em [OpenAPI](https://app.momentummidia.com/api/v1/openapi.json). O endereço base é `https://app.momentummidia.com`.

## MCP (assistentes de IA)

A mesma chave conecta assistentes compatíveis com o Model Context Protocol (Claude, ChatGPT e outros) ao servidor MCP da Momentum:

```
URL: https://app.momentummidia.com/api/mcp
Cabeçalho: Authorization: Bearer <chave>
```

O assistente passa a ler os mesmos dados dos escopos da chave. Ele não consegue alterar nada.

## Para IAs: llms.txt

Esta documentação tem um [llms.txt](/llms.txt) e uma versão completa em [llms-full.txt](/llms-full.txt). Cada página também existe em Markdown: troque o final do endereço por `index.md`.