{"id":444497,"date":"2026-04-13T02:04:17","date_gmt":"2026-04-13T00:04:17","guid":{"rendered":"https:\/\/www.kafinea.com\/documentation\/uncategorized\/the-mcp-server\/"},"modified":"2026-04-13T02:04:17","modified_gmt":"2026-04-13T00:04:17","password":"","slug":"the-mcp-server","status":"publish","type":"docs","link":"https:\/\/www.kafinea.com\/en\/help\/settings\/the-mcp-server\/","title":{"rendered":"The MCP Server"},"content":{"rendered":"<hr>\n<h2>Introduction<\/h2>\n<p>The <strong>MCP server<\/strong> (Model Context Protocol) from Kafinea allows external AI clients (Claude Desktop, Cursor, Windsurf, VS Code, JetBrains\u2026) to connect to the ERP instance to query data via a standardized protocol.<\/p>\n<p>This page describes the technical architecture, security, and configuration of the MCP server for administrators.<\/p>\n<hr>\n<h2>1. Architecture<\/h2>\n<p>The Kafinea MCP server is composed of several components:<\/p>\n<div style=\"overflow-x:auto\">\n<table>\n<thead>\n<tr>\n<th>Component<\/th>\n<th>Role<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>HTTP Entry Point<\/td>\n<td>Reception of MCP requests (Streamable HTTP protocol)<\/td>\n<\/tr>\n<tr>\n<td>Tools<\/td>\n<td>Functions exposed to AI clients (search, read, navigation)<\/td>\n<\/tr>\n<tr>\n<td>Resources<\/td>\n<td>Context data accessible by the AI client<\/td>\n<\/tr>\n<tr>\n<td>Authentication<\/td>\n<td>Validation of user credentials for each request<\/td>\n<\/tr>\n<tr>\n<td>Security<\/td>\n<td>Application of access rights and security controls<\/td>\n<\/tr>\n<tr>\n<td>Configuration<\/td>\n<td>Server activation and limitation parameters<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n<hr>\n<h2>2. Authentication<\/h2>\n<p>Authentication is performed via the HTTP header <code>X-Kafinea-Credentials<\/code> in the format:<\/p>\n<pre><code>X-Kafinea-Credentials: username:accesskey\n<\/code><\/pre>\n<ul>\n<li>The <strong>username<\/strong> is the Kafinea user name<\/li>\n<li>The <strong>accesskey<\/strong> is the user&#8217;s access key (visible in My Preferences)<\/li>\n<\/ul>\n<p>The server validates the credentials and establishes the user context for the request.<\/p>\n<hr>\n<h2>3. Security<\/h2>\n<h3>Access Rights<\/h3>\n<p>Each MCP request is executed in the context of the authenticated user. Access rights to modules, records, and fields are respected. <\/p>\n<h3>Additional Security Controls<\/h3>\n<p>In addition to user access rights, the MCP server applies additional controls:<\/p>\n<ul>\n<li>Validation of input parameters<\/li>\n<li>Filtering of sensitive modules and fields<\/li>\n<li>Protection against injections<\/li>\n<\/ul>\n<h3>Recommendations<\/h3>\n<ul>\n<li>Deploy the MCP server only over HTTPS connections<\/li>\n<li>Never publish credentials in a public repository<\/li>\n<li>Monitor access logs to detect abnormal usage<\/li>\n<li>Use dedicated access keys for MCP integrations if possible<\/li>\n<\/ul>\n<hr>\n<h2>4. Exposed Tools<\/h2>\n<p>The tools exposed by the MCP server allow AI clients to:<\/p>\n<ul>\n<li><strong>Search<\/strong> for records in Kafinea modules<\/li>\n<li><strong>Read<\/strong> the details of a specific record<\/li>\n<li><strong>Navigate<\/strong> relationships between records<\/li>\n<li><strong>List<\/strong> available modules and fields<\/li>\n<\/ul>\n<p>Each tool respects the access rights of the connected user.<\/p>\n<hr>\n<h2>5. Exposed Resources<\/h2>\n<p>Resources expose context data that the AI client can consult:<\/p>\n<ul>\n<li>Information about the Kafinea instance<\/li>\n<li>Structure of available modules<\/li>\n<li>Field metadata<\/li>\n<\/ul>\n<hr>\n<h2>6. Configuration<\/h2>\n<p>The MCP server configuration is managed by the server administrator. Parameters include: <\/p>\n<ul>\n<li>Server activation\/deactivation<\/li>\n<li>List of exposed modules<\/li>\n<li>Request limits<\/li>\n<\/ul>\n<blockquote class=\"bq-note\">\n<p><strong>Note:<\/strong> Contact your server administrator if you wish to modify the list of exposed modules or request limits.<\/p>\n<\/blockquote>\n<hr>\n<h2>7. Activation<\/h2>\n<p>The MCP server is activated via Kafinea feature flags. To activate it: <\/p>\n<ol>\n<li>Verify that the MCP feature flag is enabled in the configuration<\/li>\n<li>Ensure that the endpoint <code>mcp\/index.php<\/code> is accessible from outside (or from the user network)<\/li>\n<li>Inform users that they can retrieve their configuration from <strong>My Preferences &gt; MCP Configuration<\/strong><\/li>\n<\/ol>\n<hr>\n<h2>8. Diagnostics<\/h2>\n<p>In case of connection issues:<\/p>\n<ol>\n<li>Verify that the MCP endpoint is accessible from the user&#8217;s workstation<\/li>\n<li>Verify user credentials (valid username + accesskey)<\/li>\n<li>Verify that the MCP feature flag is properly enabled<\/li>\n<li>Consult the AI Agents Explorer to identify any errors<\/li>\n<\/ol>\n<hr>\n<h2>FAQ<\/h2>\n<p><strong>Is the MCP server compatible with all AI clients?<\/strong><br \/>\nThe server implements the standard MCP protocol (Streamable HTTP). Any MCP-compatible client can connect to it. <\/p>\n<p><strong>Can I limit the modules accessible via MCP?<\/strong><br \/>\nYes, via user profile access rights in Kafinea. The server administrator can also restrict the list of exposed modules at the server configuration level. <\/p>\n<p><strong>Are MCP requests logged?<\/strong><br \/>\nYes, MCP activity can be viewed from the AI Agents Explorer in Kafinea.<\/p>\n<hr>\n<h2>Related References<\/h2>\n<ul>\n<li><a href=\"\/205_intelligence-artificielle\/040_connecter-une-ia-externe-mcp.md\">Connect an External AI (MCP)<\/a><\/li>\n<li><a href=\"https:\/\/www.kafinea.com\/en\/documentation\/settings\/ai-agents\/\">AI Agents<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Introduction The MCP server (Model Context Protocol) from Kafinea allows external AI clients (Claude Desktop, Cursor, Windsurf, VS Code, JetBrains\u2026) to connect to the ERP instance to query data via a standardized protocol. This page describes the technical architecture, security, and configuration of the MCP server for administrators. 1. Architecture The Kafinea MCP server is&#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":[771],"doc_tag":[],"class_list":["post-444497","docs","type-docs","status-publish","hentry","doc_category-settings"],"year_month":"2026-08","word_count":526,"total_views":"1","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"David Valminos","author_nicename":"david","author_url":"https:\/\/www.kafinea.com\/en\/author\/david\/"},"doc_category_info":[{"term_name":"Settings","term_url":"https:\/\/www.kafinea.com\/en\/help\/settings\/"}],"doc_tag_info":[],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.1 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Help - The MCP Server &#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\/en\/help\/settings\/the-mcp-server\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Help - The MCP Server &#8226; Kafinea\" \/>\n<meta property=\"og:description\" content=\"Introduction The MCP server (Model Context Protocol) from Kafinea allows external AI clients (Claude Desktop, Cursor, Windsurf, VS Code, JetBrains\u2026) to connect to the ERP instance to query data via a standardized protocol. This page describes the technical architecture, security, and configuration of the MCP server for administrators. 1. Architecture The Kafinea MCP server is...\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.kafinea.com\/en\/help\/settings\/the-mcp-server\/\" \/>\n<meta property=\"og:site_name\" content=\"Kafinea\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\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\\\/en\\\/help\\\/settings\\\/the-mcp-server\\\/\",\"url\":\"https:\\\/\\\/www.kafinea.com\\\/en\\\/help\\\/settings\\\/the-mcp-server\\\/\",\"name\":\"Help - The MCP Server &#8226; Kafinea\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.kafinea.com\\\/en\\\/#website\"},\"datePublished\":\"2026-04-13T00:04:17+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.kafinea.com\\\/en\\\/help\\\/settings\\\/the-mcp-server\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.kafinea.com\\\/en\\\/help\\\/settings\\\/the-mcp-server\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.kafinea.com\\\/en\\\/help\\\/settings\\\/the-mcp-server\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Accueil\",\"item\":\"https:\\\/\\\/www.kafinea.com\\\/en\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"The MCP Server\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.kafinea.com\\\/en\\\/#website\",\"url\":\"https:\\\/\\\/www.kafinea.com\\\/en\\\/\",\"name\":\"Kafinea\",\"description\":\"Une solution unique pour toutes vos ambitions\",\"publisher\":{\"@id\":\"https:\\\/\\\/www.kafinea.com\\\/en\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.kafinea.com\\\/en\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/www.kafinea.com\\\/en\\\/#organization\",\"name\":\"Kafinea\",\"url\":\"https:\\\/\\\/www.kafinea.com\\\/en\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/www.kafinea.com\\\/en\\\/#\\\/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\\\/en\\\/#\\\/schema\\\/logo\\\/image\\\/\"},\"sameAs\":[\"https:\\\/\\\/www.linkedin.com\\\/company\\\/kafinea\\\/\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Help - The MCP Server &#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\/en\/help\/settings\/the-mcp-server\/","og_locale":"en_US","og_type":"article","og_title":"Help - The MCP Server &#8226; Kafinea","og_description":"Introduction The MCP server (Model Context Protocol) from Kafinea allows external AI clients (Claude Desktop, Cursor, Windsurf, VS Code, JetBrains\u2026) to connect to the ERP instance to query data via a standardized protocol. This page describes the technical architecture, security, and configuration of the MCP server for administrators. 1. Architecture The Kafinea MCP server is...","og_url":"https:\/\/www.kafinea.com\/en\/help\/settings\/the-mcp-server\/","og_site_name":"Kafinea","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.kafinea.com\/en\/help\/settings\/the-mcp-server\/","url":"https:\/\/www.kafinea.com\/en\/help\/settings\/the-mcp-server\/","name":"Help - The MCP Server &#8226; Kafinea","isPartOf":{"@id":"https:\/\/www.kafinea.com\/en\/#website"},"datePublished":"2026-04-13T00:04:17+00:00","breadcrumb":{"@id":"https:\/\/www.kafinea.com\/en\/help\/settings\/the-mcp-server\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.kafinea.com\/en\/help\/settings\/the-mcp-server\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.kafinea.com\/en\/help\/settings\/the-mcp-server\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Accueil","item":"https:\/\/www.kafinea.com\/en\/"},{"@type":"ListItem","position":2,"name":"The MCP Server"}]},{"@type":"WebSite","@id":"https:\/\/www.kafinea.com\/en\/#website","url":"https:\/\/www.kafinea.com\/en\/","name":"Kafinea","description":"Une solution unique pour toutes vos ambitions","publisher":{"@id":"https:\/\/www.kafinea.com\/en\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.kafinea.com\/en\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.kafinea.com\/en\/#organization","name":"Kafinea","url":"https:\/\/www.kafinea.com\/en\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.kafinea.com\/en\/#\/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\/en\/#\/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\/en\/author\/david\/"},"uagb_comment_info":0,"uagb_excerpt":"Introduction The MCP server (Model Context Protocol) from Kafinea allows external AI clients (Claude Desktop, Cursor, Windsurf, VS Code, JetBrains\u2026) to connect to the ERP instance to query data via a standardized protocol. This page describes the technical architecture, security, and configuration of the MCP server for administrators. 1. Architecture The Kafinea MCP server is...","_links":{"self":[{"href":"https:\/\/www.kafinea.com\/en\/wp-json\/wp\/v2\/docs\/444497","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.kafinea.com\/en\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.kafinea.com\/en\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.kafinea.com\/en\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/www.kafinea.com\/en\/wp-json\/wp\/v2\/comments?post=444497"}],"version-history":[{"count":0,"href":"https:\/\/www.kafinea.com\/en\/wp-json\/wp\/v2\/docs\/444497\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.kafinea.com\/en\/wp-json\/wp\/v2\/media?parent=444497"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www.kafinea.com\/en\/wp-json\/wp\/v2\/doc_category?post=444497"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.kafinea.com\/en\/wp-json\/wp\/v2\/doc_tag?post=444497"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}