Le serveur MCP de UseNadia
MCP (Model Context Protocol) permet à des agents IA d’agir directement sur UseNadia : lister les canaux, lire le calendrier, déplacer des publications, planifier, générer des images et des vidéos, et lire les vrais résultats de vos vidéos : le tout par une interface standard d’appel d’outils.
Vous pouvez donc connecter Claude, ChatGPT, Cursor ou n’importe quel client compatible MCP à votre compte UseNadia, et gérer vos réseaux sociaux en langage naturel.
Fonctionnement
Section intitulée « Fonctionnement »UseNadia expose un serveur MCP qui met 43 outils à la disposition des agents IA : un pour chaque opération de l’API publique qui a du sens dans une conversation, plus quelques-uns qui n’existent qu’ici (la chaîne vidéo). L’agent découvre ces outils, comprend leurs schémas et les appelle pour vous.
sequenceDiagram participant Agent as Agent IA participant MCP as Serveur MCP UseNadia participant UseNadia as Backend UseNadia
Agent->>MCP: Connexion avec clé API / jeton OAuth MCP-->>Agent: Liste des outils disponibles Agent->>MCP: Appel d’outil (ex. planifier une publication) MCP->>UseNadia: Exécution de l’action UseNadia-->>MCP: Résultat MCP-->>Agent: Réponse de l’outilOutils disponibles
Section intitulée « Outils disponibles »La référence complète, avec chaque paramètre, est sur la page Outils. En bref :
Tout ce qui touche d’autres personnes ou ne se défait pas (un DM, une
réponse publique, une automatisation, un webhook, une suppression) passe par
une confirmation : le premier appel rend
un aperçu et un jeton à usage unique, le second agit. Le texte écrit par
d’autres (DM, commentaires, transcriptions) revient entouré de balises
<untrusted> : ce sont des données, jamais des instructions.
Authentification
Section intitulée « Authentification »Le serveur MCP accepte deux façons de s’authentifier :
Votre clé API se trouve dans UseNadia, sous Paramètres → Développeurs, section Accès, à la ligne Clé API. Cliquez sur l’icône d’affichage pour la révéler, puis copiez-la. Elle se renouvelle au même endroit, et le renouvellement invalide l’ancienne clé aussitôt : mettez à jour en même temps tout ce qui s’en sert (scripts, n8n, clients MCP, la CLI).
Mettez-la directement dans l’URL de l’endpoint MCP, ou envoyez-la comme jeton Bearer.
Jeton OAuth
Section intitulée « Jeton OAuth »Si vous construisez une app pour d’autres utilisateurs de UseNadia, obtenez des jetons par OAuth2. Les jetons OAuth commencent par pos_ et s’utilisent comme des clés API.
Connexion
Section intitulée « Connexion »Utilisez l’endpoint /mcp avec votre clé API ou votre jeton OAuth comme jeton Bearer :
URL: https://app.usenadia.com/api/mcpAuthorization: Bearer your-api-keyCette méthode accepte les clés API comme les jetons OAuth (préfixés par pos_).
Utilisez l’endpoint /mcp/:apiKey, avec votre clé API dans l’URL :
URL: https://app.usenadia.com/api/mcp/your-api-keyL’URL de base est https://app.usenadia.com/api.
Exemple rapide
Section intitulée « Exemple rapide »Voici à quoi ressemble un échange typique quand un agent IA utilise le MCP de UseNadia :
- L’agent appelle
integrationListet récupère vos comptes connectés (Instagram, TikTok) - L’agent appelle
integrationSchemaavecplatform: "instagram-standalone"et apprend la limite de caractères, les réglages et les règles d’Instagram - L’agent appelle
integrationSchedulePostToolet planifie votre publication au bon format
Tout cela se fait seul quand vous dites à votre agent quelque chose comme :
« Programme ce reel sur Instagram demain à 10 h. »
Faut-il une clé OpenAI pour utiliser le MCP de UseNadia ?
Section intitulée « Faut-il une clé OpenAI pour utiliser le MCP de UseNadia ? »Non. Le serveur MCP ne fait qu’exposer les outils de UseNadia. C’est votre client IA (Claude, ChatGPT, Cursor, etc.) qui fournit le modèle.
Que se passe-t-il quand ma clé API expire ou est régénérée ?
Section intitulée « Que se passe-t-il quand ma clé API expire ou est régénérée ? »Les clés API de UseNadia ne se renouvellent pas d’elles-mêmes. Mais si vous en régénérez une dans Paramètres → API & MCP, chaque client MCP qui utilise l’ancienne cesse de marcher tant que sa configuration n’est pas à jour. Modifiez l’URL ou l’en-tête Authorization dans la configuration du client, puis reconnectez-le.
Comment l’endpoint MCP est-il exposé ?
Section intitulée « Comment l’endpoint MCP est-il exposé ? »Le serveur MCP démarre avec le backend de UseNadia et répond en HTTP streamable sur /mcp (authentification Bearer), /mcp/:apiKey (clé dans l’URL) et /mcp-oauth (protégé par OAuth). Un ancien transport SSE est gardé pour les clients plus anciens, sur /sse/:apiKey (le flux d’événements) et /message/:apiKey (là où le client envoie ses messages) ; les nouveaux clients doivent passer par le HTTP streamable.
Le MCP peut-il lire les commentaires ou y répondre ?
Section intitulée « Le MCP peut-il lire les commentaires ou y répondre ? »Oui. commentsListTool lit les publications, les stories en ligne et les
commentaires d’un canal Instagram ; commentActTool répond publiquement,
masque ou supprime un commentaire, avec la même étape de confirmation qu’un
message direct. Les automatisations commentaire → DM sont couvertes aussi :
automationList donne les id à mettre dans les réglages Instagram d’une
publication que vous planifiez, automationManageTool pose un template sur une
publication déjà en ligne, automationRunsTool liste les personnes qui l’ont
traversé (voir Outils).
UseNadia est pensé MCP d’abord : chaque opération de l’API publique est portée par un outil, ou laissée de côté exprès (connecter un canal par OAuth, les écritures des chaînes du cockpit, l’aperçu et le test de l’e-mail d’une étape « Transmettre l’e-mail », que fait l’éditeur de template). La correspondance est vérifiée à chaque version.
Les mêmes opérations existent dans l’API publique
(/automation-flows et /inbox) que la skill instagram-inbox du dépôt
appelle. Ou passez par l’Inbox de l’app.