Subscribr MCP

Connectez votre compte Subscribr payant à Claude, ChatGPT, OpenClaw, Cursor, VS Code et d'autres assistants IA via MCP. Accédez directement à votre tableau Projects, à vos Tasks, notifications, chaînes, scripts, idées, modèles, Voice Profiles et à la recherche Intel depuis la conversation.

Ce que cela fait

Subscribr prend en charge le Model Context Protocol (MCP), qui permet aux clients IA de se connecter de manière sécurisée à des outils et des données externes.

Une fois connecté, votre client IA peut :

• Lire les données de votre espace de travail Subscribr
• Rechercher des chaînes YouTube et des vidéos via Intel
• Ouvrir des MCP Apps riches pour les résultats Intel, les aperçus de scripts et le tableau Projects interactif
• Créer, mettre à jour, déplacer, promouvoir, commenter, archiver et restaurer des Projects lorsque votre rôle le permet
• Gérer des modèles personnalisés et valider un Voice Profile strict avant de le valider explicitement

Exemples de prompts :

• « Affiche-moi mes derniers scripts »
• « Recherche dans Intel des vidéos hors normes sur les entraînements à domicile »
• « Recherche @mkbhd et résume la chaîne »
• « Affiche mon tableau Projects et ce qui nécessite mon attention »

L'accès MCP est disponible pour toutes les équipes Subscribr payantes.

Par où commencer

Ouvrez AI Integrations depuis la navigation principale de l'application. Cette page vous fournit :

• L'URL de votre serveur MCP
• Des instructions de configuration spécifiques au client
• Des instructions de connexion OAuth-first
• Des notes avancées pour les clients manuels basés sur des jetons

Clients compatibles

Type de client	Style de configuration
Claude Desktop	Configuration OAuth guidée
Claude.ai	Configuration OAuth guidée
ChatGPT	Connecteur en mode développeur avec OAuth guidé
Cursor / VS Code	Configuration MCP HTTP distante avancée
OpenClaw	Pont MCP avancé ou configuration serveur distant
Autres clients MCP	Utilisez la même URL de serveur ; les étapes exactes varient selon le client

Configuration standard

Étape 1 : Ouvrir AI Integrations dans Subscribr

1. Connectez-vous à Subscribr
2. Ouvrez votre menu de compte et sélectionnez AI Integrations
3. Copiez l'URL de votre serveur MCP

L'URL du serveur de production est :

https://subscribr.ai/mcp/subscribr

Étape 2 : Ajouter Subscribr à votre client IA

Dans votre client IA, ajoutez un nouveau serveur MCP ou une nouvelle intégration et utilisez :

• Server URL : https://subscribr.ai/mcp/subscribr
• Transport : HTTP ou Streamable HTTP si le client le demande
• Auth : OAuth, si le client le prend en charge

Étape 3 : Terminer l'OAuth

La plupart des clients utilisateur finaux vous redirigeront automatiquement vers Subscribr.

1. Connectez-vous à Subscribr dans la fenêtre du navigateur
2. Approuvez la connexion MCP
3. Revenez à votre client IA
4. Démarrez une nouvelle conversation et utilisez les outils Subscribr

Notes par client

Claude Desktop

• Ajoutez une nouvelle intégration/serveur
• Collez l'URL MCP de Subscribr
• Terminez le flux d'autorisation dans le navigateur

Claude.ai

• Ouvrez Integrations
• Ajoutez l'URL MCP de Subscribr
• Terminez l'OAuth dans le navigateur

ChatGPT

• Ouvrez Settings → Apps & Connectors → Advanced settings
• Activez Developer mode, créez un connecteur et utilisez la même URL MCP
• Terminez l'OAuth dans le navigateur

Nous préparons Subscribr pour l'annuaire d'applications ChatGPT et l'annuaire Claude Connectors. En attendant l'approbation de ces listes, connectez-vous directement avec l'URL du serveur ci-dessus.

Cursor / VS Code

Ce sont des clients MCP plus orientés développeurs.

• Ajoutez un nouveau serveur MCP HTTP distant
• Utilisez l'URL MCP de Subscribr ci-dessus
• Choisissez HTTP ou Streamable HTTP si demandé
• Si le client prend en charge OAuth, utilisez-le
• Si le client ne prend en charge que les en-têtes bearer manuels, utilisez un jeton d'accès personnel à la place

