IA et MCP

Avec une clé API, ton IA lit les ventes, les modèles et les tournages de ton agence, et peut préparer des posts ou envoyer un rappel. Tu choisis ce qu'elle a le droit de faire.

Avant de commencer

• Le rôle Propriétaire ou Admin dans Velora.
• La double authentification active sur ton compte.
• Claude Desktop, Claude Code, Cursor ou un autre client MCP.

Créer la clé

1. Ouvre la page des clés. Dans la console, va dans Réglages puis Développeurs.
2. Clique sur Créer une clé. Donne-lui un nom qui dit où elle sert, par exemple Claude de Sarah.
3. Coche seulement ce qu'il faut. Pour poser des questions sur les chiffres, les droits de lecture suffisent. Coche « Envoyer des notifications » seulement si tu en as besoin.
4. Tape ton code de double authentification. La clé s'affiche une seule fois. Copie-la tout de suite et range-la dans ton gestionnaire de mots de passe.

Brancher ton IA

1. Note l'adresse du serveur MCP. Elle est affichée dans la console, sous Brancher une IA. Elle finit par /api/mcp.
2. Claude Code. Lance claude mcp add --transport http velora https://<domaine>/api/mcp --header "Authorization: Bearer vlr_live_…" puis tape /mcp pour vérifier.
3. Cursor. Ajoute un serveur dans ~/.cursor/mcp.json avec l'adresse dans url et ta clé dans headers, sous Authorization.
4. Claude Desktop. Dans Réglages › Développeur › Modifier la configuration, ajoute le relais mcp-remote avec l'en-tête Authorization. Redémarre Claude.
5. ChatGPT. Crée un GPT personnalisé, ajoute une Action, importe le schéma /api/v1/openapi.json, puis choisis Clé API de type Bearer.

Ce que tu peux demander

• « Combien a fait chaque modèle cette semaine, par plateforme ? »
• « Liste les tournages des 15 prochains jours. »
• « Prépare un post pour féliciter les modèles qui ont dépassé leur objectif. » Le post arrive en brouillon, tu le publies toi-même.
• « Rappelle à Lina son tournage de demain. » L'IA doit te montrer le message avant de l'envoyer.

Les garde-fous

• Une clé ne voit que ton agence, jamais une autre.
• Pas d'e-mail, de téléphone, de nom de fan ni de note interne par l'API.
• 50 notifications par jour au plus pour toute l'agence, en plus de tes heures calmes.
• Chaque envoi et chaque brouillon est noté dans le journal, avec la clé utilisée.
• Si l'admin qui a créé la clé quitte l'équipe, la clé s'arrête.

Si ça ne marche pas

• Erreur unauthorized → la clé est mal copiée, expirée ou révoquée. Crée-en une nouvelle.
• Erreur insufficient_scope → la clé n'a pas le droit demandé. Crée une clé avec ce droit coché.
• Erreur rate_limited ou notification_cap_reached → attends le nombre de secondes indiqué, ou demain pour les notifications.
• Erreur browser_not_allowed → l'appel part d'un navigateur. L'API ne répond qu'aux serveurs et aux applications.

Liens officiels

• Model Context Protocol
• Serveurs MCP dans Claude Code