MCP operationele tools
De tools achter de operatiedeur /mcpoperations: het werk dat een collega op een normale dag doet. Een reservering zoeken en bijwerken, een klant corrigeren, het tafelplan bedienen, gasten inchecken, uren schrijven. Een sleutel met scope operations opent deze deur; hoe je verbindt staat in Een AI-agent verbinden met de MCP-server. Instellen wat er te boeken is, gebeurt achter de configuratiedeur — zie MCP configuratie-tools.
Waarom dit een eigen deur is
Deze catalogus leest de hele klantenbestand. Een boekingssleutel wordt uitgedeeld aan derden — een voice-platform, de backend van een widget op de site van een klant — en dat is een ander vertrouwensniveau dan een collega die in het systeem werkt. De scope is de enige plek waar dat verschil kan worden vastgehouden vóórdat er ook maar één recht wordt geraadpleegd.
Niets achter deze deur is publiek: elke aanroep zonder ingelogde gebruiker wordt geweigerd, ook een leesaanroep.
Plan, toepassen en de bevestiging
Net als bij de configuratiedeur bestaat een schrijvende handeling uit ..._plan en ..._apply, met elk hun eigen recht. Bij de zwaarste handelingen komt daar een extra stap bij: het plan geeft een bevestigingstoken af dat het toepassen nodig heeft. Je kunt dus niet in één beweging een boeking verplaatsen of twee klanten samenvoegen — er zit met opzet een moment tussen waarop iemand het plan gezien kan hebben.
Dat geldt voor de tools met niveau 2 en 3 in de tabel: verplaatsen, deelnemers wijzigen, een betaling boeken, een walk-in aannemen, en het samenvoegen van klanten of bedrijven. Samenvoegen staat op het hoogste niveau omdat het niet terug te draaien is.
De tools
| Tools | Lezen/schrijven | Niveau | Omschrijving |
|---|---|---|---|
| search / day_overview / filter_columns | lezen | - | Zoeken over alles heen, het dagoverzicht, en welke kolommen je in een filter kunt gebruiken |
| booking_filter / booking_get | lezen | - | Reserveringen zoeken en één reservering met alle details opvragen |
| booking_create / booking_set_status / booking_set_remarks / booking_set_extras / booking_todo_add / booking_set_zone_preference | schrijven | 1 | Een reservering aanmaken en bijwerken: status, opmerkingen, extra opties, een taak, een zonevoorkeur |
| booking_move / booking_change_participants / booking_add_payment / booking_action | schrijven | 2 | Verplaatsen, aantal deelnemers wijzigen, een betaling boeken, een actie uitvoeren — allemaal met bevestiging, omdat de prijs meebeweegt |
| customer_filter / customer_get / company_filter / company_get | lezen | - | Klanten en bedrijven zoeken en opvragen |
| customer_create / customer_update / customer_set_status / customer_contact_add / company_create / company_update / company_set_status / company_contact_add / company_link_customer | schrijven | 1 | Klanten en bedrijven aanmaken en bijwerken, contactpersonen toevoegen, een klant aan een bedrijf koppelen |
| customer_merge / company_merge | schrijven | 3 | Twee dubbele records samenvoegen. Met bevestiging, en niet terug te draaien |
| floorplan_list / floorplan_tables / floorplan_occupancy | lezen | - | De plattegronden, hun tafels en de bezetting |
| table_queue / table_assign / table_unassign / table_move / table_lock | lezen/schrijven | 1 | Tafels toewijzen, vrijgeven, verplaatsen en blokkeren, en zien wat er nog wacht |
| guestlist_get / guestlist_set_presence | lezen/schrijven | 1 | De gastenlijst en gasten in- of uitchecken |
| walkin_options / walkin_create | lezen/schrijven | 2 | Kijken wat er vrij is voor een gast die zomaar binnenloopt, en die inschrijven |
| todo_list / statuscheck_list / customerstatuscheck_list / cancelrefundcheck_list | lezen | - | De werkvoorraad: taken, controles op status, en annuleringen die nog restitutie nodig hebben |
| call_list / chat_list / conversation_list / email_list / meet_list | lezen | - | Wat er binnenkwam: telefoon, chat, gesprekken, e-mail en afspraken |
| timesheet_status / work_activity_list / work_entry_list / work_entry_create / billable_list / billable_update | lezen/schrijven | 1 | Urenregistratie: de stand, de activiteiten, uren schrijven, en wat er doorbelast wordt |
De exacte, altijd actuele lijst met alle invoervelden vraag je op met tools/list op de deur zelf. Wat je terugkrijgt hangt af van je rechten en van welke modules de licentie heeft — zonder de tafelplanmodule zijn de tafel- en gastenlijsttools er eenvoudigweg niet.
BETA. Deze deur is nieuw en wordt nog doorontwikkeld. Toolnamen, invoervelden en niveaus kunnen tussen releases wijzigen zonder overgangsperiode. Gebruik de plan-variant voordat je iets toepast, en bouw er nog geen productie-integratie op die niet stuk mag.