OpenClaw

Les configurations OpenClaw varient plus que celles de Claude ou ChatGPT.

• Ajoutez Subscribr via votre pont MCP OpenClaw, plugin ou paramètres de serveur distant
• Utilisez la même URL MCP
• Privilégiez OAuth si votre configuration OpenClaw le prend en charge
• S'il ne prend en charge que l'authentification bearer manuelle, utilisez un jeton d'accès personnel à la place

Jetons d'accès personnels (avancé)

La plupart des clients n'ont pas besoin d'un jeton pour Claude, Claude.ai ou ChatGPT.

Les jetons sont uniquement destinés aux clients avancés ou aux flux de travail locaux qui ne prennent pas bien en charge OAuth.

Contraintes importantes :

• Les jetons sont gérés sur la page Developer
• Seuls les administrateurs d'équipe peuvent gérer les jetons
• La page Developer nécessite un plan avec API activée

Si votre client nécessite une authentification bearer manuelle, utilisez :

Authorization: Bearer YOUR_TOKEN_HERE

Outils disponibles

Subscribr expose un catalogue sémantique ciblé de 23 outils à /mcp/subscribr. Les outils de lecture produisant des apps sont séparés par forme de résultat afin que Claude et ChatGPT puissent sélectionner l'interface interactive correcte lors de la découverte des outils.

Projects et travail

Outil	Ce qu'il fait
list_projects	Lister/filtrer les Projects et lancer le tableau interactif
get_project	Récupérer un Project canonique basé sur une idée ou un Script
get_script_project	Récupérer un Project basé sur un Script et lancer son aperçu interactif
create_project	Créer un Project idée ou Script avec idempotence
update_project	Modifier, déplacer, prévisualiser/archiver ou restaurer un Project
promote_idea	Prévisualiser ou promouvoir une idée en Script lié sans génération
add_project_comment	Ajouter un commentaire de Project et des mentions limitées
list_my_work	Lister le travail assigné et les notifications de Project
mark_project_notifications_read	Marquer une, plusieurs ou toutes les notifications de Project comme lues

Recherche, opérations et espace de travail

Outil	Ce qu'il fait
search_youtube_channels	Rechercher des chaînes YouTube via Intel
search_youtube_videos	Rechercher des vidéos YouTube via Intel
get_youtube_channel	Rechercher une chaîne YouTube et afficher son app de détail
get_youtube_video	Rechercher une vidéo YouTube et afficher son app de détail
generate_ideas	Prévisualiser et lancer la génération asynchrone d'idées
get_operation	Interroger une opération durable renvoyée par Subscribr
get_channel_workspace	Lire le contexte limité de chaîne, concurrents, modèles et voix
list_research_videos	Parcourir les vidéos des chaînes suivies dans l'app vidéo interactive
get_research_video	Récupérer une vidéo suivie et afficher son app de détail
list_research_bookmarks	Parcourir les signets de chaînes et de vidéos enregistrés
save_bookmark	Enregistrer un signet de chaîne ou de vidéo Intel avec idempotence
save_template	Créer, mettre à jour, prévisualiser/archiver ou restaurer un modèle personnalisé
validate_voice_profile	Valider/canonicaliser un Voice Profile complet et émettre un reçu
commit_voice_profile	Valider explicitement le Voice Profile exact lié au reçu

Les actions destructrices ou coûteuses utilisent des reçus de prévisualisation puis de confirmation. Les écritures réessayées utilisent des clés d'idempotence et les écritures avec révision utilisent la dernière révision attendue.

Exemples de flux de travail

Recherche et idéation

1. Demandez : « Recherche dans Intel des vidéos hors normes sur la préparation des repas »
2. Demandez : « Recherche la meilleure chaîne de ces résultats »
3. Demandez : « Génère 5 idées pour ma chaîne inspirées de ce modèle »
4. Demandez : « Ajoute cette chaîne aux signets pour plus tard »

Révision de script

1. Demandez : « Affiche-moi mes scripts récents »
2. Demandez : « Ouvre le premier script »
3. Révisez le script avec votre assistant IA et demandez des retours ou des réécritures

Recherche concurrentielle

