Assistants IA (MCP)

MCP (Model Context Protocol) est le standard ouvert qui permet aux assistants IA de se connecter à d’autres applications. Vous ajoutez une adresse dans votre assistant, vous validez la connexion une fois, puis vous demandez votre travail SEO et éditorial directement dans le chat que vous utilisez déjà. Pour un aperçu de ce que cela vous apporte, consultez la page Serveur MCP Semurai.

Ce que vous pouvez faire

Écrivez avec vos propres mots. L’assistant choisit les bonnes actions dans Semurai, travaille dans votre espace de travail et vous dit ce qu’il a fait. Quelques exemples par domaine :

Recherche SEO

Recherche de mots-clés et de mots-clés associés, analyse de la concurrence et écarts de mots-clés, qui se positionne sur une requête, vue d’ensemble d’un domaine, vérification des positions en direct et clusters thématiques. Plus d’infos dans Recherche de mots-clés.

• Trouve des mots-clés de longue traîne sur le cold brew avec une faible difficulté.
• Sur quels mots-clés mes concurrents se positionnent-ils et pas nous ?
• Construis un cluster thématique autour de l’espresso à la maison.

Positions et Search Console

Mots-clés suivis et historique de leurs positions, nouveaux mots-clés à suivre, rapports Google Search Console (vue d’ensemble, meilleures requêtes, meilleures pages, tendances des requêtes et opportunités), audits de pages, audits complets du site et rapports de performance.

• Comment ont évolué nos mots-clés suivis ce mois-ci ?
• Montre les requêtes Search Console avec beaucoup d’impressions et un CTR faible.
• Fais un audit SEO complet de notre site et liste les corrections les plus importantes.

Contenus

Rechercher et lire vos articles et documents, créer des plans, rédiger des articles SEO avec des emplacements d’images, mettre à jour des contenus, créer des documents et des brouillons d’e-mails, planifier contenus et campagnes, trouver des temps forts marketing et obtenir des suggestions de liens internes.

• Rédige un article SEO sur le choix d’un moulin à café, à partir de notre recherche de mots-clés.
• Planifie un mois de contenus de blog pour notre boutique.
• Suggère des liens internes pour l’article sur les machines à espresso.

Réseaux sociaux et calendrier

Brouillons de posts pour les réseaux sociaux (texte), liste de vos posts, calendrier éditorial et programmation des contenus et des posts.

• Rédige trois posts LinkedIn pour promouvoir notre dernier article.
• Qu’est-ce qui est prévu dans le calendrier éditorial la semaine prochaine ?
• Programme le post LinkedIn sur le mélange d’automne pour vendredi à 9 h.

Publication

Publiez des articles sur WordPress, PrestaShop ou le blog Shoper. Sur WordPress, l’assistant peut aussi examiner les articles et préparer, appliquer ou annuler des modifications SEO.

• Publie l’article sur les moulins à café sur notre blog Shoper.
• Vérifie le SEO de nos cinq derniers articles WordPress et prépare des corrections.

E-commerce

Travaillez avec vos boutiques Shoper, WooCommerce et PrestaShop connectées : recherche de produits et de catégories, propositions SEO pour les produits, les catégories et les textes alternatifs des images, application des propositions validées et import des produits Shoper. Plus d’infos dans Boutique.

• Trouve les produits sans meta description et prépare des propositions SEO.
• Rédige les textes alternatifs des images de la catégorie Moulins.
• Applique à la boutique les propositions validées.

Médias et tâches

Recherchez dans la médiathèque, ajoutez des médias depuis une URL, modifiez leurs informations et organisez les dossiers. Listez, créez et modifiez des tâches, et confiez une tâche à l’un des agents Semurai.

• Déplace les photos produits de la semaine dernière dans un dossier Campagne de printemps.
• Crée une tâche pour actualiser l’article sur les prix et confie-la à Tenko.

Connecter votre assistant

Tous les assistants utilisent la même adresse de serveur. Copiez-la et suivez les étapes de votre assistant. La même adresse et des instructions courtes se trouvent dans l’application Semurai, sous Paramètres → Assistants IA (MCP).

https://api.semur.ai/mcp

Claude (web et application de bureau)

1. Dans Claude, ouvrez Customize → Connectors.
2. Cliquez sur + Add et choisissez Add custom connector.
3. Saisissez un nom, par exemple Semurai, collez l’adresse du serveur et cliquez sur Continue, puis sur Add.
4. Cliquez sur Connect et validez la connexion sur la page Semurai.

Avec les offres Claude Team et Enterprise, un Owner de l’organisation ajoute le connecteur une seule fois dans Organization settings → Connectors → Add → Custom → Web. Les membres cliquent ensuite sur Connect et se connectent à leur propre compte Semurai. Avec l’offre Free, vous pouvez ajouter un connecteur personnalisé. Ce que Claude peut faire avec Semurai, avec des exemples de prompts : Claude pour le SEO.

ChatGPT

1. Dans ChatGPT sur le web, ouvrez Plugins et cliquez sur +.
2. Choisissez Add custom MCP server, saisissez un nom et collez l’adresse du serveur.
3. Pour l’authentification, choisissez OAuth, cochez I understand and want to continue et cliquez sur Create.
4. Validez la connexion sur la page Semurai.

Actions complètes (écriture) dans ChatGPT : offres Business, Enterprise et Edu. Avec Pro, les serveurs MCP personnalisés se connectent en lecture seule. Les serveurs MCP personnalisés s’ajoutent dans ChatGPT sur le web. Cas d’usage et prompts à essayer : ChatGPT pour le SEO.

Claude Code

Exécutez cette commande dans votre terminal :

claude mcp add --transport http --scope user semurai https://api.semur.ai/mcp

L’option --scope user ajoute Semurai à tous vos projets. Connectez-vous ensuite à Semurai avec claude mcp login semurai, ou tapez /mcp dans Claude Code. Le SEO depuis le terminal, avec des exemples : Claude Code pour le SEO.

Codex

Exécutez cette commande dans votre terminal :

codex mcp add semurai --url https://api.semur.ai/mcp

Connectez-vous ensuite à Semurai avec codex mcp login semurai. Vous pouvez aussi ajouter le serveur dans ~/.codex/config.toml :

[mcp_servers.semurai]
url = "https://api.semur.ai/mcp"

L’extension Codex pour IDE et l’application de bureau Codex utilisent la même configuration. Vous pouvez aussi y ajouter le serveur dans Settings → MCP servers → Add server, avec le type Streamable HTTP. Pour en savoir plus sur Semurai dans Codex : Codex MCP.

Cursor

Ajoutez le serveur à ~/.cursor/mcp.json pour l’utiliser dans tous vos projets, ou à .cursor/mcp.json dans un seul projet :

{
  "mcpServers": {
    "semurai": {
      "url": "https://api.semur.ai/mcp"
    }
  }
}

Connectez-vous à Semurai lorsque Cursor vous le demande. Ce que vous pouvez demander dans Cursor : Cursor MCP.

VS Code (GitHub Copilot)

En mode agent, GitHub Copilot utilise les serveurs de .vscode/mcp.json dans votre projet :

{
  "servers": {
    "semurai": {
      "type": "http",
      "url": "https://api.semur.ai/mcp"
    }
  }
}

Cliquez sur Start au-dessus du serveur dans le fichier et connectez-vous à Semurai. Des exemples pour Copilot en mode agent : VS Code MCP.

Autres assistants

Tout assistant compatible avec les serveurs MCP distants et la connexion OAuth se connecte de la même façon : ajoutez https://api.semur.ai/mcp comme adresse de serveur.

Gemini CLI : ajoutez le serveur avec cette commande, puis connectez-vous avec /mcp auth semurai dans Gemini CLI.

gemini mcp add --transport http semurai https://api.semur.ai/mcp

Dans le fichier settings.json de Gemini CLI, l’adresse se place sous la clé httpUrl :

{
  "mcpServers": {
    "semurai": {
      "httpUrl": "https://api.semur.ai/mcp"
    }
  }
}

Serveur complet avec visuels IA

L’adresse ci-dessus est celle du serveur officiel, pour les annuaires d’applications de Claude et ChatGPT et le travail au quotidien. Semurai propose aussi un serveur complet : la même connexion et les mêmes outils, avec en plus les visuels IA. Vous l’ajoutez vous-même comme connecteur personnalisé, avec cette adresse :

https://api.semur.ai/mcp/full

Avec le serveur complet, votre assistant peut aussi :

• créer des images pour les publications sur les réseaux sociaux et les articles,
• créer des designs dans Canvas,
• créer des designs dans Creative Studio,
• travailler sur vos designs Creative Studio : choisir le mode, répondre aux questions du designer, retoucher un design et revenir à une version antérieure ou à une variante,
• enregistrer les visuels pour les réseaux sociaux, carrousels et publicités de Creative Studio dans votre médiathèque et les ajouter à vos publications,
• proposer des idées de design pour votre marque,
• rédiger des descriptions IA et des textes alternatifs pour les images de votre médiathèque.

Ajouter le serveur complet

