Die API und die API-Schlüssel
Ein Assistent wie Claude oder ChatGPT verbindet sich über die Autorisierungsseite von To Bill: siehe KI-Assistenten verbinden. Ein Werkzeug ohne diese Seite, ein Skript, ein MCP-Client für die Kommandozeile oder eine Automatisierung, verwendet einen persönlichen API-Schlüssel. Diese Seite erklärt die Schlüssel und nennt die technischen Adressen.
Die Adressen
| Was | Adresse |
|---|---|
| MCP-Server (KI-Assistenten) | https://app.tobill.ch/mcp |
| API von To Bill | https://app.tobill.ch/api/… |
| OAuth-Discovery | https://app.tobill.ch/.well-known/oauth-authorization-server |
| API-Referenz (Beta) | https://docs.tobill.ch/api |
Der MCP-Server gibt dem Assistenten gebrauchsfertige Werkzeuge für die Buchhaltung und die Fakturierung, dazu zwei Werkzeuge, die den ganzen Rest von To Bill öffnen: Das eine sucht die richtige Route der API, das andere ruft sie auf, mit denselben Kontrollen wie die App.
Die API-Referenz beschreibt jede Route, die ein Schlüssel öffnet, mit ihren Parametern, Antworten und Beispielen; in der interaktiven Fassung können Sie eine Anfrage mit Ihrem Schlüssel ausprobieren.
Einen Schlüssel erstellen
- Öffnen Sie Einstellungen › KI- und API-Verbindungen.
- Klicken Sie unter Persönliche API-Schlüssel auf Schlüssel erstellen.
- Geben Sie unter Name an, wofür er dient, wählen Sie unter Zugang die Art des Zugangs (Nur lesen oder Lesen und ändern) und unter Gültigkeit die Dauer (30, 90 oder 365 Tage) und klicken Sie dann auf Schlüssel erstellen.
- Kopieren Sie den Schlüssel: Er wird nur einmal angezeigt. Klicken Sie dann auf Ich habe den Schlüssel kopiert.
Der Schlüssel beginnt mit tb_pk_. Er öffnet das Unternehmen, in dem Sie beim Erstellen waren, mit Ihren Rechten in diesem Unternehmen. Die Liste zeigt danach seinen Anfang, seinen Zugriff, sein Unternehmen, sein Ablaufdatum und seine letzte Verwendung, nie den ganzen Schlüssel.
Ein Schlüssel ist ein Passwort
Wer den Schlüssel hat, handelt in To Bill in Ihrem Namen. Legen Sie ihn weder in eine E-Mail noch in ein geteiltes Dokument noch in ein Code-Repository. Einen verlorenen Schlüssel widerrufen Sie sofort (siehe unten) und ersetzen ihn durch einen neuen.
Den Schlüssel senden
Jede Anfrage trägt den Schlüssel im HTTP-Header Authorization, als Bearer-Token:
curl https://app.tobill.ch/api/clients -H "Authorization: Bearer tb_pk_…"Claude Code mit einem Schlüssel
claude mcp add --transport http tobill https://app.tobill.ch/mcp --header "Authorization: Bearer tb_pk_…"Was ein Schlüssel öffnet und was nicht
- Mit Nur lesen liest der Schlüssel nur: Jede Änderung wird abgelehnt.
- Mit Lesen und ändern tut er, was Sie im Unternehmen tun können, mit denselben Kontrollen wie die App, und nie mehr als die Rechte Ihrer Rolle.
- Er öffnet weder die Anmeldung bei Ihrem Konto noch das Abonnement, die Zahlungen, die Verwaltung der Verbindungen und Schlüssel, ein anderes Unternehmen oder das Cockpit eines Treuhänders.
- Jede Änderung mit dem Schlüssel wird in der Aktivität des Unternehmens unter dem Namen festgehalten, den Sie ihm gegeben haben.
- To Bill begrenzt die Zahl der Anfragen pro Minute und pro Schlüssel; darüber hinaus lehnt es die Anfragen eine Zeit lang ab, und das Werkzeug muss warten, bevor es es erneut versucht.
Einen Schlüssel widerrufen
Klicken Sie unter Einstellungen › KI- und API-Verbindungen neben dem Schlüssel auf Widerrufen und bestätigen Sie. Er funktioniert ab sofort nicht mehr. Ein abgelaufener Schlüssel bleibt in der Liste, als Abgelaufen markiert, bis Sie ihn widerrufen.