Developer · AI
Wat is de Billnado MCP-server?
Overzicht van de Billnado MCP-server voor visuele chatbots, met tools, authenticatie en administraties.
Bijgewerkt op 23 augustus 2026
De Billnado MCP-server (Model Context Protocol) geeft compatibele AI-clients gecontroleerde toegang tot Billnado-tools en productdocumentatie. Een gebruiker kan daardoor in gewone taal informatie opzoeken over administraties, relaties en licenties. De AI-client bepaalt op basis van de vraag welke tool nodig is; de server blijft verantwoordelijk voor authenticatie en toegangscontrole.
Deze documentatie behandelt alleen visuele chatbots. AI-codeertools, CLI-clients en IDE-extensies vallen buiten deze documentatie.
Verbindingsgegevens
| Onderdeel | Waarde |
|---|---|
| Transport | Streamable HTTP |
| Primaire endpoint | https://mcp.billnado.be/mcp |
| Alternatieve endpoint | https://mcp.facturatie-systeem.be/mcp |
| Authenticatie | OAuth 2.0 met PKCE |
| Tooldocumentatie | mcp.billnado.be/documentation |
| Healthcheck | mcp.billnado.be/health |
Gebruik voor een nieuwe koppeling bij voorkeur de primaire endpoint. De alternatieve endpoint biedt dezelfde server onder het domein van Facturatie Systeem.
De server publiceert OAuth Protected Resource Metadata. Clients die OAuth-discovery en Dynamic Client Registration ondersteunen, kunnen de aanmelding daarom automatisch starten. Meld je tijdens die flow aan met je gewone Billnado-account. Deel geen wachtwoord, access token of refresh token in een prompt of configuratiebestand.
Beschikbare mogelijkheden
De actuele tools en hun invoer- en uitvoervelden staan altijd in de live tooldocumentatie. Op hoofdlijnen biedt de server:
- Administraties: toegankelijke administraties zoeken, de actieve administratie raadplegen en expliciet verbinding maken via directe, accountant- of supporttoegang.
- Relaties: klanten, leveranciers en prospecten zoeken en de volledige gegevens van één relatie opvragen.
- Licenties: de actieve licentie en historische, huidige of toekomstige licenties raadplegen.
- Documentatie: beschikbare talen opvragen, Billnado-documentatie doorzoeken en een volledig Markdown-artikel ophalen.
Vrijwel alle tools zijn alleen-lezen. subscriber_connect is de uitzondering: deze idempotente tool kan, na een expliciete vraag van de gebruiker, de bestaande accountant- of supportverbinding aanmaken die nodig is om een administratie te gebruiken.
Werken met administraties
Zonder extra header gebruikt Billnado de standaardadministratie van het aangemelde account, of anders de eerste toegankelijke administratie.
Voor een andere administratie volgt een AI-client normaal deze stappen:
- Roep
subscribers_listaan om een administratie en de beschikbare toegangsroute te vinden. - Roep
subscriber_connectalleen aan wanneer de gebruiker expliciet vraagt om met die administratie te verbinden. - Gebruik de teruggegeven waarde als HTTP-header
SubscriberIdbij volgende MCP-verzoeken.
Een MCP-tool kan de transportconfiguratie van de client niet zelf aanpassen. Wanneer de client headers niet tijdens een sessie kan wijzigen, voeg je SubscriberId toe in de clientconfiguratie en maak je opnieuw verbinding. Gebruik alleen een ID die subscribers_list voor het aangemelde account teruggeeft; niet-toegankelijke administraties leveren een foutmelding op.
Richtlijnen voor visuele chatbots
- Laat de client eerst zoeken en daarna details ophalen: bijvoorbeeld
relations_searchvóórrelations_getendocumentation_searchvóórdocumentation_get. - Laat de gebruiker bevestigen over welke administratie het gaat wanneer meerdere resultaten mogelijk zijn.
- Behandel toolresultaten als financiële en persoonsgegevens. Neem alleen noodzakelijke gegevens op in prompts, logs en antwoorden.
- Baseer integraties op toolnamen en gestructureerde resultaten uit MCP, niet op het uitlezen van de publieke documentatiepagina.
- Controleer de toolannotaties en parameters opnieuw wanneer de server wijzigt; de live tooldocumentatie wordt uit dezelfde geregistreerde tools gegenereerd.
Updates en opgeslagen snapshots
Visuele chatbots zoals ChatGPT kunnen bij het verbinden een snapshot van de beschikbare MCP-tools en hun invoervelden opslaan. Werk daarom bij iedere wijziging aan de MCP-tools ook de live tooldocumentatie, de relevante chatbotconnector en deze documentatie bij. Vernieuw of verbind de connector daarna opnieuw en start zo nodig een nieuw gesprek, zodat de chatbot de actuele tools inlaadt.
Voorbeeldvragen
- “Zoek klant Acme en toon het btw-nummer en primaire e-mailadres.”
- “Welke administraties kan ik openen?”
- “Toon de actieve licentie en de huidige gebruikslimieten.”
- “Zoek in de Nederlandstalige Billnado-documentatie hoe ik toegang krijg tot de API.”
Kies voor de installatie de gids die bij je client hoort: