MCP

Le serveur MCP (Model Context Protocol) Flowkode permet à vos assistants IA — Claude, Cursor, Windsurf, etc. — de gérer vos sites web directement depuis la conversation.

Écrit par Jérémy DE CAMPOS

Dernière mise à jour Il y a 30 jours

Qu'est-ce que le MCP ?

Le MCP est un protocole qui permet aux assistants IA d'utiliser des outils externes. En connectant le MCP Flowkode à votre assistant, vous pouvez lui demander en langage naturel :

  • "Crée-moi un site vitrine pour une boulangerie à Lyon"

  • "Déploie mon projet sur Vercel"

  • "Vérifie si monsite.com est disponible"

  • "Génère 3 articles de blog sur le SEO"

L'assistant appelle les outils Flowkode en arrière-plan et vous donne le résultat.

Configuration

Prérequis

Vous avez besoin d'une clé API Flowkode. Créez-en une dans votre espace Flowkode :

Paramètres → Clés API → Créer une clé

Claude Desktop

Ouvrez le fichier de configuration :

  • macOS : ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows : %APPDATA%\Claude\claude_desktop_config.json

Ajoutez la configuration suivante :

{
  "mcpServers": {
    "flowkode": {
      "type": "streamable-http",
      "url": "https://app.flowkode.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ws_live_VOTRE_CLE_API"
      }
    }
  }
}

Redémarrez Claude Desktop. Vous verrez les outils Flowkode apparaître dans la liste des outils disponibles.

Cursor

Ouvrez les paramètres Cursor (Settings → MCP) et ajoutez un nouveau serveur :

  • Nom : Flowkode

  • Type : Streamable HTTP

  • URL : https://app.flowkode.com/api/mcp

Autres clients MCP

Tout client compatible MCP avec le transport Streamable HTTP fonctionne. L'URL du serveur est :

https://app.flowkode.com/api/mcp

Projets

Lister les projets

Outil : list_projects

Demandez à votre assistant :

"Montre-moi la liste de mes projets"

Vous pouvez filtrer par dossier en précisant l'ID.

Voir le détail d'un projet

Outil : get_project

"Donne-moi les détails du projet abc-123"

Retourne le nom, la description, les pages, la configuration blog, le dernier déploiement, etc.

Créer un projet — Mode rapide

Outil : create_project_quick

"Crée un site vitrine pour une boulangerie à Lyon avec les mots-clés pain, pâtisserie, artisanal"

Paramètres :

Paramètre Obligatoire

name

Nom du projet

oui

siteType

vitrine ou affiliation

oui

keywords

Mots-clés SEO, séparés par des virgules

oui

language

Langue du contenu (fr, en, es, etc.)

oui

description

