Model Context Protocol voor Odoo.

Wat is Model Context Protocol?

Model Context Protocol is een open protocol waarmee AI-applicaties op een consistente manier verbinding maken met externe gegevens, tools en workflows.

Zonder een standaard zoals MCP wordt iedere combinatie van AI-model en bedrijfssysteem een afzonderlijke integratie. De interface voor model A naar systeem X wijkt dan af van model B naar hetzelfde systeem, terwijl een overstap naar een ander AI-platform opnieuw ontwikkelwerk vereist. MCP probeert dit integratieprobleem te verkleinen door de verbinding tussen AI-applicaties en externe systemen te standaardiseren.

MCP vervangt het onderliggende systeem niet. Odoo blijft verantwoordelijk voor gegevens, gebruikers, toegangsrechten en bedrijfslogica. De MCP-server vormt een gecontroleerde vertaallaag tussen de AI-client en de functies die aan die client beschikbaar worden gesteld.

Waarom bestaat MCP?

Een taalmodel heeft van zichzelf geen actuele toegang tot een Odoo-database. Het kent niet automatisch de huidige voorraad, openstaande facturen of rechten van een gebruiker. Om met actuele bedrijfsinformatie te werken, heeft de AI-applicatie een gecontroleerde verbinding met externe systemen nodig.

Traditioneel wordt zo’n verbinding per toepassing ontwikkeld. Een team definieert endpoints, toolbeschrijvingen, authenticatie, foutafhandeling en mappings voor ieder model of agentplatform. Dat werkt, maar leidt snel tot meerdere varianten van dezelfde koppeling.

MCP brengt een gemeenschappelijke laag aan. Daardoor kan een MCP-compatibele client met meerdere servers werken en kan één server zijn mogelijkheden beschikbaar stellen aan meerdere compatibele clients. De exacte ondersteuning en functionaliteit blijven afhankelijk van de gekozen client en implementatie.

Wat MCP wel en niet oplost

Hoe werkt de MCP-architectuur?

MCP gebruikt een host-, client- en servermodel. De gebruiker werkt in een AI-applicatie; de client onderhoudt de protocolverbinding; de server ontsluit gecontroleerde functies en context.

De host is de applicatie waarin de gebruiker met het AI-model werkt. De host kan één of meerdere MCP-clients bevatten. Iedere client onderhoudt een verbinding met een MCP-server. De server beschrijft welke mogelijkheden beschikbaar zijn en verwerkt verzoeken die binnen het toegestane beleid vallen.

Tools, resources en prompts

Niet iedere implementatie hoeft alle primitives te gebruiken. Voor een enterprise-Odoo-koppeling ligt de nadruk meestal op gecontroleerde tools en gestructureerde resultaten. Welke functies worden gepubliceerd, hoort een expliciete ontwerpbeslissing te zijn.

Hoe werkt MCP met Odoo?

In de DAADit-architectuur staat de MCP-server buiten de gebruikersinterface van Odoo. De server ontvangt gestandaardiseerde MCP-verzoeken, controleert de identiteit en het ingestelde beleid en vertaalt een toegestane actie naar een Odoo-operatie.

Voorbeeld van een tooldefinitie

// Eén van de tools die je AI-client krijgt na tools/list.
{
  "name": "odoo_search_read",
  "description": "Zoek en lees records in één call — de meest gebruikte tool voor vragen over je data.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "model": { "type": "string" },
      "domain": { "type": "array" },
      "fields": { "type": "array" },
      "limit":  { "type": "integer" }
    },
    "required": ["model"]
  }
}

De volledige toolset van de hosted server bestaat uit odoo_list_instances, odoo_list_models, odoo_fields_get, odoo_search, odoo_search_read, odoo_read, odoo_create, odoo_write en odoo_execute_kw. Welke daarvan een client daadwerkelijk ziet, bepaal je per omgeving en per gebruiker met capability gating; standaard staan alleen de alleen-lezen tools aan.

De server bepaalt niet zelfstandig wat de gebruiker bedoelt. De AI-client selecteert een tool op basis van de beschrijving en de interactie. Daarom moeten toolnamen, schema’s, foutmeldingen en autorisatie zorgvuldig worden ontworpen en getest.

MCP versus een traditionele REST API

MCP en REST zijn geen rechtstreekse alternatieven. Een MCP-server gebruikt vaak bestaande API’s of systeemmethodes om met het bronsysteem te communiceren. Het verschil zit vooral in de interface richting de AI-applicatie.

Een belangrijk architectuurprincipe is dat MCP bestaande autorisatie niet mag omzeilen. De MCP-laag hoort de rechten in Odoo te respecteren en kan aanvullend strengere scopes toepassen.

Security, privacy en governance

Een MCP-implementatie wordt niet veilig doordat het protocol wordt gebruikt. Veiligheid ontstaat door identiteit, minimale rechten, expliciete grenzen, gecontroleerde tools, logging en operationeel beheer.

Model gating en capability gating

Model gating bepaalt welke AI-clients of modellen toegang mogen krijgen tot een tenant of functiegebied. Capability gating beperkt welke categorieën acties beschikbaar zijn, bijvoorbeeld lezen, zoeken, creëren, wijzigen of specifieke methodes uitvoeren.

DAADit past deze begrippen toe als productbeleid boven op de bestaande Odoo-rechten. Een gebruiker kan nooit meer mogen dan de gekoppelde Odoo-identiteit, terwijl de MCP-laag de toegang verder kan beperken.

Logging en audit trail

Voor beheer en governance moet minimaal zichtbaar zijn welke gebruiker of service-identiteit een call startte, welke tool werd gekozen, welke tenant en omgeving betrokken waren, of de actie is toegestaan en of deze is geslaagd. Gevoelige promptinhoud en resultaten vragen een apart bewaarbeleid.

Logging is geen vervanging voor preventieve beveiliging. Het vormt de basis voor incidentonderzoek, gebruiksanalyse, foutopsporing en het verbeteren van tooldefinities.

Implementatie van DAADit Hosted MCP

De implementatie start niet bij een AI-model, maar bij de gewenste bedrijfsprocessen en de risicoklasse van de bijbehorende acties. Een informatievraag over voorraad vraagt een ander controleniveau dan het aanmaken of bevestigen van financiële boekingen.

Aanbevolen implementatiefasen

Dashboard en support

De klant krijgt een compact dashboard voor verbindingen, gebruikers, modellen, capabilities en activiteit. De complexe serverconfiguratie blijft onder beheer van DAADit. Wanneer een gebruiker een probleem meldt, kan de helpdesk de relevante omgeving, logging en configuratie onderzoeken. Een supportvraag kan daarbij vanuit dezelfde AI-assistent aan DAADit worden doorgezet.

Voorbeelden van Odoo MCP-toepassingen

De onderstaande voorbeelden illustreren verschillende niveaus van lezen, analyseren en uitvoeren. De definitieve toolset wordt per klant en persona ontworpen.

Meer uitgebreide businessverhalen kunnen worden opgenomen in de sectie Laat Odoo werken. Deze productpagina blijft bewust gericht op de technische werking en het beheer.

Gerelateerde documentatie en artikelen