Aller au contenu

Un serveur MCP pour que les agents IA cherchent sur votre site

Appik Studio

Les agents IA ne se contentent plus de chercher sur le web. Claude, ChatGPT, Cursor ou un agent développé en interne peuvent appeler des outils externes grâce au Model Context Protocol (MCP). Chaque projet Askolia peut désormais publier un serveur MCP. Un agent connecté cherche dans vos pages, documents et FAQ publiés, lit la source complète et cite son URL.

Les informations produit de cet article sont datées du 1er novembre 2026.

Pourquoi un agent passe par votre serveur MCP

Un agent qui navigue sur un site charge des pages entières, devine leur structure et s'arrête parfois à la première page trouvée. Avec le serveur MCP, il appelle une recherche qui connaît déjà vos contenus. Il reçoit des résultats courts, avec un titre, un extrait et l'URL de la page, puis il ouvre la source utile. Il consomme moins de contexte et cite vos pages plutôt qu'un résumé publié ailleurs.

Le serveur utilise l'index de votre recherche Askolia, soit les pages explorées sur votre domaine, les sites additionnels, les documents publiés et les FAQ dans leurs langues. Vous n'avez aucun contenu supplémentaire à préparer.

Deux outils en lecture seule

  • search cherche dans les sources publiées. Il accepte une requête de 2 à 200 caractères, une langue facultative pour les FAQ (fr, en, de, es ou it) et renvoie jusqu'à 10 résultats. Chaque résultat contient un identifiant, un titre, un extrait et, pour une page web, son URL.
  • fetch renvoie le texte complet d'un résultat à partir de son identifiant. Au-delà de 20 000 caractères, le texte est tronqué.

Ces deux noms correspondent aux outils qu'attend ChatGPT pour un connecteur de recherche, décrits dans la documentation MCP d'OpenAI. Les deux outils sont déclarés en lecture seule. Le serveur n'écrit rien, n'envoie aucun message et n'ouvre aucune conversation.

Ce que l'agent peut lire

Le serveur expose seulement ce que la recherche montre déjà à vos visiteurs, soit les pages publiques indexées, les documents publiés et les FAQ. Les instructions internes de l'assistant, les conversations, les brouillons de réponse et les données des visiteurs restent hors de portée. Les pages d'un site additionnel retiré disparaissent aussi des résultats.

Les instructions du serveur présentent le contenu renvoyé comme une donnée non fiable et demandent à l'agent de ne jamais suivre une consigne trouvée dans une source.

Activer le serveur

  1. Dans le tableau de bord, ouvrez les réglages du projet, puis la section "Search your site with AI".
  2. Sous "AI agents (MCP)", cliquez sur "Allow AI agents to search". Seul le propriétaire de l'espace de travail peut modifier ce réglage.
  3. Copiez l'adresse affichée sous "MCP server URL".

L'adresse a la forme https://tacit-goose-489.eu-west-1.convex.site/mcp/<clé publique>. La clé publique est celle de votre widget, déjà visible dans le code de vos pages. Elle donne accès aux seuls contenus publics. Le serveur est désactivé par défaut. Si vous le désactivez, l'adresse répond 404.

Connecter un client

Claude Code ajoute le serveur en une commande :

claude mcp add --transport http ma-boutique https://tacit-goose-489.eu-west-1.convex.site/mcp/VOTRE_CLE

Dans Cursor, ajoutez-le au fichier .cursor/mcp.json du projet :

{
  "mcpServers": {
    "ma-boutique": { "url": "https://tacit-goose-489.eu-west-1.convex.site/mcp/VOTRE_CLE" }
  }
}

Dans VS Code, ajoutez-le au fichier .vscode/mcp.json :

{
  "servers": {
    "ma-boutique": { "type": "http", "url": "https://tacit-goose-489.eu-west-1.convex.site/mcp/VOTRE_CLE" }
  }
}

Dans ChatGPT et Claude, ajoutez un connecteur personnalisé avec la même adresse et sans authentification, si votre forfait le permet.

Le serveur utilise le transport HTTP streamable, sans session. Chaque requête est indépendante. Les en-têtes CORS permettent aussi à un client web de l'appeler.

Limites

  • Le serveur fait une recherche par mots-clés et ne génère pas de réponse IA. L'agent rédige sa réponse avec son propre modèle. Ces appels ne consomment donc aucune génération de recherche IA.
  • Un projet accepte 120 requêtes par minute, tous clients confondus. Au-delà, le serveur répond 429 avec un délai de 60 secondes.
  • Les limites d'indexation de la recherche s'appliquent : 500 pages et documents par projet, et seulement du HTML public lisible. Les PDF ne sont pas importés.
  • L'utilisateur doit ajouter le serveur à son client. Aucun mécanisme largement adopté ne permet encore à un assistant de découvrir seul le serveur MCP d'un site.
  • Le tableau de bord n'affiche pas les requêtes des agents.

Pour qui

Un éditeur de logiciel rend sa documentation et sa FAQ accessibles depuis Cursor ou Claude Code, là où ses clients développeurs écrivent leur code. Une boutique ou une entreprise de services donne à ses équipes de vente et de support un agent qui prépare ses réponses à partir des pages officielles. Une agence publie un serveur distinct pour chaque projet client.

Le serveur MCP est disponible sur tous les forfaits, puisqu'il n'utilise pas de génération IA. Les visiteurs humains gardent la recherche IA intégrée à votre site, et la présentation de la recherche IA détaille son fonctionnement.