Ga naar inhoud

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.

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.

Elk product heeft dezelfde vier meta-tools. Zo blijft het laadvolume klein, ook bij honderden operaties:

ToolWat het doet
search_toolsZoekt tools: eerst taaktools, en op verzoek de losse operaties
describe_toolGeeft het volledige invoerschema uit de OpenAPI-specificatie
execute_toolVoert de tool uit, met jouw rechten en dezelfde envelop
get_guideGeeft 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).

  • execute_tool is een dry run, tenzij je dryRun: false meegeeft.
  • Een actie die goedkeuring vraagt, geeft approval_required; de beslissing ligt bij een mens.
  • Een actie met niveau forbidden_for_agents bereikt het product niet.
  • Per aanroep komt er één auditregel: wie, organisatie, product, tool en uitkomst. Geen inhoud.
Terminal window
prudai mcp --check
prudai mcp connections list