Aller au contenu

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.

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’outil

La référence complète, avec chaque paramètre, est sur la page Outils. En bref :

Domaine Outils
Publications et calendrier integrationSchedulePostTool (planifier, mettre en brouillon ou publier tout de suite), postsListTool, postMoveTool, postUpdateTool, postDeleteTool, findSlotTool, scheduleSlotsGetTool et scheduleSlotsSetTool (les créneaux)
Canaux integrationList, workspaceList, integrationSchema (les réglages et les règles d’une plateforme)
Médias et vidéo mediaList, uploadFromUrlTool, createUploadUrl et confirmUpload (un fichier de votre disque ou d’un sandbox d’IA), transcribe, cutVideo, splitVideoIntoStories, generateImageTool
Analyses videoPerformance (les vidéos comparées à âge égal), channelAnalyticsTool, analyticsHistoryTool
Tableau de contenus contentListTool, contentCreateTool, contentUpdateTool, contentDeleteTool
Inbox et commentaires (Instagram) inboxListTool, inboxReadTool, inboxSendTool, inboxPollTool, commentsListTool, commentActTool
Automatisations commentaire → DM automationList, automationManageTool, automationRunsTool
Webhooks webhooksListTool, webhookManageTool
Hooks (expérimental) hooksFormsTool, hooksSearchTool : la bibliothèque de vrais hooks qui alimente la chaîne vidéo
Divers notificationsListTool (la cloche de l’app)

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.

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.

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.

Utilisez l’endpoint /mcp avec votre clé API ou votre jeton OAuth comme jeton Bearer :

URL: https://app.usenadia.com/api/mcp
Authorization: Bearer your-api-key

Cette méthode accepte les clés API comme les jetons OAuth (préfixés par pos_).

L’URL de base est https://app.usenadia.com/api.

Voici à quoi ressemble un échange typique quand un agent IA utilise le MCP de UseNadia :

  1. L’agent appelle integrationList et récupère vos comptes connectés (Instagram, TikTok)
  2. L’agent appelle integrationSchema avec platform: "instagram-standalone" et apprend la limite de caractères, les réglages et les règles d’Instagram
  3. L’agent appelle integrationSchedulePostTool et 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.

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.