Description libre (générée par l'IA si absente)

non

aiModel

ID du modèle IA à utiliser

non

Retourne un jobId pour suivre la génération.

Créer un projet — Mode complet

Outil : create_project_complete

"Crée un site complet pour une agence web avec les pages Accueil, Services, Portfolio et Contact, couleur principale #3B82F6, ton professionnel"

Paramètres supplémentaires par rapport au mode rapide :

ParamètreDescription

pages

Liste des pages avec nom et niveau de menu (1, 2 ou 3)

style

Couleur principale, secondaire, ton, police

contact

Email, téléphone, adresse

Modifier un projet

Outil : update_project

"Renomme le projet abc-123 en 'Boulangerie Martin — Site officiel'"

Champs modifiables : name, description, folder_id.

Déploiement

Déployer un projet

Outil : deploy_project

"Déploie le projet abc-123 sur Vercel"

Providers disponibles : vercel, cloudflare.

Options :

  • domain_id — Associer un domaine au déploiement

  • configure_ns — Configurer les nameservers automatiquement via le registrar

"Déploie le projet abc-123 sur Cloudflare avec le domaine def-456 et configure les DNS"

Re-déployer

Outil : redeploy_project

"Re-déploie le projet abc-123"

Utilise le dernier provider de déploiement.

Suivre les jobs de génération

Outils : list_jobs, get_job

"Quel est le statut du job abc-123 ?"

Statuts : pending, running, completed, failed.

Lister les déploiements

Outils : list_deployments, get_deployment

"Montre-moi tous les déploiements Vercel en statut ready"

Filtres : project_id, provider, status.

Indexation Google

Outil : get_project_indexing

"Vérifie l'indexation Google de mon projet abc-123"

Domaines

Lister les domaines

Outil : list_domains

"Liste mes domaines enregistrés chez OVH"

Filtres : registrar, deployment_provider, project_id, folder_id.

Détail d'un domaine

Outil : get_domain

"Donne-moi les infos du domaine abc-123"

Vérifier la disponibilité

Outil : check_domain_availability

"Est-ce que boulangerie-martin.com est disponible ?"

Interroge tous vos registrars configurés et retourne les prix.

Acheter un domaine

Outil : purchase_domain

"Achète boulangerie-martin.com chez OVH pour 2 ans"

Paramètres : domain, registrar (internetbs, ovh, dynadot), years (défaut : 1).

Synchroniser les domaines

Outil : sync_domains

"Synchronise mes domaines depuis les registrars"

Importe les domaines de vos registrars dans Flowkode.

Associer un domaine à un projet

Outil : associate_domain

"Associe le domaine abc-123 au projet def-456"

Dissocier un domaine

Outil : dissociate_domain

"Dissocie le domaine abc-123 de son projet"

Configurer les DNS

Outil : configure_domain_dns

"Configure les DNS du domaine abc-123"

Configure automatiquement les nameservers ou les enregistrements CNAME vers le déploiement associé.

Vérifier la propagation DNS

Outil : check_domain_propagation

"Vérifie la propagation DNS du domaine abc-123"

Modifier / Supprimer un domaine

Outils : update_domain, delete_domain

"Déplace le domaine abc-123 dans le dossier def-456""Supprime le domaine abc-123"

Le domaine doit être dissocié avant d'être supprimé.

Dossiers

Lister, voir, créer

Outils : list_folders, get_folder, create_folder

"Crée un dossier 'Clients 2026' en bleu"

Couleurs : gray, red, orange, amber, green, blue, violet, pink.

Modifier

Outil : update_folder

"Renomme le dossier abc-123 en 'E-commerce' et mets-le en vert"

Champs : name, color, position.

Supprimer

Outil : delete_folder

"Supprime le dossier abc-123"

Les projets et domaines du dossier sont déplacés à la racine.

Blog

Lister les articles

Outil : list_blog_articles

"Montre-moi les articles publiés du projet abc-123"

Filtres : status, projectId.

Détail d'un article

Outil : get_blog_article

"Affiche le contenu de l'article abc-123"

Générer des articles

Outil : generate_blog_articles

"Génère 3 articles de blog pour le projet abc-123 sur les thèmes React, Next.js et TypeScript"

Paramètres :

ParamètreDescriptionObligatoire

projectId

ID du projet

oui

keywords

Liste de mots-clés (un article par mot-clé)

oui

auto_publish

Publier automatiquement après génération

non (défaut : false)

Indexation Google des articles

Outils : get_article_indexing, check_article_indexing, submit_article_indexing

"Soumets l'article abc-123 pour indexation Google"

Google Search Console

Comptes connectés

Outil : list_search_console_accounts

"Quels comptes Search Console sont connectés ?"

Enregistrer un site

Outil : add_search_console_site

"Enregistre le projet abc-123 dans Google Search Console"

Statut

Outil : get_search_console_status

"Quel est le statut Search Console du projet abc-123 ?"

Soumettre le sitemap

Outil : submit_sitemap

"Soumets le sitemap du projet abc-123 à Google"

Workflows

Les workflows sont des outils qui enchaînent automatiquement plusieurs étapes. Ils permettent de réaliser des opérations complexes en un seul appel.

Suivre un job

Outil : watch_job

"Suis le job abc-123 jusqu'à ce qu'il soit terminé"

Paramètres :

ParamètreDescriptionObligatoire

job_id

ID du job à suivre

oui

timeout_minutes

Timeout en minutes (1-30)

non (défaut : 10)

L'outil bloque jusqu'à complétion ou échec du job, puis retourne le résultat final.

Lancer un site complet

Outil : launch_site

"Lance un site vitrine complet pour une boulangerie à Lyon, déploie sur Vercel, achète boulangerie-martin.com chez OVH et configure les DNS"

Paramètres :

ParamètreDescriptionObligatoire

name

Nom du site

oui

site_type

vitrine ou affiliation

oui

keywords

Mots-clés SEO, séparés par des virgules

oui

language

Langue du contenu

non (défaut : fr)

description

Description libre

non

ai_model

ID du modèle IA

non

deploy_provider

vercel ou cloudflare

non

domain

Domaine à acheter (ex: monsite.com)

non

domain_registrar

internetbs, ovh ou dynadot

non

Étapes exécutées automatiquement :

  1. Création du projet (mode rapide)

  2. Attente de la génération IA

  3. Déploiement (si deploy_provider spécifié)

  4. Achat du domaine (si domain et domain_registrar spécifiés)

  5. Synchronisation, association et configuration DNS du domaine

Campagne SEO

Outil : seo_campaign

"Lance une campagne SEO pour le projet abc-123 avec les mots-clés React, Next.js, TypeScript, Tailwind, Vercel"

Paramètres :

ParamètreDescriptionObligatoire

project_id

ID du projet

oui

keywords

Liste de mots-clés (1 à 50)

oui

auto_publish

Publier automatiquement

non (défaut : true)

submit_indexing

Soumettre à Google pour indexation

non (défaut : true)

Étapes exécutées automatiquement :

  1. Génération des articles de blog (1 par mot-clé)

  2. Récupération des articles publiés

  3. Soumission de chaque article à Google pour indexation

Audit SEO

Outil : audit_seo

"Fais un audit SEO complet du projet abc-123"

Paramètres :

ParamètreDescriptionObligatoire

project_id

ID du projet

oui

Retourne un rapport complet incluant :

  • Informations du projet (nom, URL)

  • Statut d'indexation Google (toutes les pages et articles)

  • Statut Search Console

  • Articles de blog (total, répartition par statut, liste détaillée)

Migrer un domaine

Outil : migrate_domain

"Migre le domaine abc-123 vers le projet def-456"

Paramètres :

ParamètreDescriptionObligatoire

domain_id

ID du domaine à migrer

oui

target_project_id

ID du projet de destination

oui

configure_dns

Reconfigurer les DNS

non (défaut : true)

check_propagation

Vérifier la propagation DNS

non (défaut : true)

Étapes exécutées automatiquement :

  1. Dissociation de l'ancien projet (ignoré si pas associé)

  2. Association au nouveau projet

  3. Reconfiguration DNS

  4. Vérification de la propagation DNS


Autres outils

Formulaires de contact

Outil : list_contact_forms

"Liste mes formulaires de devis"

Filtre : category (contact ou devis).

Projets d'affiliation

Outils : list_affiliation_projects, get_affiliation_project

"Montre-moi mes projets d'affiliation et leurs widgets"

Modèles IA

Outil : list_ai_models

"Quels modèles IA sont disponibles ?"

Mentions légales

Outil : list_legal_notices

"Liste mes fiches de mentions légales"


Exemples de conversations

Créer et déployer un site complet

Vous : Crée un site vitrine pour un restaurant italien à Paris, mots-clés "restaurant, pizza, pâtes, Paris 11", en français.

Assistant : Je lance la création... Job créé avec l'ID job-xxx. Je vérifie l'avancement.

Assistant : La génération est terminée ! Le projet proj-xxx est prêt avec 1 page. Voulez-vous le déployer ?

Vous : Oui, déploie sur Vercel.

Assistant : Déploiement lancé. URL : https://restaurant-xxx.vercel.app

Acheter un domaine et le configurer

Vous : Vérifie si pizzeria-roma.com est disponible.

Assistant : Disponible chez OVH à 8.49 EUR et chez InternetBS à 9.99 USD.

Vous : Achète-le chez OVH.

Assistant : Domaine acheté. Voulez-vous l'associer à un projet ?

Vous : Oui, associe-le au projet restaurant et configure les DNS.

Assistant : Domaine associé et DNS configurés. La propagation peut prendre jusqu'à 48h.

Générer du contenu blog et l'indexer

Vous : Génère 5 articles de blog pour mon projet restaurant sur les thèmes pizza napolitaine, pâtes fraîches, tiramisu, vin italien, cuisine méditerranéenne.

Assistant : 5 articles en cours de génération. Je vous tiens au courant.

Vous : Soumets-les tous pour indexation Google.

Assistant : Les 5 articles ont été soumis pour indexation.

Utiliser les workflows

Vous : Lance un site complet pour un restaurant italien à Paris, déploie sur Vercel, achète pizzeria-roma.com chez OVH.

Assistant : J'utilise launch_site pour tout faire d'un coup. Création en cours... Génération terminée. Déployé sur Vercel. Domaine acheté, associé et DNS configurés. Voici le récapitulatif de chaque étape.

Vous : Fais une campagne SEO pour mon projet restaurant avec 5 articles sur la pizza, les pâtes, le tiramisu, le vin et la cuisine méditerranéenne.

Assistant : J'utilise seo_campaign. 5 articles générés et publiés. Les 5 ont été soumis pour indexation Google. Voici le rapport.

Vous : Fais un audit SEO de mon projet abc-123.

Assistant : Voici le rapport audit_seo : 8 pages indexées sur 10, Search Console connecté, 12 articles de blog (10 publiés, 2 en brouillon).

Vous : Migre le domaine pizzeria-roma.com vers mon nouveau projet.

Assistant : J'utilise migrate_domain. Domaine dissocié de l'ancien projet, associé au nouveau, DNS reconfigurés. Propagation en cours.


Dépannage

L'assistant ne voit pas les outils Flowkode

  • Vérifiez que la configuration MCP est correcte dans votre client

  • Vérifiez que votre clé API est valide

  • Redémarrez votre client (Claude Desktop, Cursor, etc.)

"Missing or invalid Authorization header"

Votre clé API n'est pas configurée ou est invalide. Vérifiez-la dans Paramètres → Clés API de votre espace Flowkode.

"API key has been revoked"

Cette clé a été révoquée. Créez-en une nouvelle dans Paramètres → Clés API.

"Rate limit exceeded"

L'API autorise 100 requêtes par heure. Attendez quelques minutes avant de réessayer.

Les outils fonctionnent mais sont lents

C'est normal pour les opérations de génération (création de projet, articles de blog). Ces opérations sont asynchrones — l'outil retourne un jobId que vous pouvez suivre avec get_job.

Comment obtenir une clé API ?

  1. Connectez-vous à votre espace Flowkode

  2. Allez dans Paramètres → Clés API

  3. Cliquez sur Créer une clé

  4. Copiez la clé (elle ne sera affichée qu'une seule fois)