MCP da owiew

Hoje não existe um servidor MCP da owiew. Nenhum produto da owiew publica um servidor do Model Context Protocol, então não há nada para instalar nem endereço para configurar em Claude Desktop, Cursor ou outro cliente MCP. Esta página diz o que você pode fazer agora para obter o mesmo resultado e o que o MCP da owiew deve oferecer quando existir.

O que você precisa

Uma chave de API somente leitura, criada por quem administra o cliente na owiew.
A especificação OpenAPI da API de leitura: /openapi.json.
As instruções desta seção, que você cola no início da conversa ou no prompt de sistema do agente.

O que dá para fazer hoje

A API de leitura já descreve todas as rotas em OpenAPI. Um agente que recebe essa especificação, uma forma de chamar HTTP e as regras desta seção consegue ler contas, campanhas e conversões. Há dois caminhos.

Caminho 1: ferramenta HTTP em Claude (tool use via API)

Você define uma ferramenta e o seu código executa a chamada. A chave nunca entra no prompt: ela fica no ambiente do seu código, que troca a chave por um token e chama a owiew. Veja a regra completa em Segurança com agentes.

Definição da ferramenta, enviada no campo tools da requisição à Messages API:

{
  "name": "ler_api_owiew",
  "description": "Lê dados da API de leitura da owiew. Use somente os caminhos permitidos. Valores terminados em _micros estão em micros: divida por 1.000.000 com aritmética inteira. Nunca invente identificadores: use os que a própria API devolveu.",
  "input_schema": {
    "type": "object",
    "properties": {
      "recurso": {
        "type": "string",
        "enum": ["summary", "campaigns", "accounts", "conversions", "audit/revisions", "pacing"]
      },
      "since": { "type": "string", "description": "Primeiro dia, AAAA-MM-DD." },
      "until": { "type": "string", "description": "Último dia, AAAA-MM-DD, inclusivo." }
    },
    "required": ["recurso"]
  }
}

Requisição à Messages API (exemplo; troque MODELO pelo identificador do modelo que você usa):

curl -s https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "MODELO",
    "max_tokens": 2048,
    "system": "Você lê a API de leitura da owiew. Siga as regras de https://developers.owiew.com/ia/.",
    "tools": [ ...a definição acima... ],
    "messages": [
      { "role": "user", "content": "Quanto gastamos por campanha em setembro de 2026?" }
    ]
  }'

Quando a resposta trouxer um bloco tool_use com name: "ler_api_owiew", o seu código faz o seguinte:

Troca a chave por um token em POST /v1/token (o token dura dois minutos).
Monta GET /v1/t/{tenantID}/{recurso}?since=...&until=... com o tenant_id devolvido pela troca, nunca um valor vindo do modelo.
Devolve o JSON da resposta em um bloco tool_result.

Valide o recurso contra a lista permitida antes de montar a URL. Assim o modelo não escolhe caminhos que você não previu.

Caminho 2: cliente MCP com um servidor MCP de OpenAPI de terceiros

Existe um servidor MCP genérico que transforma qualquer OpenAPI em ferramentas MCP: @ivotoby/openapi-mcp-server. Dados conferidos no registro do npm em 28/10/2026:

Item	Valor
Pacote	`@ivotoby/openapi-mcp-server`
Versão	1.16.1
Licença	MIT
Última publicação	junho de 2026
Repositório	`github.com/ivo-toby/mcp-openapi-server`

Ele é mantido por terceiros e não tem relação com a owiew. Ele recebe a base da API, o endereço da especificação e cabeçalhos fixos por variáveis de ambiente (API_BASE_URL, OPENAPI_SPEC_PATH, API_HEADERS).

Limite importante. Os cabeçalhos desse servidor são fixos. O token da owiew vale dois minutos e a chave de API só serve para pedir o token, então um cabeçalho Authorization fixo deixa de funcionar logo depois. Use esse caminho apenas se você colocar entre o servidor e a owiew um proxy seu que faça a troca da chave por token a cada requisição. Sem esse proxy, prefira o caminho 1.

O que o MCP da owiew vai oferecer

Não disponível. Esta seção descreve a intenção, sem compromisso nem data.

Ler contas de anúncio e o frescor do dado.
Ler campanhas e desempenho por período.
Servir esta documentação ao agente.

O servidor seguiria as mesmas regras da API de leitura: somente leitura, escopo por cliente e token de vida curta.

Se algo der errado

A API responde 401. O token venceu ou a chave expirou. Peça um token novo; se a troca também falhar, peça uma chave nova a quem administra o cliente.
A API responde 403. O token é de outro cliente ou o papel não inclui a rota. Confira o tenant_id devolvido pela troca.
O agente inventa um identificador. Reforce a instrução: só usar identificadores devolvidos pela API.