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. 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 e uma versão completa em llms-full.txt. Cada página também existe em Markdown: troque o final do endereço por index.md.