• Claude : dans Customize → Connectors, cliquez sur + Add, choisissez Add custom connector et collez l’adresse du serveur complet.
• ChatGPT : dans Plugins, cliquez sur +, choisissez Add custom MCP server et collez l’adresse du serveur complet.
• Cursor et VS Code : utilisez le même mcp.json que ci-dessus, avec l’adresse du serveur complet.

Dans Claude Code, exécutez :

claude mcp add --transport http --scope user semurai-full https://api.semur.ai/mcp/full

Dans Codex, exécutez :

codex mcp add semurai-full --url https://api.semur.ai/mcp/full

Une connexion validée pour le serveur officiel fonctionne avec le serveur officiel. Pour utiliser le serveur complet, ajoutez-le comme connecteur distinct et validez la connexion sur la page Semurai. Dans Claude Code et Codex, connectez-vous avec claude mcp login semurai-full ou codex mcp login semurai-full. Les visuels créés via le serveur complet sont décomptés dans les limites d’utilisation de l’espace de travail, comme ceux créés dans l’application.

Première connexion et espaces de travail

Lors de la première connexion, l’assistant ouvre une page Semurai. Connectez-vous si ce n’est pas déjà fait, puis :

1. Vérifiez le nom de l’application et l’adresse vers laquelle votre navigateur revient. Les deux sont affichés sur la page.
2. Choisissez l’Espace de travail par défaut.
3. Cliquez sur Autoriser. Le navigateur vous ramène à l’assistant, prêt à travailler.

L’assistant travaille dans l’espace de travail par défaut. À votre demande, il liste vos autres espaces de travail, travaille dans n’importe lequel d’entre eux et change celui par défaut, par exemple : Quels espaces de travail ai-je ? Passe à l’espace de travail de la boutique.

Les tâches longues tournent en arrière-plan : la rédaction d’un article, un audit complet du site, un plan de contenu, des posts pour les réseaux sociaux ou un cluster thématique. L’assistant suit leur avancement et vous apporte le résultat dès qu’il est prêt. Les brouillons apparaissent dans l’application Semurai : dans la Bibliothèque, le calendrier éditorial et vos posts sur les réseaux sociaux.

Gérer et déconnecter

Dans l’application Semurai, ouvrez Paramètres → Assistants IA (MCP). Vous y trouvez :

• les deux adresses du serveur (officiel et complet) avec des boutons de copie, et des instructions courtes pour chaque assistant,
• les applications connectées, avec leur date de connexion et leur dernière utilisation,
• l’espace de travail par défaut de chaque application, modifiable à tout moment,
• Déconnecter, qui met fin immédiatement à l’accès de l’application.

Pour réutiliser un assistant déconnecté, connectez-le à nouveau depuis l’assistant.

Sécurité et limites d’utilisation

• Vous validez ce qui sort de Semurai. La publication ou la programmation hors de Semurai (WordPress, le blog PrestaShop ou Shoper, les réseaux sociaux) et l’application de modifications à une boutique ou à un site WordPress sont des actions distinctes, et l’assistant vous demande de confirmer chacune d’elles.
• Les modifications de boutique commencent par des propositions. Les modifications SEO des produits, des catégories et des images sont d’abord créées sous forme de propositions, et seules celles que vous validez arrivent dans la boutique.
• Votre rôle s’applique. L’assistant travaille avec votre rôle dans chaque espace de travail. Avec le rôle Lecteur, il peut seulement lire les informations de base de l’espace de travail.
• Les mêmes limites d’utilisation. Les actions d’un assistant comptent dans les mêmes limites d’utilisation que votre travail dans l’application.

Dépannage

• Le lien de connexion a expiré : la page de validation est valable 10 minutes. Relancez la connexion depuis l’assistant.
• L’assistant indique qu’il a perdu l’accès : connectez-le à nouveau. Sous Paramètres → Assistants IA (MCP), vous voyez si l’application a été déconnectée.
• La limite d’utilisation est atteinte : attendez son renouvellement, puis refaites la demande.
• Un outil indique qu’une intégration n’est pas connectée : connectez Google Search Console, WordPress ou votre boutique sous Paramètres → Intégrations, puis refaites la demande. Voir Connecter votre site ou votre boutique.

Et ensuite

• IntégrationsConnectez Search Console, WordPress et votre boutique.
• BibliothèqueRelisez les brouillons créés par votre assistant.
• Calendrier éditorialArticles et posts programmés au même endroit.
• Agents IADécouvrez les agents Semurai et le travail qu’ils prennent en charge.
• Serveur MCP SemuraiCe que chaque assistant peut faire avec Semurai, avec des exemples de prompts.