Kennisbank als MCP-server
Het Model Context Protocol (MCP) is een open standaard waarmee AI-clients gereedschappen van externe systemen kunnen gebruiken. vragen.ai stelt je kennisbank beschikbaar als MCP-server, zodat een client zoals Claude zelf je kennisbank kan doorzoeken en documenten kan lezen. Zo gebruik je jouw eigen, betrouwbare content als bron binnen een AI-assistent, zonder daar een eigen koppeling voor te bouwen.
Endpoint
De MCP-server draait op je eigen subdomein en gebruikt HTTP als transport:
https://{klant}.vragen.ai/mcp/knowledge-base
Authenticatie
Standaard werkt de server met een API-token dat je in je vragen.ai-omgeving aanmaakt en beheert. Het token heeft de permissie Verbinden met MCP-server nodig, en je geeft het mee als Bearer-token, net als bij de REST API.
Een Owner bepaalt wie de MCP-server mag gebruiken. Dat staat bij Instellingen, tabblad Beveiligingsinstellingen, in de sectie Toegang (zie het dashboard). Er zijn twee keuzes:
- Alleen met een API-token met MCP-toegang, of een ondertekende link: een client zonder geldig token wordt geweigerd.
- Iedereen, zonder token: iedereen die de URL kent, kan je hele kennisbank doorzoeken en lezen. Kies dit alleen als alles in je kennisbank ook al openbaar is, zoals de pagina's van je eigen website.
Beschikbare tools
De server biedt een AI-client de volgende gereedschappen:
- Kennisbank doorzoeken: een semantische zoekopdracht in je kennisbank, zodat de client relevante passages ophaalt. De zoekterm is optioneel: met alleen filters vraagt de client een lijst documenten op, bijvoorbeeld alles uit één categorie. De resultaten komen per pagina van tien.
- Document lezen: (delen van) een gevonden document uitlezen om het volledige antwoord te onderbouwen.
- Filters en facetten opvragen (afhankelijk van je configuratie): de beschikbare filters en hun waarden ophalen, zodat de client gerichter kan zoeken.
Verbinden
In je MCP-client voeg je een server toe met de endpoint-URL hierboven en, als je server een token vraagt, je API-token als Bearer-token. De client ontdekt daarna zelf welke tools beschikbaar zijn. Voor je live gaat kun je de verbinding testen met een MCP-client of een MCP-inspector.
Support
Kom je er niet uit? Mail ons supportteam via service@vragen.ai.