Permissions et limites

Cette page explique comment fonctionnent le contrôle d'accès, la limitation de débit et la gestion des erreurs pour l'intégration MCP Zenovay.

Périmètres OAuth

Lorsque vous autorisez un client MCP, vous choisissez des niveaux de permission pour chaque catégorie d'outils. Ils sont représentés sous forme de périmètres OAuth au format {catégorie}:{niveau}.

Niveaux de permission

Périmètres disponibles

Périmètres raccourcis :

• read — Toutes les catégories en niveau lecture
• write — Toutes les catégories en niveau écriture (inclut la lecture)

Outils protégés en écriture

Les outils suivants nécessitent une permission d'écriture pour leur catégorie. Si vous avez autorisé uniquement l'accès en lecture, ces outils retournent le code d'erreur -32007 :

Gestion (Écriture)

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

Paramètres (Écriture)

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

Avancé (Écriture)

create_uptime_check, delete_uptime_check

Webhooks (Écriture)

create_webhook, delete_webhook, test_webhook

Tous les autres outils fonctionnent avec l'accès en lecture.

Modification des permissions

Pour modifier les permissions accordées à un client MCP :

1. Révoquer le jeton existant — Allez à Paramètres → Sécurité → MCP, trouvez l'application connectée et révoquez-la
2. Réautoriser — Votre client MCP vous demandera à nouveau d'autoriser
3. Sélectionner de nouvelles permissions — Choisissez différents niveaux Lecture/Écriture sur la page de consentement

Fonctionnalités avec limite de plan

Certains outils sont liés à des fonctionnalités qui nécessitent des plans d'abonnement spécifiques :

L'appel d'un outil avec limite de plan sur un plan non supporté retourne le code d'erreur -32002.

Limites de conservation des données

Les requêtes d'analyse sont automatiquement limitées à la fenêtre de conservation de données de votre plan :

Limites de débit

Limite de requête quotidienne

Chaque équipe a un budget quotidien de requêtes MCP. Toutes les applications connectées partagent le même quota.

L'utilisation se réinitialise à 00:00 UTC chaque jour.

Coût de requête

Vérification de l'utilisation

Utilisez l'outil get_api_usage ou consultez Paramètres → Sécurité → MCP dans le tableau de bord :

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

Codes d'erreur

Erreurs JSON-RPC standard

Erreurs MCP Zenovay

Format de réponse d'erreur

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

Sécurité

OAuth 2.1 offre plusieurs avantages de sécurité par rapport aux clés API :

1. Aucun secret à gérer — Les jetons sont émis automatiquement, pas de clé à copier/coller
2. Périmètres granulaires — Accordez uniquement les permissions que chaque client nécessite
3. Expiration du jeton — Les jetons d'accès expirent après 1 heure et se renouvellent automatiquement
4. Révocation instantanée — Révoquez l'accès d'un client immédiatement depuis le tableau de bord
5. Protection PKCE — Les codes d'autorisation ne peuvent pas être interceptés
6. Piste d'audit — Voir quels clients sont connectés et quand ils ont fait leur dernière requête