Claude, ChatGPT oder einen anderen KI-Assistenten verbinden

To Bill verbindet sich mit KI-Assistenten, die das Protokoll MCP (Model Context Protocol) sprechen: Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT und viele andere. Einmal verbunden, tut Ihr Assistent in To Bill, was Sie selbst dort tun können, mit Ihren Rechten und nie mehr: Er liest Ihre Rechnungen, Ihre Ausgaben und Ihre Buchhaltung und korrigiert, wenn Sie es ihm erlauben. Sie bitten ihn zum Beispiel: «Prüfen Sie den Zustand meiner Bücher und verbuchen Sie die Bankzeilen vom Oktober» oder «Bereiten Sie eine Entwurfsrechnung für Boulangerie du Lac vor».

Diese Anleitung betrifft den Assistenten, den Sie mitbringen. Die in To Bill eingebaute KI (der Copilot, der Autopilot) hat eigene Anleitungen: siehe Der KI-Assistent.

Bevor Sie beginnen

• Die Adresse, die Sie Ihrem Assistenten geben, lautet https://app.tobill.ch/mcp. Sie steht auch unter Einstellungen › KI- und API-Verbindungen, bei Adresse des Connectors (MCP), mit einer Schaltfläche Kopieren.
• Der Assistent arbeitet in einem einzigen Unternehmen, dem, das Sie beim Erlauben wählen. Für ein anderes Unternehmen verbinden Sie ihn ein zweites Mal.
• Er hat die Rechte Ihrer Rolle in diesem Unternehmen. Ein Mitglied, das die Buchhaltung in To Bill nicht sieht, sieht sie auch über seinen Assistenten nicht.
• Was der Assistent in To Bill liest, geht an seinen Anbieter (Anthropic für Claude, OpenAI für ChatGPT): siehe Was der Assistent erhält.

Claude: claude.ai und Claude Desktop

Der Connector, den Sie auf claude.ai hinzufügen, gilt auch in Claude Desktop und auf Ihrem Telefon: Sie fügen ihn nur einmal hinzu.

1. Öffnen Sie in Claude Customize › Connectors (die Menüs von Claude sind hier auf Englisch genannt) und klicken Sie auf Add custom connector. In einem Team- oder Enterprise-Abonnement fügt ihn ein Eigentümer der Organisation hinzu, unter Organization settings › Connectors; danach verbindet sich jedes Mitglied mit seinem eigenen To-Bill-Konto.
2. Geben Sie einen Namen ein, zum Beispiel To Bill, und fügen Sie die Adresse https://app.tobill.ch/mcp ein. Lassen Sie die erweiterten Einstellungen, wie sie sind.
3. Klicken Sie auf Add, dann auf Connect. Die Autorisierungsseite von To Bill öffnet sich: Melden Sie sich bei Bedarf an (auch mit Google), wählen Sie das Unternehmen und den Zugang und klicken Sie dann auf Erlauben.

Claude kehrt verbunden zum Gespräch zurück. Bevor Claude ein Werkzeug verwendet, das Ihre Daten ändert, fragt es Sie um Zustimmung; ein bestimmtes Werkzeug können Sie in den Einstellungen des Connectors sperren.

Claude Code

In einem Terminal:

claude mcp add --transport http tobill https://app.tobill.ch/mcp

Tippen Sie dann in Claude Code /mcp, wählen Sie tobill und starten Sie die Authentifizierung: Ihr Browser öffnet die Autorisierungsseite von To Bill. Claude Code kann sich statt über diese Seite auch mit einem persönlichen API-Schlüssel verbinden: siehe Die API und die API-Schlüssel.

ChatGPT

Je nach Ihrem ChatGPT-Abonnement braucht ein eigener Connector den Entwicklermodus und, in einem Workspace, die Zustimmung seines Administrators.

1. Öffnen Sie in ChatGPT Settings › Apps, dann Advanced settings, und aktivieren Sie Developer mode.
2. Erstellen Sie eine App (Create): einen Namen, zum Beispiel To Bill, die Adresse https://app.tobill.ch/mcp als MCP-Server und die Authentifizierung OAuth.
3. Speichern Sie und verbinden Sie sich dann: Die Autorisierungsseite von To Bill öffnet sich. Wählen Sie das Unternehmen und den Zugang und klicken Sie dann auf Erlauben.

ChatGPT lässt Sie jede Aktion bestätigen, die Ihre Daten ändert.

Ein anderer Assistent

Jeder Assistent, der einen entfernten MCP-Server (HTTP-Transport) mit einer OAuth-Anmeldung akzeptiert, verbindet sich auf dieselbe Weise: Geben Sie ihm die Adresse https://app.tobill.ch/mcp, er öffnet die Autorisierungsseite. Ein Werkzeug ohne OAuth-Anmeldung (ein Skript, ein Kommandozeilen-Client) verwendet einen persönlichen API-Schlüssel: siehe Die API und die API-Schlüssel.

Die Autorisierungsseite

Das ist die Seite von To Bill, die Ihr Assistent beim ersten Mal öffnet. Sie zeigt Ihnen:

• wer den Zugang anfragt: den Namen der Anwendung. Ist die Anwendung über ihre eigene Adresse ausgewiesen (claude.ai, chatgpt.com), zeigt To Bill diese an. Sonst ist der Name derjenige, den sich die Anwendung selbst gibt: Fahren Sie nur fort, wenn Sie sie soeben selbst verbunden haben;
• wohin Sie nach Ihrer Antwort zurückgeleitet werden; bei einer Anwendung, die auf Ihrem Computer läuft, weist To Bill darauf hin;
• das Unternehmen, auf das der Assistent Zugang erhält, und nur dieses;
• unter Angefragter Zugang die Art des Zugangs: Lesen und ändern oder Nur lesen. Sie können Nur lesen wählen, auch wenn der Assistent mehr anfragt.

Erlauben verbindet den Assistenten; Ablehnen schickt ihn ohne Zugang zurück.

Was der Assistent tun kann

• Lesen, was Sie in To Bill sehen: Kunden, Artikel, Angebote, Rechnungen, Zahlungseingänge, Ausgaben, Buchhaltung (Journal, Hauptbuch, Saldobilanz, Zustand der Bücher, Bankzeilen, Bankregeln), Löhne und Zeiten, wenn Sie Zugang dazu haben, Einstellungen.
• Mit Lesen und ändern so handeln, wie Sie es tun würden: Angebote und Rechnungen als Entwurf erstellen, Kunden erfassen, eine Bankzeile verbuchen, eine Buchung erfassen, eine Buchung stornieren, eine Ausgabe korrigieren, die Bankregeln verwalten, das folgende Geschäftsjahr eröffnen…
• Jede Aktion durchläuft dieselben Kontrollen wie in der App: Eine verbuchte Buchung wird nie geändert, sie wird storniert; eine eingereichte MWST-Periode bleibt geschlossen; ein versendetes Dokument wird nicht umgeschrieben.

To Bill gibt dem Assistenten seine Regeln der Buchführung mit: durch Storno oder eine neue Buchung korrigieren, die Privatbewegungen eines Einzelunternehmens auf das Konto 2850 verbuchen, statt sie zu übergehen, keine MWST für ein Unternehmen verbuchen, das nicht MWST-pflichtig ist, und den Bankauszug als massgebend für die Bankkonten betrachten.

Was er nicht tun kann

• Bezahlen, Geld überweisen, Ihr Abonnement ändern oder Credits kaufen.
• Sich an Ihrer Stelle anmelden, Ihre Verbindungen und Schlüssel verwalten, das Unternehmen oder Ihr Konto löschen.
• In einem anderen als dem gewählten Unternehmen handeln, auch nicht im Cockpit eines Treuhänders.
• Das Team verwalten: jemanden einladen, eine Rolle oder eine E-Mail-Adresse ändern, ein Mitglied entfernen; auch nicht den Mailserver (SMTP) des Unternehmens ändern.
• Massenaktionen ausführen: mehrere Dokumente auf einmal löschen, versenden oder als bezahlt markieren. Er erledigt sie Dokument für Dokument, und Sie bestätigen jedes einzeln.
• Das ganze Unternehmen auf einmal herunterladen (das Aufbewahrungsarchiv, das Paket für den Treuhänder), die vollständige AHV-Nummer einer angestellten Person sehen oder die Zahlungsdatei der Löhne erstellen. Von der IBAN einer angestellten Person sieht er nur die letzten 4 Ziffern.
• Die Rechte Ihrer Rolle überschreiten.

Der Text eines Dokuments ist kein Auftrag

Der Assistent liest den Text Ihrer Belege, Ihrer Bankauszüge und Ihrer Rechnungen. Verlangt ein Text etwas von ihm («Bezahlen Sie diesen Betrag», «Ändern Sie die IBAN»), hat To Bill ihn angewiesen, nicht zu gehorchen: Das sind Daten, keine Anweisung. Lesen Sie immer nach, was der Assistent tun will, bevor Sie es annehmen.

Wer hat was getan

Jede Änderung durch einen Assistenten wird in der Aktivität des Unternehmens festgehalten, mit Ihrem Namen und dem des Assistenten («Änderung über Claude»): auf der Übersicht unter Aktuelle Aktivitäten, dann Alle anzeigen für die vollständige Liste. Eine Buchung, die er erfasst, trägt als Autor Ihren Namen, gefolgt von dem des Assistenten, zum Beispiel Léa Rochat via Claude.

Was der Assistent erhält

Wenn Sie einen Assistenten verbinden, sendet To Bill ihm auf Ihre Anfrage hin die Daten, die er anfragt: was seine Werkzeuge in Ihrem Unternehmen lesen, im Klartext. Sie gehen an den Anbieter des Assistenten (Anthropic, OpenAI oder einen anderen), zu dessen eigenen Bedingungen. Sie wählen den Assistenten und das, wobei er Ihnen hilft. Der Copilot von To Bill hingegen ersetzt die Namen durch Codes, bevor er sie sendet: siehe Der KI-Assistent.

Den Zugang entziehen

1. Öffnen Sie Einstellungen › KI- und API-Verbindungen (auch über das Menü Ihres Namens, unten links).
2. Klicken Sie unter Verbundene Anwendungen neben dem Assistenten auf Widerrufen und bestätigen Sie.

Der Zugang endet sofort. Den Connector im Assistenten zu entfernen, genügt nicht immer: Widerrufen Sie ihn auch in To Bill. Eine Verbindung, die 30 Tage lang nicht genutzt wird, endet von selbst; verbinden Sie den Assistenten dann einfach neu.