Was ist der Billnado MCP-Server?

Der Billnado MCP-Server (Model Context Protocol) gibt kompatiblen KI-Clients Zugang zu Billnado-Daten, Aktionen und Produktdokumentation. Sie können Informationen abfragen und unterstützte Änderungen in natürlicher Sprache anfordern. Billnado prüft Ihr Konto, den Zugang zur gewählten Verwaltung und die Bedingungen jeder Aktion.

Diese Leitfäden behandeln visuelle Chatbots und die lokale Codex-App. CLI-Clients und IDE-Erweiterungen bleiben außerhalb ihres Umfangs.

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, Parameter und Annotationen stehen in der Live-Tool-Dokumentation. Zu den Möglichkeiten gehören:

Thema	Möglichkeiten
Verwaltungen	Zugängliche Verwaltungen suchen, die aktive Verwaltung abrufen und auf Wunsch eine verfügbare Buchhalter- oder Supportverbindung herstellen.
Geschäftsbeziehungen und Produkte	Daten suchen und abrufen, erstellen und ändern sowie unterstützte Archivaktionen ausführen.
Verkaufs- und Einkaufsdokumente	Dokumente suchen, abrufen, erstellen, ändern und bestätigen; unterstützte Kopier-, Umwandlungs-, Zahlungs- und Exportaktionen ausführen.
Finanzielle Nachverfolgung	Zahlungen erfassen, offene Beträge abstimmen und verfügbare Bank-, Cashflow- und Kassenbuchinformationen abrufen.
Projekte und Einstellungen	Unterstützte Projektdaten, Verwaltungseinstellungen und andere Bereiche mit den vom Client angebotenen Tools verwalten.
Lizenzen	Definitionen sowie aktuelle und frühere Lizenzen abrufen und den Preis eines Tarifwechsels berechnen. Kaufen oder ändern Sie Lizenzen und verwalten Sie Verlängerungen auf Meine Lizenz; MCP-Lizenztools sind schreibgeschützt.
Dokumentation	Sprachen und Artikel suchen, vollständige Artikel abrufen und kontextbezogene Seitenhilfe anfordern.

Der Server bietet Lese- und Schreibaktionen. Schreibaktionen können Daten erstellen, ändern oder löschen oder eine echte E-Mail, Peppol-Übermittlung oder Buchhaltungsverarbeitung starten. Verfügbare Aktionen hängen auch von Rechten, Lizenz und Clienteinstellungen ab.

Achtung: Prüfen Sie vor einer Schreibaktion Verwaltung, Dokument, Daten und Folgen. Eine Zahlungserfassung oder Abstimmung erfasst finanzielle Verarbeitung und führt keine Banküberweisung aus. E-Mail- und Peppol-Versand haben dagegen einen externen Empfänger.

Mit Verwaltungen arbeiten

Ohne subscriberId verwendet ein verwaltungsbezogenes Tool die Standardverwaltung Ihres Kontos oder andernfalls die erste zugängliche Verwaltung. Für eine andere Verwaltung:

1. Lassen Sie subscribers_list zugängliche Verwaltungen und den Zugriffsweg ermitteln.
2. Wählen Sie die gewünschte Verwaltung. Fordern Sie subscriber_connect nur ausdrücklich an, wenn eine Buchhalter- oder Supportverbindung noch hergestellt werden muss.
3. Lassen Sie den Client die gewählte ID bei jedem folgenden verwaltungsbezogenen Tool-Aufruf als optionalen Parameter subscriberId übergeben.

Ein HTTP-Header SubscriberId oder erneutes Verbinden ist nicht erforderlich. Die Wahl gilt je Aufruf und ändert die Standardverwaltung Ihres Kontos nicht. Der Client muss den Parameter auch bei Folgefragen übergeben. Billnado prüft eine aktive Zugriffsverbindung; eine gefundene ID gewährt keinen Zugang. Allgemeine und kontoweite Tools nutzen diesen Parameter nicht.

Richtlinien für visuelle Chatbots

• Suchen Sie zuerst und rufen Sie anschließend Details ab: Verwenden Sie beispielsweise relations_search vor relations_get und documentation_search vor documentation_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.

Veraltete Tools aktualisieren

Wie neue Tools verfügbar werden, hängt vom Client ab. Bei einer gespeicherten Liste aktualisieren Sie den Connector oder lassen den Administrator seine Aktionen aktualisieren. Starten Sie bei Bedarf ein neues Gespräch. Eine erneute Anmeldung aktualisiert nicht bei jedem Client die genehmigten Tool-Definitionen.

ChatGPT-Workspaces nutzen einen genehmigten Snapshot: Der Administrator muss geänderte Aktionen aktualisieren und erlauben. Microsoft 365 Copilot erkennt Tools bei der dynamischen Standardkonfiguration während der Nutzung; eine feste Auswahl erfordert eine Manifeständerung und erneute Veröffentlichung. Folgen Sie dem passenden Clientleitfaden unten.

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:

• Billnado mit ChatGPT verbinden
• Billnado mit Claude verbinden
• Billnado mit Grok verbinden
• Billnado mit Microsoft 365 Copilot verbinden