1. Demandez : « Recherche la chaîne YouTube @competitorhandle »
2. Demandez : « Recherche dans Intel des vidéos similaires à cette niche »
3. Demandez : « Résume ce qui distingue les meilleures vidéos hors normes »

Dépannage

« Je ne vois pas les outils Projects »

Vérifiez que la connexion utilise https://subscribr.ai/mcp/subscribr.

Si Subscribr était déjà connecté avant la publication des derniers outils, actualisez sa liste d'outils ou reconnectez-le, puis démarrez une nouvelle conversation.

« Je ne peux pas ajouter de signets ni générer d'idées »

Les actions d'écriture nécessitent un accès éditeur ou supérieur dans votre équipe.

« Le client indique qu'une authentification est requise »

C'est normal pour les clients compatibles OAuth. Terminez la connexion et le flux d'autorisation dans le navigateur.

« Mon client ne prend en charge que les en-têtes bearer manuels »

Utilisez un jeton d'accès personnel, mais uniquement si :

• votre équipe dispose d'un plan avec API activée
• un administrateur d'équipe peut créer le jeton pour vous

« Échec de la connexion »

Vérifiez :

1. Que l'URL du serveur est exactement https://subscribr.ai/mcp/subscribr
2. Que votre équipe est sur un plan payant
3. Que votre client utilise le MCP HTTP distant, et non le mode stdio local

Sécurité et confidentialité

• Toutes les données MCP sont limitées à votre compte Subscribr authentifié
• Vous ne pouvez accéder qu'aux données de votre propre équipe
• L'authentification par cookie de session n'est pas autorisée pour les requêtes MCP
• OAuth est privilégié car votre client IA ne reçoit jamais votre mot de passe
• Les jetons peuvent être révoqués à tout moment sur la page Developer

Compétence d'agent IA et CLI (Claude Code / Codex / Cursor / OpenClaw)

Si vous utilisez un agent de codage IA comme Claude Code, Codex, Cursor ou OpenClaw, vous pouvez installer un fichier de compétence qui apprend à l'agent à utiliser l'API REST Subscribr. La compétence couvre l'authentification, les points de terminaison, les flux de travail courants et des liens vers la référence complète de l'API.

Installez avec une seule commande depuis la racine de votre projet :

npx @giltotherescue/subscribr-cli

Cela installe la compétence dans .agents/skills/ (Codex, Cursor, OpenClaw) et .claude/skills/ (Claude Code). Le paquet npm inclut également un manifeste portable Agent Plugins pour les clients compatibles avec les plugins. Pour installer également la CLI Python sans dépendances :

npx @giltotherescue/subscribr-cli --with-cli

La CLI encapsule chaque point de terminaison de l'API Subscribr et est utile pour l'automatisation, les scripts et l'utilisation par les agents IA. Utilisez la CLI pour les travaux API déterministes ; utilisez MCP pour les flux de travail conversationnels Projects, espace de travail et Intel. Consultez le dépôt sur GitHub.

La compétence est axée sur l'API REST (plan Automation et supérieur), qui couvre l'ensemble de la plateforme, y compris la création de contenu, la génération de scripts, les exports et les webhooks. Elle documente également les outils MCP pour la recherche et l'idéation.

Vous la trouverez sur la page Developer de l'application, sous l'onglet Overview.

La compétence d'agent IA est destinée aux agents de codage qui appellent des API en votre nom. Pour les clients IA conversationnels comme Claude Desktop ou ChatGPT, utilisez plutôt la configuration MCP décrite ci-dessus.

MCP vs API REST

Le serveur MCP est conçu pour la recherche, l'idéation et la gestion des Projects/flux de travail dans les clients de chat IA. Le point de terminaison canonique fournit les flux de travail pris en charge pour les Projects, les Tasks/notifications, les modèles personnalisés et les Voice Profiles stricts, avec repli en texte seul et un tableau Projects intégré.

Pour la création de contenu — création de scripts, génération de plans, export de contenu, gestion des concurrents ou configuration de webhooks — utilisez l'API REST. L'API REST nécessite un plan Automation ou supérieur et est gérée sur la page Developer.

Prochaines étapes

• Ouvrez /ai-integrations dans Subscribr pour connecter votre client IA
• Installez la compétence d'agent IA pour Claude Code ou Codex
• Découvrez la recherche Intel
• Explorez Video Ideas
• Consultez la documentation de l'API pour un accès programmatique complet