{"id":442917,"date":"2026-04-13T02:04:17","date_gmt":"2026-04-13T00:04:17","guid":{"rendered":"https:\/\/www.kafinea.com\/documentation\/uncategorized\/le-serveur-mcp\/"},"modified":"2026-04-23T01:49:25","modified_gmt":"2026-04-22T23:49:25","password":"","slug":"le-serveur-mcp","status":"publish","type":"docs","link":"https:\/\/www.kafinea.com\/fr\/documentation\/parametrage\/le-serveur-mcp\/","title":{"rendered":"Le serveur MCP"},"content":{"rendered":"<hr \/>\n<h2>Introduction<\/h2>\n<p>Le <strong>serveur MCP<\/strong> (Model Context Protocol) de Kafinea permet aux clients IA externes (Claude Desktop, Cursor, Windsurf, VS Code, JetBrains\u2026) de se connecter \u00e0 l&rsquo;instance ERP pour interroger les donn\u00e9es via un protocole standardis\u00e9.<\/p>\n<p>Cette page d\u00e9crit l&rsquo;architecture technique, la s\u00e9curit\u00e9 et la configuration du serveur MCP pour les administrateurs.<\/p>\n<hr \/>\n<h2>1. Architecture<\/h2>\n<p>Le serveur MCP de Kafinea est compos\u00e9 de plusieurs briques :<\/p>\n<div style=\"overflow-x:auto\">\n<table>\n<thead>\n<tr>\n<th>Composant<\/th>\n<th>R\u00f4le<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Point d&rsquo;entr\u00e9e HTTP<\/td>\n<td>R\u00e9ception des requ\u00eates MCP (protocole Streamable HTTP)<\/td>\n<\/tr>\n<tr>\n<td>Outils (Tools)<\/td>\n<td>Fonctions expos\u00e9es aux clients IA (recherche, lecture, navigation)<\/td>\n<\/tr>\n<tr>\n<td>Ressources (Resources)<\/td>\n<td>Donn\u00e9es de contexte consultables par le client IA<\/td>\n<\/tr>\n<tr>\n<td>Authentification<\/td>\n<td>Validation des identifiants utilisateur \u00e0 chaque requ\u00eate<\/td>\n<\/tr>\n<tr>\n<td>S\u00e9curit\u00e9<\/td>\n<td>Application des droits d&rsquo;acc\u00e8s et des contr\u00f4les de s\u00e9curit\u00e9<\/td>\n<\/tr>\n<tr>\n<td>Configuration<\/td>\n<td>Param\u00e8tres d&rsquo;activation et de limitation du serveur<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<hr \/>\n<h2>2. Authentification<\/h2>\n<p>L&rsquo;authentification se fait via le header HTTP <code>X-Kafinea-Credentials<\/code> au format :<\/p>\n<pre><code>X-Kafinea-Credentials: username:accesskey\n<\/code><\/pre>\n<ul>\n<li>Le <strong>username<\/strong> est le nom d&rsquo;utilisateur Kafinea<\/li>\n<li>L&rsquo;<strong>accesskey<\/strong> est la cl\u00e9 d&rsquo;acc\u00e8s de l&rsquo;utilisateur (visible dans Mes Pr\u00e9f\u00e9rences)<\/li>\n<\/ul>\n<p>Le serveur valide les identifiants et \u00e9tablit le contexte utilisateur pour la requ\u00eate.<\/p>\n<hr \/>\n<h2>3. S\u00e9curit\u00e9<\/h2>\n<h3>Droits d&rsquo;acc\u00e8s<\/h3>\n<p>Chaque requ\u00eate MCP est ex\u00e9cut\u00e9e dans le contexte de l&rsquo;utilisateur authentifi\u00e9. Les droits d&rsquo;acc\u00e8s aux modules, enregistrements et champs sont respect\u00e9s.<\/p>\n<h3>Contr\u00f4les de s\u00e9curit\u00e9 suppl\u00e9mentaires<\/h3>\n<p>En plus des droits d&rsquo;acc\u00e8s utilisateur, le serveur MCP applique des contr\u00f4les suppl\u00e9mentaires :<\/p>\n<ul>\n<li>Validation des param\u00e8tres d&rsquo;entr\u00e9e<\/li>\n<li>Filtrage des modules et champs sensibles<\/li>\n<li>Protection contre les injections<\/li>\n<\/ul>\n<h3>Recommandations<\/h3>\n<ul>\n<li>D\u00e9ployez le serveur MCP uniquement sur des connexions HTTPS<\/li>\n<li>Ne publiez jamais les identifiants dans un d\u00e9p\u00f4t public<\/li>\n<li>Surveillez les logs d&rsquo;acc\u00e8s pour d\u00e9tecter les usages anormaux<\/li>\n<li>Utilisez des cl\u00e9s d&rsquo;acc\u00e8s d\u00e9di\u00e9es pour les int\u00e9grations MCP si possible<\/li>\n<\/ul>\n<hr \/>\n<h2>4. Outils expos\u00e9s (Tools)<\/h2>\n<p>Les outils expos\u00e9s par le serveur MCP permettent aux clients IA de :<\/p>\n<ul>\n<li><strong>Rechercher<\/strong> des enregistrements dans les modules Kafinea<\/li>\n<li><strong>Lire<\/strong> le d\u00e9tail d&rsquo;un enregistrement sp\u00e9cifique<\/li>\n<li><strong>Naviguer<\/strong> les relations entre enregistrements<\/li>\n<li><strong>Lister<\/strong> les modules et champs disponibles<\/li>\n<\/ul>\n<p>Chaque outil respecte les droits d&rsquo;acc\u00e8s de l&rsquo;utilisateur connect\u00e9.<\/p>\n<hr \/>\n<h2>5. Ressources expos\u00e9es (Resources)<\/h2>\n<p>Les ressources exposent des donn\u00e9es de contexte que le client IA peut consulter :<\/p>\n<ul>\n<li>Informations sur l&rsquo;instance Kafinea<\/li>\n<li>Structure des modules disponibles<\/li>\n<li>M\u00e9tadonn\u00e9es des champs<\/li>\n<\/ul>\n<hr \/>\n<h2>6. Configuration<\/h2>\n<p>La configuration du serveur MCP est g\u00e9r\u00e9e par l&rsquo;administrateur serveur. Les param\u00e8tres incluent :<\/p>\n<ul>\n<li>Activation\/d\u00e9sactivation du serveur<\/li>\n<li>Liste des modules expos\u00e9s<\/li>\n<li>Limites de requ\u00eates<\/li>\n<\/ul>\n<blockquote class=\"bq-note\">\n<p><strong>Note :<\/strong> Contactez votre administrateur serveur si vous souhaitez modifier la liste des modules expos\u00e9s ou les limites de requ\u00eates.<\/p>\n<\/blockquote>\n<hr \/>\n<h2>7. Activation<\/h2>\n<p>Le serveur MCP est activ\u00e9 via les feature flags de Kafinea. Pour l&rsquo;activer :<\/p>\n<ol>\n<li>V\u00e9rifiez que le feature flag MCP est activ\u00e9 dans la configuration<\/li>\n<li>Assurez-vous que le endpoint <code>mcp\/index.php<\/code> est accessible depuis l&rsquo;ext\u00e9rieur (ou depuis le r\u00e9seau des utilisateurs)<\/li>\n<li>Informez les utilisateurs qu&rsquo;ils peuvent r\u00e9cup\u00e9rer leur configuration depuis <strong>Mes Pr\u00e9f\u00e9rences &gt; Configuration MCP<\/strong><\/li>\n<\/ol>\n<hr \/>\n<h2>8. Diagnostic<\/h2>\n<p>En cas de probl\u00e8me de connexion :<\/p>\n<ol>\n<li>V\u00e9rifiez que le endpoint MCP est accessible depuis le poste de l&rsquo;utilisateur<\/li>\n<li>V\u00e9rifiez les identifiants utilisateur (username + accesskey valides)<\/li>\n<li>V\u00e9rifiez que le feature flag MCP est bien activ\u00e9<\/li>\n<li>Consultez l&rsquo;Explorateur Agents IA pour identifier d&rsquo;\u00e9ventuelles erreurs<\/li>\n<\/ol>\n<hr \/>\n<h2>FAQ<\/h2>\n<p><strong>Le serveur MCP est-il compatible avec tous les clients IA ?<\/strong><br \/>\nLe serveur impl\u00e9mente le protocole MCP standard (Streamable HTTP). Tout client compatible MCP peut s&rsquo;y connecter.<\/p>\n<p><strong>Puis-je limiter les modules accessibles via MCP ?<\/strong><br \/>\nOui, via les droits d&rsquo;acc\u00e8s des profils utilisateurs dans Kafinea. L&rsquo;administrateur serveur peut \u00e9galement restreindre la liste des modules expos\u00e9s au niveau de la configuration du serveur.<\/p>\n<p><strong>Les requ\u00eates MCP sont-elles logu\u00e9es ?<\/strong><br \/>\nOui, l&rsquo;activit\u00e9 MCP peut \u00eatre consult\u00e9e depuis l&rsquo;Explorateur Agents IA dans Kafinea.<\/p>\n<hr \/>\n<h2>R\u00e9f\u00e9rences associ\u00e9es<\/h2>\n<ul>\n<li><a href=\"\/205_intelligence-artificielle\/040_connecter-une-ia-externe-mcp.md\">Connecter une IA externe (MCP)<\/a><\/li>\n<li><a href=\"https:\/\/www.kafinea.com\/documentation\/parametrage\/les-agents-ia\/\">Les agents IA<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Introduction Le serveur MCP (Model Context Protocol) de Kafinea permet aux clients IA externes (Claude Desktop, Cursor, Windsurf, VS Code, JetBrains\u2026) de se connecter \u00e0 l&rsquo;instance ERP pour interroger les donn\u00e9es via un protocole standardis\u00e9. Cette page d\u00e9crit l&rsquo;architecture technique, la s\u00e9curit\u00e9 et la configuration du serveur MCP pour les administrateurs. 1. Architecture Le serveur&#8230;<\/p>\n","protected":false},"author":4,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_uag_custom_page_level_css":"","_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"_kad_post_classname":"","footnotes":""},"doc_category":[36],"doc_tag":[],"class_list":["post-442917","docs","type-docs","status-publish","hentry","doc_category-parametrage"],"year_month":"2026-06","word_count":645,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":{"name":"David Valminos","author_nicename":"david","author_url":"https:\/\/www.kafinea.com\/fr\/author\/david\/"},"doc_category_info":[{"term_name":"Param\u00e9trage","term_url":"https:\/\/www.kafinea.com\/fr\/documentation\/parametrage\/"}],"doc_tag_info":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.8 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Documentation - Le serveur MCP &#8226; Kafinea<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.kafinea.com\/fr\/documentation\/parametrage\/le-serveur-mcp\/\" \/>\n<meta property=\"og:locale\" content=\"fr_FR\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Documentation - Le serveur MCP &#8226; Kafinea\" \/>\n<meta property=\"og:description\" content=\"Introduction Le serveur MCP (Model Context Protocol) de Kafinea permet aux clients IA externes (Claude Desktop, Cursor, Windsurf, VS Code, JetBrains\u2026) de se connecter \u00e0 l&rsquo;instance ERP pour interroger les donn\u00e9es via un protocole standardis\u00e9. Cette page d\u00e9crit l&rsquo;architecture technique, la s\u00e9curit\u00e9 et la configuration du serveur MCP pour les administrateurs. 1. Architecture Le serveur...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.kafinea.com\/fr\/documentation\/parametrage\/le-serveur-mcp\/\" \/>\n<meta property=\"og:site_name\" content=\"Kafinea\" \/>\n<meta property=\"article:modified_time\" content=\"2026-04-22T23:49:25+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Dur\u00e9e de lecture estim\u00e9e\" \/>\n\t<meta name=\"twitter:data1\" content=\"3 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.kafinea.com\\\/fr\\\/documentation\\\/parametrage\\\/le-serveur-mcp\\\/\",\"url\":\"https:\\\/\\\/www.kafinea.com\\\/fr\\\/documentation\\\/parametrage\\\/le-serveur-mcp\\\/\",\"name\":\"Documentation - Le serveur MCP &#8226; Kafinea\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.kafinea.com\\\/fr\\\/#website\"},\"datePublished\":\"2026-04-13T00:04:17+00:00\",\"dateModified\":\"2026-04-22T23:49:25+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.kafinea.com\\\/fr\\\/documentation\\\/parametrage\\\/le-serveur-mcp\\\/#breadcrumb\"},\"inLanguage\":\"fr-FR\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.kafinea.com\\\/fr\\\/documentation\\\/parametrage\\\/le-serveur-mcp\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.kafinea.com\\\/fr\\\/documentation\\\/parametrage\\\/le-serveur-mcp\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Accueil\",\"item\":\"https:\\\/\\\/www.kafinea.com\\\/fr\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Documentation\",\"item\":\"https:\\\/\\\/www.kafinea.com\\\/fr\\\/documentation\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Le serveur MCP\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.kafinea.com\\\/fr\\\/#website\",\"url\":\"https:\\\/\\\/www.kafinea.com\\\/fr\\\/\",\"name\":\"Kafinea\",\"description\":\"Une solution unique pour toutes vos ambitions\",\"publisher\":{\"@id\":\"https:\\\/\\\/www.kafinea.com\\\/fr\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.kafinea.com\\\/fr\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"fr-FR\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/www.kafinea.com\\\/fr\\\/#organization\",\"name\":\"Kafinea\",\"url\":\"https:\\\/\\\/www.kafinea.com\\\/fr\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"fr-FR\",\"@id\":\"https:\\\/\\\/www.kafinea.com\\\/fr\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/www.kafinea.com\\\/wp-content\\\/uploads\\\/2024\\\/10\\\/Logo-Kafinea-SVG-orange-bleu.svg\",\"contentUrl\":\"https:\\\/\\\/www.kafinea.com\\\/wp-content\\\/uploads\\\/2024\\\/10\\\/Logo-Kafinea-SVG-orange-bleu.svg\",\"width\":296.31,\"height\":66.48,\"caption\":\"Kafinea\"},\"image\":{\"@id\":\"https:\\\/\\\/www.kafinea.com\\\/fr\\\/#\\\/schema\\\/logo\\\/image\\\/\"},\"sameAs\":[\"https:\\\/\\\/www.linkedin.com\\\/company\\\/kafinea\\\/\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Documentation - Le serveur MCP &#8226; Kafinea","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.kafinea.com\/fr\/documentation\/parametrage\/le-serveur-mcp\/","og_locale":"fr_FR","og_type":"article","og_title":"Documentation - Le serveur MCP &#8226; Kafinea","og_description":"Introduction Le serveur MCP (Model Context Protocol) de Kafinea permet aux clients IA externes (Claude Desktop, Cursor, Windsurf, VS Code, JetBrains\u2026) de se connecter \u00e0 l&rsquo;instance ERP pour interroger les donn\u00e9es via un protocole standardis\u00e9. Cette page d\u00e9crit l&rsquo;architecture technique, la s\u00e9curit\u00e9 et la configuration du serveur MCP pour les administrateurs. 1. Architecture Le serveur...","og_url":"https:\/\/www.kafinea.com\/fr\/documentation\/parametrage\/le-serveur-mcp\/","og_site_name":"Kafinea","article_modified_time":"2026-04-22T23:49:25+00:00","twitter_card":"summary_large_image","twitter_misc":{"Dur\u00e9e de lecture estim\u00e9e":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.kafinea.com\/fr\/documentation\/parametrage\/le-serveur-mcp\/","url":"https:\/\/www.kafinea.com\/fr\/documentation\/parametrage\/le-serveur-mcp\/","name":"Documentation - Le serveur MCP &#8226; Kafinea","isPartOf":{"@id":"https:\/\/www.kafinea.com\/fr\/#website"},"datePublished":"2026-04-13T00:04:17+00:00","dateModified":"2026-04-22T23:49:25+00:00","breadcrumb":{"@id":"https:\/\/www.kafinea.com\/fr\/documentation\/parametrage\/le-serveur-mcp\/#breadcrumb"},"inLanguage":"fr-FR","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.kafinea.com\/fr\/documentation\/parametrage\/le-serveur-mcp\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.kafinea.com\/fr\/documentation\/parametrage\/le-serveur-mcp\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Accueil","item":"https:\/\/www.kafinea.com\/fr\/"},{"@type":"ListItem","position":2,"name":"Documentation","item":"https:\/\/www.kafinea.com\/fr\/documentation\/"},{"@type":"ListItem","position":3,"name":"Le serveur MCP"}]},{"@type":"WebSite","@id":"https:\/\/www.kafinea.com\/fr\/#website","url":"https:\/\/www.kafinea.com\/fr\/","name":"Kafinea","description":"Une solution unique pour toutes vos ambitions","publisher":{"@id":"https:\/\/www.kafinea.com\/fr\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.kafinea.com\/fr\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"fr-FR"},{"@type":"Organization","@id":"https:\/\/www.kafinea.com\/fr\/#organization","name":"Kafinea","url":"https:\/\/www.kafinea.com\/fr\/","logo":{"@type":"ImageObject","inLanguage":"fr-FR","@id":"https:\/\/www.kafinea.com\/fr\/#\/schema\/logo\/image\/","url":"https:\/\/www.kafinea.com\/wp-content\/uploads\/2024\/10\/Logo-Kafinea-SVG-orange-bleu.svg","contentUrl":"https:\/\/www.kafinea.com\/wp-content\/uploads\/2024\/10\/Logo-Kafinea-SVG-orange-bleu.svg","width":296.31,"height":66.48,"caption":"Kafinea"},"image":{"@id":"https:\/\/www.kafinea.com\/fr\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.linkedin.com\/company\/kafinea\/"]}]}},"uagb_featured_image_src":{"full":false,"thumbnail":false,"medium":false,"medium_large":false,"large":false,"1536x1536":false,"2048x2048":false},"uagb_author_info":{"display_name":"David Valminos","author_link":"https:\/\/www.kafinea.com\/fr\/author\/david\/"},"uagb_comment_info":0,"uagb_excerpt":"Introduction Le serveur MCP (Model Context Protocol) de Kafinea permet aux clients IA externes (Claude Desktop, Cursor, Windsurf, VS Code, JetBrains\u2026) de se connecter \u00e0 l&rsquo;instance ERP pour interroger les donn\u00e9es via un protocole standardis\u00e9. Cette page d\u00e9crit l&rsquo;architecture technique, la s\u00e9curit\u00e9 et la configuration du serveur MCP pour les administrateurs. 1. Architecture Le serveur...","_links":{"self":[{"href":"https:\/\/www.kafinea.com\/fr\/wp-json\/wp\/v2\/docs\/442917","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.kafinea.com\/fr\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.kafinea.com\/fr\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.kafinea.com\/fr\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/www.kafinea.com\/fr\/wp-json\/wp\/v2\/comments?post=442917"}],"version-history":[{"count":2,"href":"https:\/\/www.kafinea.com\/fr\/wp-json\/wp\/v2\/docs\/442917\/revisions"}],"predecessor-version":[{"id":442963,"href":"https:\/\/www.kafinea.com\/fr\/wp-json\/wp\/v2\/docs\/442917\/revisions\/442963"}],"wp:attachment":[{"href":"https:\/\/www.kafinea.com\/fr\/wp-json\/wp\/v2\/media?parent=442917"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www.kafinea.com\/fr\/wp-json\/wp\/v2\/doc_category?post=442917"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.kafinea.com\/fr\/wp-json\/wp\/v2\/doc_tag?post=442917"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}