MCP
Eén gateway voor alle producten, met één login. Elk product heeft een eigen eindpunt onder dezelfde OAuth-koppeling:
https://mcp.prudai.com/mcp/<product>https://mcp.prudai.com/mcp is een overzicht met de eindpunten per product.
Inloggen
Section titled “Inloggen”De gateway is een OAuth-resource-server (RFC 9728) met Keycloak als autorisatieserver. Je koppelt een assistent met je eigen Prudai-account; er is geen sleutel per product. Per aanroep wisselt de gateway je token voor een kortlevend token voor dat ene product, met jouw rechten. Zie Inloggen.
De tools
Section titled “De tools”Elk product heeft dezelfde vier meta-tools. Zo blijft het laadvolume klein, ook bij honderden operaties:
| Tool | Wat het doet |
|---|---|
search_tools | Zoekt tools: eerst taaktools, en op verzoek de losse operaties |
describe_tool | Geeft het volledige invoerschema uit de OpenAPI-specificatie |
execute_tool | Voert de tool uit, met jouw rechten en dezelfde envelop |
get_guide | Geeft de handleiding voor dit product |
Taaktools combineren meerdere /v1-aanroepen in de taal van de gebruiker. Elk resultaat zegt wat bekend is, wat niet (notIncluded) en wat de logische vervolgstappen zijn (next).
Schrijven
Section titled “Schrijven”execute_toolis een dry run, tenzij jedryRun: falsemeegeeft.- Een actie die goedkeuring vraagt, geeft
approval_required; de beslissing ligt bij een mens. - Een actie met niveau
forbidden_for_agentsbereikt het product niet. - Per aanroep komt er één auditregel: wie, organisatie, product, tool en uitkomst. Geen inhoud.
Controleren vanuit de CLI
Section titled “Controleren vanuit de CLI”prudai mcp --checkprudai mcp connections list