Themen
Klausi mit Claude & ChatGPT verbinden
Über das Model Context Protocol (MCP) dürfen freigegebene KI-Clients dein Klausi-Konto lesen oder aktualisieren – mit klaren Berechtigungen und jederzeit widerrufbar.
Auf dieser Seite
- Was MCP macht
- Claude oder Claude Desktop verbinden
- ChatGPT verbinden
- Andere MCP-Clients mit Zugriffstoken
- Was danach möglich ist
- Berechtigungen und tatsächliche Wirkung
- Risiken und sichere Nutzung
- Öffentlicher Werkzeugkatalog
- Rate Limits, Fehler und Support
- Zugriff jederzeit widerrufen
- Sicherheit & Datenschutz
- Problembehebung
- Offizielle Anbieter-Dokumentation
Was MCP macht
MCP ist ein offener Standard, über den ein KI-Client klar definierte Klausi-Werkzeuge aufruft. Das Modell erhält nicht automatisch dein gesamtes Konto: Es fordert einzelne Werkzeuge passend zu deiner Frage an – begrenzt durch deine Freigaben.
Vor dem Start
- Ein Klausi-Konto mit Zugriff auf Einstellungen → Integrationen → MCP.
- Ein unterstützter KI-Tarif: Claude Free (ein Custom Connector), Pro, Max, Team oder Enterprise; vollständiges ChatGPT-MCP inklusive Schreibaktionen benötigt derzeit Business oder Enterprise/Edu sowie Workspace-Freigabe.
Hinweis: Claude und ChatGPT sehen nicht bei jedem Konto genau gleich aus. Manche Menüs können deshalb anders heißen oder an einer anderen Stelle stehen. Wenn du einen Schritt nicht findest, nutze die offiziellen Anleitungen am Ende dieser Seite.
Claude oder Claude Desktop verbinden
Claude bindet Klausi als entfernten Custom Connector per OAuth an. Derselbe Connector-Weg gilt im Web und in Claude Desktop – dieser Remote-Server gehört nicht in die claude_desktop_config.json.
MCP-Einstellungen in Klausi öffnen
Gehe in Klausi zu Einstellungen → Integrationen → MCP. Kopiere den unten gezeigten offiziellen Endpoint. Vertraue nur der Domain klausi.app.
Remote Connector in Claude hinzufügen
Öffne Customize → Connectors → + → Add custom connector. Owner bei Team und Enterprise nutzen Organization settings → Connectors. Trage „Klausi“ und den Endpoint ein. Wähle Add.
Verbinden und Zugriff freigeben
Wähle Klausi unter Customize → Connectors und dann Connect. Claude startet den Klausi-OAuth-Flow. Melde dich an, prüfe die Berechtigungen, gib nur das Nötige frei und bestätige.
Nur benötigte Werkzeuge aktivieren
Aktiviere Klausi im Chat über + → Connectors. Prüfe jeden vorgeschlagenen Aufruf – besonders Schreibaktionen – vor der Bestätigung. Beispiele:
- Liste meine offenen Aufgaben dieser Woche nach Projekt gruppiert.
- Buche 90 Minuten auf das Projekt „Website“ und sage mir genau, was du geändert hast.
Richte die Verbindung für die mobile Nutzung zuerst in Claude im Web ein.
ChatGPT verbinden
ChatGPT behandelt einen entfernten MCP-Server als eigene App. Vollständiges MCP inklusive Klausi-Schreibwerkzeugen ist derzeit im ChatGPT-Web für Business- und Enterprise/Edu-Workspaces verfügbar. Ein Admin oder Owner muss den Developer Mode aktivieren und die App freigeben beziehungsweise veröffentlichen. Pro bietet aktuell nur eingeschränkten Read-/Fetch-Zugriff, nicht den vollständigen Klausi-Workflow.
Developer Mode aktivieren
Ein Admin oder Owner öffnet Workspace-Einstellungen → Apps → Erstellen. Je nach Tarif wird der Entwicklerzugriff zusätzlich unter Einstellungen → Apps → Erweiterte Einstellungen oder Berechtigungen & Rollen → Connected Data aktiviert.
Klausi-App erstellen
Wähle Erstellen, trage „Klausi“ und den Endpoint ein und wähle OAuth als Authentifizierung. Starte Tools scannen. ChatGPT öffnet Klausi, damit du dich anmeldest und die Scopes freigibst.
Prüfen und veröffentlichen
Prüfe die gefundenen Werkzeuge und ihre Schreibwirkungen. Erstelle den Entwurf, teste ihn in einem neuen Chat und veröffentliche ihn für die vorgesehenen Workspace-Nutzer. Enterprise/Edu-Admins können einzelne Aktionen abschalten und den Zugriff per RBAC begrenzen.
Klausi im Chat verwenden
Öffne einen neuen Chat, wähle Klausi im Tools-/Apps-Menü oder erwähne die App im Prompt. ChatGPT kann vor Schreibaktionen eine Bestätigung verlangen. Eigene MCP-Apps sind derzeit nur im Web verfügbar; Agent Mode verwendet sie nicht, Deep Research nur lesend.
Werkzeugänderungen brauchen eine Admin-Prüfung. Enterprise/Edu kann Aktionen aktualisieren. Bei Business muss die App derzeit neu angelegt und veröffentlicht werden.
Andere MCP-Clients mit Zugriffstoken
Nutze diesen Weg nur für Clients, die Streamable HTTP und einen eigenen Bearer-Authorization-Header unterstützen, aber den Klausi-OAuth-Flow nicht abschließen können. Claude und ChatGPT sollten die Connector-/App-Wege oben verwenden.
Einwilligung erteilen und Token erstellen
Gib unter Einstellungen → Integrationen → MCP die nötigen Scopes frei und erstelle ein Token. Es wird nur einmal angezeigt. Behandle es wie ein Passwort.
Endpoint und Header konfigurieren
Lege im Client einen entfernten HTTP-MCP-Server an und sende das Token im Authorization-Header. Setze es niemals in eine URL, einen Screenshot, Supportfall, Chat-Prompt oder ein geteiltes Repository.
- Server-URL
https://mcp.klausi.app/mcp- HTTP-Header
Authorization: Bearer <dein-token>
Zuerst lesend testen
Starte den Client neu oder verbinde ihn erneut, lass die verfügbaren Werkzeuge auflisten und teste eine harmlose Leseabfrage, bevor du Schreibzugriff freigibst.
Was danach möglich ist
Der Client kann mehrere Werkzeugaufrufe zu einem Ablauf kombinieren – aber nur innerhalb der Daten und Scopes des angemeldeten Klausi-Nutzers.
- Aufgaben & Planung
- Aufgaben auflisten, anlegen, ändern und abschließen; mit Projekten und Fälligkeiten kombinieren.
- Zeiterfassung
- Einträge lesen, Timer starten oder stoppen, Zeiten buchen und Zeiträume zusammenfassen.
- Projekte & Notizen
- Projekte lesen oder anlegen, Notizen durchsuchen, erstellen und Inhalte ergänzen.
- Kunden & CRM
- Kunden, Pipelines, Leads, Deals und Kontakte prüfen; ausgewählte CRM-Datensätze anlegen und Deals verschieben.
- Operative Daten
- Reisen, Reisekosten, Leistungen, Projektkosten und Buchungen lesen.
- Finanzübersicht
- Rechnungen und Finanzsummen lesen. Versand, Änderung und Bezahlung von Rechnungen sind nicht verfügbar.
| Client | Einrichtung | Verfügbarkeit | Schreibaktionen |
|---|---|---|---|
| Claude / Claude Desktop | Remote Connector + OAuth | Free (einer), Pro, Max, Team, Enterprise | Ja, mit Klausi-Write-Scope und Tool-Bestätigung |
| ChatGPT | Eigene App + OAuth + Admin-Prüfung | Vollständig: Business, Enterprise/Edu; Pro eingeschränkt | Nur bei vollständigem MCP; Anbieter kann Bestätigung verlangen |
| Andere Clients | OAuth wenn unterstützt, sonst Bearer-Token | Abhängig von Remote-Streamable-HTTP-Unterstützung | Ja, wenn Client und Klausi-Scope es erlauben |
Berechtigungen und tatsächliche Wirkung
Gib die kleinste Scope-Kombination frei, die den gewünschten Ablauf ermöglicht. Eine Bestätigung beim KI-Anbieter ist eine zusätzliche Schutzschicht, ersetzt aber die Klausi-Scopes nicht.
- Lesen — Projekte, Aufgaben, Zeiten, Notizen, Kunden, CRM, Reisen, Leistungen, Kosten und Buchungen
- Schreiben — Aufgaben, Projekte, Notizen, Zeiten und ausgewählte CRM-Datensätze anlegen oder ändern
- Finanzen lesen — Rechnungen und Finanzübersicht; keine Rechnungs- oder Zahlungsaktion
Risiken und sichere Nutzung
Eine MCP-Verbindung gibt einem KI-Client echten Zugriff auf Geschäftsdaten. Die wichtigsten Kontrollen sind minimale Rechte, bewusste Bestätigung und regelmäßige Prüfung.
- Schreibaktionen sind echt
- Aufgabe anlegen, Zeit buchen oder Deal verschieben ändert Klausi sofort. Lass die geplante Änderung vorher nennen und prüfe sie danach.
- Prompt Injection
- Inhalte aus Notizen, Kontakten oder anderen verbundenen Apps können irreführende Anweisungen enthalten. Unvertraute Inhalte dürfen keine Schreibaktion autorisieren.
- Daten Dritter
- Kunden- und Kontaktdaten können an den KI-Anbieter gehen. Nutze nur Konten und Datenverarbeitungseinstellungen, die zu Verträgen und Datenschutzpflichten passen.
- Token-Verlust
- Ein manuelles Token gibt seinem Besitzer die enthaltenen Scopes. Niemals in Prompts oder Tickets einfügen; bei Offenlegung sofort widerrufen.
- Zu viele Berechtigungen
- Starte mit Read, ergänze Write nur für einen konkreten Ablauf und halte Finanzzugriff getrennt. Prüfe aktive Verbindungen regelmäßig.
- Anbieter-Verhalten ändert sich
- Client-Oberfläche, Bestätigungen und Tool-Auswahl können sich in der Beta ändern. Prüfe Einstellungen nach Anbieter-Updates und teste mit harmlosen Prompts.
Öffentlicher Werkzeugkatalog
Klausi stellt derzeit diese 37 Werkzeuge über tools/list bereit. Jeder Client erhält ein JSON-Schema mit Pflichtfeldern, Typen und erlaubten Werten. Ergebnisse enthalten modelllesbaren Text und – soweit vorhanden – strukturierte Daten.
Alle 37 Werkzeuge und Eingaben anzeigen
klausi_list_time_entries· read- Eingaben: project_id, from, to, limit
klausi_log_time· write- Eingaben: idempotency_key, minutes, start_at, end_at, project_id, task_id, description, billable
klausi_start_timer· write- Eingaben: idempotency_key, project_id, task_id, description, billable
klausi_stop_timer· write- Eingaben: idempotency_key
klausi_list_tasks· read- Eingaben: status, project_id, due_before, limit
klausi_create_task· write- Eingaben: idempotency_key, title, project_id, due_at, notes
klausi_update_task· write- Eingaben: idempotency_key, task_id, title, status, due_at, project_id, notes
klausi_complete_task· write- Eingaben: idempotency_key, task_id
klausi_list_projects· read- Eingaben: status, client_id, limit
klausi_get_project· read- Eingaben: project_id
klausi_create_project· write- Eingaben: idempotency_key, name, client_id, status, description
klausi_list_notes· read- Eingaben: query, project_id, limit
klausi_get_note· read- Eingaben: note_id
klausi_create_note· write- Eingaben: idempotency_key, title, body, project_id
klausi_append_to_note· write- Eingaben: idempotency_key, note_id, text
klausi_list_clients· read- Eingaben: query, status, limit
klausi_list_crm_pipelines· read- Eingaben: Keine Eingabefelder
klausi_list_crm_stages· read- Eingaben: pipeline_id
klausi_list_crm_organizations· read- Eingaben: query, limit
klausi_list_crm_leads· read- Eingaben: status, limit
klausi_list_crm_deals· read- Eingaben: status, pipeline_id, stage_id, limit
klausi_list_crm_contacts· read- Eingaben: query, limit
klausi_create_crm_contact· write- Eingaben: idempotency_key, full_name, email, phone, role_title, organization_id
klausi_create_crm_deal· write- Eingaben: idempotency_key, title, value, currency, pipeline_id, stage_id, primary_contact_id, organization_id
klausi_move_crm_deal· write- Eingaben: idempotency_key, deal_id, stage_id
klausi_log_crm_activity· write- Eingaben: idempotency_key, related_type, related_id, subject, type, description
klausi_list_invoices· finance:read- Eingaben: status, direction, limit
klausi_get_invoice· finance:read- Eingaben: invoice_id
klausi_list_trips· read- Eingaben: from, to, status, limit
klausi_get_trip· read- Eingaben: trip_id
klausi_list_travel_expenses· read- Eingaben: project_id, from, to, limit
klausi_list_services· read- Eingaben: query, active_only, client_id, limit
klausi_list_project_costs· read- Eingaben: project_id, limit
klausi_list_bookings· read- Eingaben: from, to, include_cancelled, limit
klausi_get_booking· read- Eingaben: booking_id
klausi_get_time_summary· read- Eingaben: from, to, client_id
klausi_get_finance_summary· finance:read- Eingaben: Keine Eingabefelder
Feste Grenzen: Schreibwerkzeuge wirken sofort. Löschen, Rechnungsversand, externe Freigaben, Zahlungen und Änderungen an Buchungen sind nicht freigegeben. Finanzwerkzeuge lesen nur. Jede Anfrage wird gegen angemeldeten Nutzer, Tenant-Eigentum und Scopes geprüft.
Rate Limits, Fehler und Support
Der MCP-Endpoint erlaubt 120 authentifizierte Requests pro Minute und sendet bei HTTP 429 einen Retry-After-Header. Der OAuth-Token-Tausch erlaubt 60 Requests pro Minute und IP, die Client-Registrierung 20 pro Stunde und IP. HTTP 401 bedeutet ein fehlendes, abgelaufenes oder widerrufenes Token; 403 eine unzulässige Origin oder einen fehlenden Scope. JSON-RPC-Fehler kennzeichnen ungültige Requests, nicht unterstützte Protokollversionen und Werkzeugfehler. Bitte bei reproduzierbaren Problemen Zeitpunkt, Client, Werkzeug und Fehlercode angeben – niemals Token oder Kundendaten.
Support kontaktierenZugriff jederzeit widerrufen
Widerrufe unter Einstellungen → Integrationen → MCP ein einzelnes Token oder die MCP-Einwilligung vollständig. Der vollständige Widerruf deaktiviert sofort alle zugehörigen Tokens und OAuth-Sitzungen. Entferne oder deaktiviere Klausi zusätzlich beim KI-Anbieter. Ändert sich der Einwilligungstext, verlangt Klausi eine neue Zustimmung.
Sicherheit & Datenschutz
Klausi speichert Token-Hashes statt Klartext-Tokens und zeigt manuelle Tokens einmalig. Werkzeugaufrufe werden für Sicherheit und Betrieb ohne Geschäftsinhalte protokolliert. An Claude oder ChatGPT zurückgegebene Daten werden nach den Konto- und Datenbedingungen des jeweiligen Anbieters verarbeitet und können personenbezogene Daten Dritter wie Kunden- oder Kontaktdaten enthalten. Siehe Abschnitt 3.7 unserer Datenschutzerklärung.
Problembehebung
- Der Client erreicht Klausi nicht oder das Scannen der Tools schlägt fehl.
- Prüfe, ob der Endpoint exakt https://mcp.klausi.app/mcp lautet, verwende einen Remote-HTTP-Connector und schließe Klausi-Login und Einwilligung ab. Localhost und die Klausi-App-URL sind keine MCP-Endpoints.
- Der Client meldet „consent required“, 401 oder 403.
- Öffne Einstellungen → Integrationen → MCP. Bestätige eine veraltete Einwilligung bei 403 erneut, verbinde OAuth bei abgelaufener Sitzung neu oder erstelle nach Widerruf eines verlorenen Tokens ein neues.
- ChatGPT zeigt alte Werkzeuge oder einen Tool-Schema-Fehler.
- Bitte einen Admin, Werkzeugänderungen zu prüfen. Enterprise/Edu kann Aktionen aktualisieren; Business muss die App neu anlegen und veröffentlichen.
- Eine Schreibaktion hat nicht das erwartete Ergebnis.
- Prüfe Klausi sofort, korrigiere den Datensatz bei Bedarf direkt in Klausi, deaktiviere den Schreib-Scope und melde Zeitpunkt, Client, Werkzeug sowie nicht vertraulichen Fehlerkontext an den Support.
Offizielle Anbieter-Dokumentation
Anbieter-Hinweise geprüft: 31. August 2026