# Conecte seu cliente MCP

OAuth, seleção de site, permissões e revogação.

## Endereço e compatibilidade

Use a URL /mcp na origem API_PUBLIC_URL configurada neste ambiente. O servidor usa Streamable HTTP e o protocolo MCP 2026-07-28, com o SDK oficial v2. Clientes que implementam apenas o protocolo de 2025 não são compatíveis nesta implementação. Compatibilidade com aplicativos externos específicos ainda exige validação; uma configuração salva no cliente não comprova conexão.


## Autorizar um site

Cadastre a URL como servidor remoto em um cliente compatível com OAuth e PKCE S256. O cliente descobre a autoridade Better Auth da Pulsant; você entra com Google ou GitHub e escolhe um site. Confira o nome do cliente, workspace, site e permissões antes de autorizar. Não copie cookies, chaves privadas, códigos OAuth ou tokens para prompts. A conexão não permite trocar o site por parâmetros de ferramenta.


## Escolher permissões

analytics:read consulta tráfego e lista análises. revenue:read libera somente totais financeiros e canais, sem transações ou IDs de clientes. analytics:write permite criar metas, exige papel autorizado e não habilita pagamentos, exclusões ou alteração de planos. offline_access permite renovação do acesso; sem essa autorização, o cliente deve solicitar nova conexão após expirar. Apenas tráfego fica selecionado por padrão; nenhuma permissão extra é concedida por ser pedida pelo cliente.


## Ferramentas e recurso

traffic_overview aceita o contrato de período/filtros da API de analytics, com até 366 dias e 20 linhas por página. list_reports retorna até 20 metas/funis/segmentos com nextCursor. revenue_summary, quando autorizado, separa moedas e ambientes. create_goal exige requestKey UUID estável entre retries da mesma meta. pulsant://site descreve hostname e timezone do único site autorizado. Não existem ferramentas destrutivas neste servidor.

```
{"name":"create_goal","arguments":{"requestKey":"00000000-0000-4000-8000-000000000001","name":"Cadastro concluído","match":{"field":"event","value":"signup"}}}
```

## Limites e acesso atual

São permitidas até 60 requisições MCP por minuto por usuário e 64 KiB por requisição na API. Tokens expiram em 15 minutos; a renovação usa a autoridade OAuth da Pulsant. Cada operação verifica conexão, consentimento, sessão, conta, workspace, site, papel e escopos atuais no servidor. O limite de queries e o isolamento continuam válidos mesmo com um token emitido anteriormente. Consultas MCP e criação de metas não geram pageviews ou eventos faturáveis.


## Revogar e diagnosticar

Em Sua conta → Conexões MCP, revogue a conexão. Novas chamadas ficam bloqueadas; metas já criadas são preservadas. Sair da sessão usada na autorização, suspender a conta/workspace ou perder acesso ao site também impede novas chamadas. Um erro 401 inicia autenticação; 403 exige conferir permissões ou revogação; 429 pede aguardar o Retry-After. A conexão depende de API, dashboard, PostgreSQL, Redis e ClickHouse acessíveis no ambiente. Não envie tokens nos relatórios de falha.


## Descoberta segura

A autoridade publica /.well-known/oauth-authorization-server/api/auth; a API publica /.well-known/oauth-protected-resource/mcp. Produção exige HTTPS e origens públicas acessíveis ao cliente. CIMD usa o transporte oficial com bloqueio de endereços privados, DNS fixado e sem seguir redirects. DCR é habilitado explicitamente como fallback para registro público com PKCE; registro de cliente não equivale a autorização de dados.