Developer · AI
Was ist der Billnado MCP-Server?
Überblick über den Billnado MCP-Server für visuelle Chatbots, einschließlich Tools, Authentifizierung und Verwaltungen.
Aktualisiert am 23. August 2026
Der Billnado MCP-Server (Model Context Protocol) ermöglicht kompatiblen KI-Clients einen kontrollierten Zugriff auf Billnado-Tools und die Produktdokumentation. Benutzer können in natürlicher Sprache Informationen zu Verwaltungen, Geschäftsbeziehungen und Lizenzen abfragen. Der KI-Client wählt anhand der Frage das passende Tool aus; der Server bleibt für Authentifizierung und Zugriffskontrolle verantwortlich.
Diese Dokumentation gilt ausschließlich für visuelle Chatbots. KI-Codierwerkzeuge, CLI-Clients und IDE-Erweiterungen sind nicht Bestandteil dieser Dokumentation.
Verbindungsdaten
| Element | Wert |
|---|---|
| Transport | Streamable HTTP |
| Primärer Endpunkt | https://mcp.billnado.be/mcp |
| Alternativer Endpunkt | https://mcp.facturatie-systeem.be/mcp |
| Authentifizierung | OAuth 2.0 mit PKCE |
| Tool-Dokumentation | mcp.billnado.be/documentation |
| Statusprüfung | mcp.billnado.be/health |
Verwenden Sie für neue Verbindungen vorzugsweise den primären Endpunkt. Der alternative Endpunkt stellt denselben Server unter der Domain von Facturatie Systeem bereit.
Der Server veröffentlicht OAuth Protected Resource Metadata. Clients mit Unterstützung für OAuth-Erkennung und Dynamic Client Registration können die Anmeldung daher automatisch starten. Melden Sie sich mit Ihrem normalen Billnado-Konto an. Geben Sie niemals ein Passwort, Access Token oder Refresh Token in einem Prompt oder einer Konfigurationsdatei weiter.
Verfügbare Funktionen
Die aktuellen Tools und ihre Ein- und Ausgabefelder finden Sie jederzeit in der Live-Tool-Dokumentation. Der Server bietet im Wesentlichen:
- Verwaltungen: zugängliche Verwaltungen suchen, die aktive Verwaltung abrufen und ausdrücklich über direkten, Buchhalter- oder Supportzugriff verbinden.
- Geschäftsbeziehungen: Kunden, Lieferanten und Interessenten suchen und die vollständigen Daten einer Geschäftsbeziehung abrufen.
- Lizenzen: die aktive Lizenz abrufen und vergangene, aktuelle oder zukünftige Lizenzen durchsuchen.
- Dokumentation: verfügbare Sprachen auflisten, die Billnado-Dokumentation durchsuchen und einen vollständigen Markdown-Artikel abrufen.
Fast alle Tools sind schreibgeschützt. subscriber_connect ist die Ausnahme: Nach einer ausdrücklichen Benutzeranfrage kann dieses idempotente Tool die bestehende Buchhalter- oder Supportverbindung erstellen, die für die Nutzung einer Verwaltung erforderlich ist.
Mit Verwaltungen arbeiten
Ohne zusätzlichen Header verwendet Billnado die Standardverwaltung des angemeldeten Kontos oder andernfalls die erste zugängliche Verwaltung.
Für eine andere Verwaltung führt ein KI-Client normalerweise diese Schritte aus:
subscribers_listaufrufen, um die Verwaltung und den verfügbaren Zugriffsweg zu finden.subscriber_connectnur aufrufen, wenn der Benutzer ausdrücklich die Verbindung zu dieser Verwaltung verlangt.- Den zurückgegebenen Wert bei folgenden MCP-Anfragen als HTTP-Header
SubscriberIdsenden.
Ein MCP-Tool kann die Transportkonfiguration des Clients nicht selbst ändern. Kann der Client Header nicht während einer Sitzung ändern, fügen Sie SubscriberId zur Clientkonfiguration hinzu und stellen Sie die Verbindung erneut her. Verwenden Sie nur eine ID, die subscribers_list für das angemeldete Konto zurückgibt; eine nicht zugängliche Verwaltung führt zu einem Fehler.
Richtlinien für visuelle Chatbots
- Suchen Sie zuerst und rufen Sie anschließend Details ab: Verwenden Sie beispielsweise
relations_searchvorrelations_getunddocumentation_searchvordocumentation_get. - Lassen Sie den Benutzer die Verwaltung bestätigen, wenn mehrere Ergebnisse möglich sind.
- Behandeln Sie Tool-Ergebnisse als Finanz- und personenbezogene Daten. Nehmen Sie nur erforderliche Informationen in Prompts, Protokolle und Antworten auf.
- Bauen Sie Integrationen auf MCP-Toolnamen und strukturierten Ergebnissen auf, nicht auf dem Auslesen der öffentlichen Dokumentationsseite.
- Prüfen Sie Tool-Annotationen und Parameter nach Serveränderungen erneut; die Live-Dokumentation wird aus denselben registrierten Tools erzeugt.
Aktualisierungen und gespeicherte Snapshots
Visuelle Chatbots wie ChatGPT können beim Verbinden einen Snapshot der verfügbaren MCP-Tools und ihrer Eingabefelder speichern. Aktualisieren Sie deshalb bei jeder Änderung an den MCP-Tools auch die Live-Tooldokumentation, den betreffenden Chatbot-Connector und diese Dokumentation. Aktualisieren oder verbinden Sie den Connector anschließend erneut und starten Sie bei Bedarf ein neues Gespräch, damit der Chatbot die aktuellen Tools lädt.
Beispielfragen
- „Suchen Sie den Kunden Acme und zeigen Sie Umsatzsteuer-Identifikationsnummer und primäre E-Mail-Adresse.“
- „Auf welche Verwaltungen kann ich zugreifen?“
- „Zeigen Sie die aktive Lizenz und die aktuellen Nutzungslimits.“
- „Suchen Sie in der deutschen Billnado-Dokumentation, wie ich auf die API zugreife.“
Wählen Sie den Installationsleitfaden für Ihren Client: