Conectar via MCP

O servidor MCP expõe as operações do Media Ops como ferramentas para assistentes de IA. Endereço:

https://media.ops.infotrafego.com.br/api/mcp

Transporte Streamable HTTP (sem estado, respostas JSON). Autenticação por OAuth 2.1 — o assistente abre a tela de login do Media Ops e você aprova — ou por chave de API no cabeçalho, para clientes sem OAuth.

Conectar o seu cliente

Configurações → Conectores → Adicionar conector personalizado.
Nome: Media Ops; URL: o endereço acima.
Clique em Conectar, faça login no Media Ops e clique em Aprovar acesso.

claude mcp add --transport http media-ops https://media.ops.infotrafego.com.br/api/mcp

Na primeira chamada, rode /mcp e conclua o login. Para uso sem navegador (CI), use uma chave:

claude mcp add --transport http media-ops https://media.ops.infotrafego.com.br/api/mcp \
  --header "Authorization: Bearer $MEDIA_OPS_API_KEY"

Ferramentas

Campos de entrada, tipos e o equivalente REST de cada ferramenta estão na referência das ferramentas MCP (em inglês).

Ferramenta	O que faz	Permissão
`quem_sou_eu`	Usuário, papel, canal e permissões	—
`listar_clientes`	Clientes ativos	`clients:read`
`listar_bms`	BMs e ativos de um cliente (`business_manager_id`, contas, páginas, Instagram, pixels)	`clients:read`
`buscar_publicos`	Públicos personalizados, interesses, sugestões, localizações; validação de públicos	`meta:read`
`buscar_formularios`	Formulários de cadastro da página	`meta:read`
`buscar_publicacoes`	Publicações do Instagram	`meta:read`
`buscar_campanhas` / `buscar_conjuntos`	Campanhas e conjuntos existentes	`meta:read`
`escanear_pasta_drive`	Mídias de uma pasta do Google Drive	`meta:read`
`validar_campanha`	Simula a campanha com as regras da interface, sem criar nada	`campaigns:write`
`criar_campanha`	Cria (ou estende) a campanha — assíncrono	`campaigns:write`
`status_execucao` / `detalhar_execucao` / `listar_execucoes` / `logs_execucao`	Acompanhamento	`campaigns:read`
`reexecutar_execucao` / `reexecutar_log`	Reexecução inteligente / de uma chamada	`campaigns:write`
`criar_publicos_engajamento` / `status_publicos` / `listar_execucoes_publicos`	Públicos de engajamento	`audiences:*`
`listar_modelos_segmentacao` / `criar_…` / `renomear_…` / `remover_…`	Modelos de segmentação	`templates:*`
`listar_saldos` / `atualizar_saldos`	Saldo das contas	`balances:*`
`cadastrar_cliente` / `sincronizar_ativos_bm` / `ativar_desativar_conta` / `arquivar_cliente`	Clientes e BMs	`clients:write`
`listar_notificacoes`	Notificações	—
`listar_usuarios` / `criar_usuario` / `atualizar_usuario` / `remover_usuario`	Usuários (admins)	`admin:users`

No MCP, o assistente só enxerga as ferramentas que as suas permissões liberam.

Exemplo de conversa

"Crie no cliente Acme, conta principal, uma campanha de tráfego para https://acme.com.br com R$ 80/dia, usando os criativos da pasta do Drive X, público de São Paulo 25–45 anos."

O assistente segue o fluxo: listar_clientes → listar_bms → buscar_publicos (localização) → validar_campanha → criar_campanha → status_execucao. Os erros voltam em português, por campo, para que o próprio assistente corrija.

Tudo nasce pausado
As ferramentas que criam ou alteram algo pedem confirmação no cliente (dicas readOnlyHint/destructiveHint). Campanhas, conjuntos e anúncios são sempre criados PAUSADOS.