Le Model Context Protocol (MCP) est la couche de connexion entre les clients IA (Claude Code, Cursor, assistants de bureau de type ChatGPT) et les outils externes. OmniGems livre un serveur MCP officiel pour que créateurs et opérateurs puissent piloter l'intégralité de leur pipeline d'influenceurs IA — agents, posts, génération de contenu, solde, workflows Camunda — depuis l'outil IA qu'ils utilisent déjà pour réfléchir et coder.
Ce guide est la configuration opérationnelle et la référence. Il couvre ce qu'expose le MCP OmniGems, le flux OAuth 2.1, les 16 outils (lecture + écriture), des workflows réels qui se cumulent, et la posture de sécurité que tout opérateur doit comprendre avant de pointer un nouveau client sur des données de production.
Pourquoi MCP pour les opérations d'influenceurs IA
Trois raisons pour lesquelles l'intégration MCP transforme le workflow quotidien sur OmniGems AI :
- Aucun changement de contexte. Les opérateurs vivent déjà dans Claude Code ou Cursor pour le prompt engineering, la recherche et le scripting de contenu. Ajouter « monitorer les agents », « mettre des posts en file » et « estimer le coût » comme outils dans l'éditeur élimine le va-et-vient entre onglets qui détruit la concentration.
- Opérations en langage naturel. « Montre-moi les trois posts les plus performants de l'agent @miami_condos cette semaine, puis programme une mise à jour marché pour lundi prochain » devient un seul tour de chat au lieu d'une traversée d'UI sur 6 écrans.
- Programmable depuis n'importe quel client. Claude Code aujourd'hui, Cursor aujourd'hui, ChatGPT desktop demain — les mêmes outils sont disponibles partout où MCP est supporté.
Pour le playbook complet sur les opérations d'influenceurs IA, voir How to Create an AI Influencer. Pour les agents de publication multi-plateforme, voir How AI Agents Post on Social Media.
Ce qu'expose OmniGems MCP
Le serveur parle la version de protocole MCP 2024-11-05 sur JSON-RPC 2.0 et enregistre 16 outils répartis sur deux scopes :
Scope lecture — mcp:read
| Outil | Ce qu'il fait |
|---|---|
| viral_list_agents | Liste vos agents (id, username, niveau, nombre de posts, tags) |
| viral_get_agent | Détails complets de l'agent y compris la config de persona |
| viral_list_posts | Liste les posts avec filtres ; tri par burns pour les top performers |
| viral_get_post | Post complet — texte, médias, plateformes, totaux de boost |
| viral_activity_daily | BURNS brûlés par boost sur 7 jours + nombre d'influenceurs actifs |
| viral_active_processes | Workflows viraux Camunda en cours pour un agent |
| viral_list_user_tasks | Tâches utilisateur en attente d'intervention humaine |
| viral_get_process_status | Snapshot du statut d'un processus Camunda spécifique |
| viral_get_balance | Solde actuel du compte et holdings BURNS |
| viral_estimate_cost | Estimation de coût pour une demande de génération de contenu |
| viral_parse_influencer_description | Convertit des prompts de persona libres en config structurée |
Scope écriture — mcp:write
| Outil | Ce qu'il fait |
|---|---|
| viral_cancel_process | Annule un workflow de génération en cours |
| viral_complete_user_task | Soumet une saisie à une tâche utilisateur en pause dans le workflow |
| viral_upload_media_from_url | Charge des images / vidéos de référence via URL |
| viral_create_influencer | Lance une nouvelle persona IA avec config complète |
| viral_start_content | Démarre la génération de contenu pour un agent |
Chaque outil renvoie à la fois un content[0].text lisible par humain et un structuredContent lisible par machine, de sorte que tout client — type chat ou agent de code — peut parser la réponse proprement.
Démarrage rapide : Claude Code
Le chemin le plus rapide. Depuis votre terminal :
claude mcp add --transport http omnigems https://app.omnigems.ai/api/mcp
Le premier appel ouvre un navigateur et vous guide à travers le flux OAuth :
- Login — connexion par wallet Web3 si vous n'êtes pas déjà authentifié
- Consentement — confirmez le scope (
mcp:read,mcp:read mcp:writesi des écritures sont demandées) - Échange de token — Claude Code stocke les tokens d'accès + refresh localement et les fait tourner automatiquement
Ensuite, chaque session Claude Code a accès aux outils OmniGems sans ré-authentification jusqu'à expiration du TTL de 30 jours du refresh token. Pour Cursor ou tout autre client MCP, l'URL est la même ; l'enregistrement est dynamique par RFC 7591, donc chaque client obtient son propre client_id.
Le flux d'auth OAuth 2.1 + PKCE
Le modèle d'authentification est volontairement strict parce que les tokens débloquent de l'argent réel — générations payantes, opérations de solde, agents de publication. Le flux complet :
| Étape | Endpoint | Spec |
|---|---|---|
| Discovery | GET /.well-known/oauth-authorization-server | RFC 8414 |
| Métadonnées de la ressource | GET /.well-known/oauth-protected-resource | RFC 9728 |
| Enregistrement dynamique de client | POST /api/oauth/register | RFC 7591 |
| Authorize (PKCE S256) | GET /api/oauth/authorize | OAuth 2.1 |
| Token / refresh | POST /api/oauth/token | OAuth 2.1 |
| Revocation | POST /api/oauth/revoke | RFC 7009 |
Détails qui comptent pour une revue de sécurité :
- Les access tokens sont des JWT (24 h) avec une claim
jti; la révocation écrit une entrée de denylist valide jusqu'à l'expiration naturelle du JWT. - Les refresh tokens sont opaques (back-end Redis, TTL 30 j) et rotated à l'usage. Réutiliser un ancien refresh token retourne
invalid_grant. - PKCE S256 est obligatoire. Les codes d'auth sont à usage unique, TTL 60 secondes.
- Clients publics uniquement —
token_endpoint_auth_method: "none". Aucun secret partagé à fuiter. - Loopback + HTTPS + private-use URI schemes sont les seuls patterns
redirect_uriacceptés. - L'enregistrement dynamique de clients est rate-limité à 20/h par IP.
- Les utilisateurs
is_block: truesont rejetés sur/authorizeet/api/mcp. - Limites de débit MCP : 120 requêtes/min par utilisateur globalement, 20/min spécifiquement pour les outils
mcp:write.
Cinq workflows qui se cumulent
Voici les patterns de workflow qui justifient de câbler le MCP à votre client quotidien. Tous fonctionnent dans Claude Code ; la plupart fonctionnent dans tout client compatible MCP.
1. Standup quotidien
« Montre-moi les 3 meilleurs posts d'hier sur l'ensemble de mes agents, les workflows en cours, et toute tâche utilisateur en attente. »
Trois appels d'outils — viral_activity_daily, viral_active_processes, viral_list_user_tasks — composés par le client IA en un rapport matinal unique.
2. Lancement de persona
« Crée une nouvelle persona IA pour la niche immobilière de Coral Gables, agent licenciée d'environ 35 ans, voix style podcast, anglais + espagnol. »
Le client convertit le format libre en config structurée via viral_parse_influencer_description, estime le coût via viral_estimate_cost, puis valide via viral_create_influencer. Trois appels d'outils, un seul tour de chat.
3. Lot de contenu
« Estime le coût de 10 clips short-form pour @luna_design puis mets-les en file avec des hooks basés sur le post le plus performant de la semaine. »
viral_get_post (top performer) → viral_estimate_cost → viral_start_content. Le client IA fournit les hooks ; le MCP fournit l'orchestration.
4. Garde-fous de coût
« Si mon solde tombe sous 1000 BURNS, annule toute génération long-form en cours et préviens-moi. »
viral_get_balance + viral_active_processes + viral_cancel_process. Câblez-le comme un hook Claude Code pour des vérifications périodiques.
5. Passage à un relecteur humain
« Liste toutes les tâches utilisateur en pause pour @miami_condos. Pour la plus ancienne, montre-moi les champs du formulaire, rédige une réponse dans ma voix, et soumets après mon approbation. »
viral_list_user_tasks → viral_get_process_status → viral_complete_user_task. Le client IA rédige ; l'humain approuve ; le MCP valide.
Pour l'économie BURNS plus large, voir BURNS Token Glossary. Pour la mécanique de tokenomics, voir Tokenomics Guide.
Architecture : comment les requêtes sont scopées
Chaque appel MCP est scopé à l'utilisateur authentifié. Les handlers d'outils ne transmettent pas le JWT de wallet de l'utilisateur aux services internes — ils appellent Flow API directement avec une clé système côté serveur plus le user_id extrait du bearer token vérifié. Les requêtes de chaque outil sont scopées à ce user_id / webapp_user_id côté serveur. Il n'existe aucun chemin où la session MCP d'un utilisateur pourrait lire les agents, posts ou solde d'un autre.
Le même scoping s'applique aux écritures — viral_create_influencer et viral_start_content créent toujours des ressources possédées par l'appelant ; viral_cancel_process ne réussit que pour des processus que l'appelant a initiés.
Construire votre propre workflow piloté par MCP
Le MCP est le plus utile quand vous arrêtez de l'utiliser comme remplacement chat du dashboard et commencez à l'utiliser comme un substrat programmable. Quelques patterns observés chez des créateurs :
- Moniteurs façon cron — une session Claude Code qui se réveille toutes les heures, exécute
viral_activity_daily+viral_get_balance, et vous ping uniquement quand un seuil est franchi - Portefeuilles de personas — un client IA gère 5 à 10 personas dans des sous-niches adjacentes via des commandes en langage naturel au lieu de cliquer 50 fois par jour dans un dashboard
- Coordination cross-client — Cursor pour les scripts de contenu + Claude Code pour les ops. Les deux s'authentifient au même serveur MCP avec leurs propres clients ; les agents et posts sous-jacents sont partagés
- Audits de conformité — un script one-shot qui tire chaque post publié via
viral_list_postset lance une vérification de divulgation contre une rubrique interne avant une revue régulatoire
Pour la couche de sélection de niche qui devrait se trouver au-dessus de chacun de ces workflows, voir Best AI Influencer Niches.
Roadmap
La version actuelle du protocole MCP 2024-11-05 est la base stable. Le serveur OmniGems est construit pour suivre la spec — les bumps de protocole arrivent d'abord en canary, puis passent en production dans les 2 semaines suivant la release. La surface d'outils croît chaque mois ; les ajouts récents (outils de scope écriture livrés fin 2025) couvrent la création de persona et le lancement de contenu, avec des plans pour des outils analytics-only et le partage à l'échelle de l'équipe dans les prochaines releases.
Si vous avez un outil spécifique à exposer, le flux de demande canonique consiste à ouvrir une issue contre la spec open-source de l'outil — l'équipe priorise par la demande et la clarté des contrats input/output.
Comment commencer
- Installez Claude Code, Cursor ou tout client compatible MCP
- Lancez
claude mcp add --transport http omnigems https://app.omnigems.ai/api/mcp(ou l'équivalent dans votre client) - Parcourez le flux OAuth — connectez-vous avec votre wallet Web3, approuvez les scopes demandés
- Essayez
tools/listpour voir les 16 outils que votre token peut invoquer - Commencez par
viral_activity_dailypour confirmer la connexion - Empilez des workflows à partir des patterns ci-dessus
Le MCP est le chemin le plus direct entre le client IA dans lequel vous pensez déjà et le pipeline d'influenceurs IA qui fait tourner votre business. Plus vous poussez vos opérations quotidiennes dans le même outil avec lequel vous raisonnez, plus tout se cumule rapidement.
À lire ensuite
- How to Create an AI Influencer — parcours complet de lancement
- How AI Agents Post on Social Media — agents de publication multi-plateforme
- Best AI Influencer Niches — framework de sélection de niche
- BURNS Token Glossary — l'économie du token derrière
viral_get_balanceetviral_estimate_cost - Tokenomics Guide — bonding curves et mécanique des holders