Hilfe · MCP

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.

Alle Hilfe-Artikel

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 → Apps → MCP.
Ein unterstützter KI-Tarif: Claude 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 → Apps → MCP. Kopiere den unten gezeigten offiziellen Endpoint. Vertraue nur der Domain klausi.app.

Einstellungen › Apps › MCP

Verbindungs-Endpoint

https://mcp.klausi.app/mcp

Schematische Beispielansicht. Bezeichnungen können je nach Sprache, Tarif und Rollout abweichen.

Remote Connector in Claude hinzufügen

Öffne Einstellungen → Connectors → Custom Connector hinzufügen. Bei Team oder Enterprise muss ein Owner ihn zuerst unter Organization connectors anlegen. Trage „Klausi“ und die Server-URL ein und wähle Hinzufügen.

Claude · Custom Connector hinzufügen

Server-URL

https://mcp.klausi.app/mcpHinzufügen

Schematische Beispielansicht. Bezeichnungen können je nach Sprache, Tarif und Rollout abweichen.

Verbinden und Zugriff freigeben

Öffne in einem Chat Suche und Tools, wähle Klausi und dann Verbinden. Claude startet den Klausi-OAuth-Flow. Melde dich an, prüfe die Berechtigungen, gib nur das Nötige frei und bestätige.

Klausi · Zugriff freigeben

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

Erlauben & verbinden

Schematische Beispielansicht. Bezeichnungen können je nach Sprache, Tarif und Rollout abweichen.

Nur benötigte Werkzeuge aktivieren

Aktiviere Klausi über Suche und Tools für die Unterhaltung. 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.

Mobil-Hinweis: Nachdem Klausi über Claude im Web hinzugefügt wurde, lässt sich der Connector auch unter iOS oder Android verwenden. Neue Remote Connectoren können mobil nicht angelegt werden.

ChatGPT

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.

ChatGPT · App erstellen

Klausi · https://mcp.klausi.app/mcpTools scannen

OAuth37 tools

Schematische Beispielansicht. Bezeichnungen können je nach Sprache, Tarif und Rollout abweichen.

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.

ChatGPT speichert einen freigegebenen Snapshot der Werkzeuge und Eingaben. Ergänzt oder ändert Klausi später Werkzeuge, muss ein Admin die Aktionen aktualisieren, den Unterschied prüfen und das Update erneut veröffentlichen.

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 → Apps → MCP die nötigen Scopes frei und erstelle ein Token. Es wird nur einmal angezeigt. Behandle es wie ein Passwort.

Klausi · Token erstellt

klausi_mcp_8120d7a1b2c3…Kopieren

Wird nur einmal angezeigt — jetzt kopieren.

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.

{
  "mcpServers": {
    "klausi": {
      "url": "https://mcp.klausi.app/mcp",
      "headers": {
        "Authorization": "Bearer klausi_mcp_…"
      }
    }
  }
}

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	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.

ReadLesen — Projekte, Aufgaben, Zeiten, Notizen, Kunden, CRM, Reisen, Leistungen, Kosten und Buchungen

WriteSchreiben — Aufgaben, Projekte, Notizen, Zeiten und ausgewählte CRM-Datensätze anlegen oder ändern

FinanceFinanzen 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_entriesread

Eingaben: project_id, from, to, limit

klausi_log_timewrite

Eingaben: minutes, start_at, end_at, project_id, task_id, description, billable

klausi_start_timerwrite

Eingaben: project_id, task_id, description

klausi_stop_timerwrite

Eingaben: Keine Eingabefelder

klausi_list_tasksread

Eingaben: status, project_id, due_before, limit

klausi_create_taskwrite

Eingaben: title, project_id, due_at, notes

klausi_update_taskwrite

Eingaben: task_id, title, status, due_at, project_id, notes

klausi_complete_taskwrite

Eingaben: task_id

klausi_list_projectsread

Eingaben: status, client_id, limit

klausi_get_projectread

Eingaben: project_id

klausi_create_projectwrite

Eingaben: name, client_id, status, description

klausi_list_notesread

Eingaben: query, project_id, limit

klausi_get_noteread

Eingaben: note_id

klausi_create_notewrite

Eingaben: title, body, project_id

klausi_append_to_notewrite

Eingaben: note_id, text

klausi_list_clientsread

Eingaben: query, status, limit

klausi_list_crm_pipelinesread

Eingaben: Keine Eingabefelder

klausi_list_crm_stagesread

Eingaben: pipeline_id

klausi_list_crm_organizationsread

Eingaben: query, limit

klausi_list_crm_leadsread

Eingaben: status, limit

klausi_list_crm_dealsread

Eingaben: status, pipeline_id, stage_id, limit

klausi_list_crm_contactsread

Eingaben: query, limit

klausi_create_crm_contactwrite

Eingaben: full_name, email, phone, role_title, organization_id

klausi_create_crm_dealwrite

Eingaben: title, value, currency, pipeline_id, stage_id, primary_contact_id, organization_id

klausi_move_crm_dealwrite

Eingaben: deal_id, stage_id

klausi_log_crm_activitywrite

Eingaben: related_type, related_id, subject, type, description

klausi_list_invoicesfinance:read

Eingaben: status, direction, limit

klausi_get_invoicefinance:read

Eingaben: invoice_id

klausi_list_tripsread

Eingaben: from, to, status, limit

klausi_get_tripread

Eingaben: trip_id

klausi_list_travel_expensesread

Eingaben: project_id, from, to, limit

klausi_list_servicesread

Eingaben: query, active_only, client_id, limit

klausi_list_project_costsread

Eingaben: project_id, limit

klausi_list_bookingsread

Eingaben: from, to, include_cancelled, limit

klausi_get_bookingread

Eingaben: booking_id

klausi_get_time_summaryread

Eingaben: from, to, client_id

klausi_get_finance_summaryfinance: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.

Zugriff jederzeit widerrufen

Widerrufe unter Einstellungen → Apps → 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 → Apps → 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.

Ein Workspace-Admin muss die Aktionen der Klausi-App aktualisieren, den Tool-Unterschied prüfen und die App erneut veröffentlichen. ChatGPT übernimmt serverseitige Änderungen nicht automatisch.

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: 8. August 2026

Zu den MCP-Einstellungen