Permissões e Limites

Esta página aborda como o controle de acesso, limitação de taxa e tratamento de erros funcionam para a integração Zenovay MCP.

Escopos OAuth

Quando você autoriza um cliente MCP, você escolhe níveis de permissão para cada categoria de ferramenta. Eles são representados como escopos OAuth no formato {categoria}:{nível}.

Níveis de Permissão

Escopos Disponíveis

Escopos abreviados:

• read — Todas as categorias em nível de leitura
• write — Todas as categorias em nível de escrita (inclui leitura)

Ferramentas Protegidas por Escrita

As seguintes ferramentas exigem permissão de Escrita para sua categoria. Se você autorizou com acesso somente leitura, essas ferramentas retornam o código de erro -32007:

Gerenciamento (Escrita)

create_goal, update_goal, delete_goal, toggle_goal, manage_funnel, delete_funnel, update_website_settings, toggle_public_dashboard, toggle_cookieless_tracking, regenerate_tracking_code, update_website_name, update_website_timezone, update_website_domain, pause_tracking, resume_tracking, schedule_report, cancel_report, create_api_key, delete_api_key, update_api_key_settings

Configurações (Escrita)

add_ip_exclusion, remove_ip_exclusion, add_path_exclusion, remove_path_exclusion, update_notification_settings, invite_team_member, remove_team_member, set_revenue_currency, add_allowed_domain, remove_allowed_domain, request_data_deletion

Avançado (Escrita)

create_uptime_check, delete_uptime_check

Webhooks (Escrita)

create_webhook, delete_webhook, test_webhook

Todas as outras ferramentas funcionam com acesso de leitura.

Alterando Permissões

Para alterar as permissões concedidas a um cliente MCP:

1. Revogar o token existente — Vá para Settings → Security → MCP, encontre o aplicativo conectado e revogue-o
2. Re-autorizar — Seu cliente MCP solicitará autorização novamente
3. Selecionar novas permissões — Escolha diferentes níveis de Leitura/Escrita na página de consentimento

Recursos com Limite de Plano

Certas ferramentas estão vinculadas a recursos que exigem planos de assinatura específicos:

Chamar uma ferramenta com limite de plano em um plano não suportado retorna o código de erro -32002.

Limites de Retenção de Dados

As consultas de análise são automaticamente limitadas à janela de retenção de dados do seu plano:

Limites de Taxa

Limite de Consultas Diárias

Cada equipe tem um orçamento diário de consultas MCP. Todos os aplicativos conectados compartilham a mesma cota.

O uso é redefinido às 00:00 UTC todos os dias.

Custo de Consulta

Verificando o Uso

Use a ferramenta get_api_usage ou verifique Settings → Security → MCP no painel:

{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
  "name": "get_api_usage",
  "arguments": {}
}
}

Códigos de Erro

Erros Padrão JSON-RPC

Erros do Zenovay MCP

Formato de Resposta de Erro

{
"jsonrpc": "2.0",
"id": 1,
"error": {
  "code": -32007,
  "message": "Tool 'create_goal' requires write permission for the 'management' category. Re-authorize with management:write scope."
}
}

Segurança

OAuth 2.1 oferece várias vantagens de segurança sobre chaves de API:

1. Sem segredos para gerenciar — Os tokens são emitidos automaticamente, sem necessidade de copiar/colar chave
2. Escopos granulares — Conceda apenas as permissões que cada cliente precisa
3. Expiração de token — Os tokens de acesso expiram após 1 hora e são atualizados automaticamente
4. Revogação instantânea — Revogue o acesso de um cliente imediatamente do painel
5. Proteção PKCE — Os códigos de autorização não podem ser interceptados
6. Trilha de auditoria — Veja quais clientes estão conectados e quando fizeram a última solicitação