Permisos y límites

Esta página cubre cómo funcionan el control de acceso, la limitación de velocidad y el manejo de errores para la integración MCP de Zenovay.

Alcances de OAuth

Cuando autorizas un cliente MCP, eliges niveles de permiso para cada categoría de herramientas. Estos se representan como alcances de OAuth en el formato {categoría}:{nivel}.

Niveles de permiso

Alcances disponibles

Alcances abreviados:

• read — Todas las categorías en nivel de lectura
• write — Todas las categorías en nivel de escritura (incluye lectura)

Herramientas protegidas contra escritura

Las siguientes herramientas requieren permiso de Escritura para su categoría. Si autorizaste con acceso de solo lectura, estas herramientas devuelven el código de error -32007:

Gestión (Escritura)

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

Configuración (Escritura)

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

Avanzado (Escritura)

create_uptime_check, delete_uptime_check

Webhooks (Escritura)

create_webhook, delete_webhook, test_webhook

Todas las demás herramientas funcionan con acceso de lectura.

Cambiar permisos

Para cambiar los permisos otorgados a un cliente MCP:

1. Revocar el token existente — Ve a Settings → Security → MCP, encuentra la aplicación conectada y revócalo
2. Re-autorizar — Tu cliente MCP solicitará autorización nuevamente
3. Seleccionar nuevos permisos — Elige diferentes niveles de Lectura/Escritura en la página de consentimiento

Características con acceso restringido por plan

Ciertas herramientas están vinculadas a características que requieren planes de suscripción específicos:

Llamar a una herramienta con acceso restringido por plan en un plan no compatible devuelve el código de error -32002.

Límites de retención de datos

Las consultas de análisis se ajustan automáticamente a la ventana de retención de datos de tu plan:

Límites de velocidad

Límite de consultas diarias

Cada equipo tiene un presupuesto de consultas MCP diarias. Todas las aplicaciones conectadas comparten la misma cuota.

El uso se reinicia a las 00:00 UTC cada día.

Costo de consulta

Verificar uso

Usa la herramienta get_api_usage o ve a Settings → Security → MCP en el panel:

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

Códigos de error

Errores estándar de JSON-RPC

Errores de MCP de Zenovay

Formato de respuesta de error

{
"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."
}
}

Seguridad

OAuth 2.1 proporciona varias ventajas de seguridad sobre las claves de API:

1. Sin secretos que gestionar — Los tokens se emiten automáticamente, sin clave que copiar/pegar
2. Alcances granulares — Otorga solo los permisos que necesita cada cliente
3. Expiración de token — Los tokens de acceso caducan después de 1 hora y se actualizan automáticamente
4. Revocación instantánea — Revoca el acceso de un cliente inmediatamente desde el panel
5. Protección PKCE — Los códigos de autorización no pueden ser interceptados
6. Pista de auditoría — Ve qué clientes están conectados y cuándo hicieron solicitudes por última vez