Tokens, Bereiche und Sicherheit
Wie Anmeldeverbindungen (OAuth) und pat-isms-Tokens funktionieren: Was sie können, Bereiche, Trennung, Ablauf und harte Grenzen.
Ein MCP-Client agiert in Ihrem Namen auf eine von zwei Arten: Sie melden sich an und genehmigen ihn (OAuth, die Standardeinstellung), oder Sie geben ihm ein persönliches Zugriffstoken, das durch die von Ihnen ausgewählten Bereiche eingeschränkt ist.
Anmeldung (OAuth)
Wenn Sie https://account.ismscopilot.com/v1/account/mcp zu einem Client ohne Header hinzufügen, fordert der Client Sie auf, sich bei ISMS Copilot anzumelden. Die Zustimmungsseite zeigt die Adresse, an die die Ergebnisse gesendet werden, und den Namen, den sich die App selbst gegeben hat. Genehmigen Sie nur, wenn Sie die Verbindung von Ihrem eigenen KI-Tool aus gestartet haben.
Ein Genehmigen gewährt einen festen Satz:
| Kann | Bereiche |
|---|---|
| Ihr Konto, Arbeitsbereiche, Dokumente (Metadaten), Erinnerungen und Unternehmensprofil lesen | account:read, workspaces:read, documents:read, memories:read, company_context:read |
| ISMS Copilot Fragen stellen und Antworten lesen | conversations:create |
| Ihr Unternehmensprofil und Erinnerungen aktualisieren sowie Arbeitsbereiche erstellen | company_context:write, memories:write, workspaces:write |
Eine Anmeldeverbindung kann niemals API-Schlüssel erstellen, auflisten oder widerrufen und kann niemals API-Guthaben prüfen oder kaufen. Diese bleiben token-exklusiv. Ihre Antworten enthalten auch nie Upgrade- oder Kauffelder wie upgrade_url oder extra_usage_buyable.
Änderungen, die eine angemeldete App vornimmt, werden in ISMS Copilot mit dem Namen gekennzeichnet, den die App registriert hat: Added by OAuth app: <name> bei Erinnerungen, Updated by OAuth app: <name> bei Ihrem Unternehmensprofil und Arbeitsbereichen. Der Name wird von der App selbst gewählt, behandeln Sie ihn daher als Hinweis, nicht als Beweis. Eine spätere Änderung über die Web-App oder ein Token ersetzt die Kennzeichnung.
Trennen: Einstellungen → Verknüpfte Apps, unter Verbundene Agenten. Der nächste Aufruf dieser App wird abgelehnt und ihr Refresh-Token funktioniert nicht mehr. Um die Verbindung wiederherzustellen, melden Sie sich erneut an und genehmigen Sie sie.
Persönliche Zugriffstokens (Fallback)
Verwenden Sie ein Token für einen Client, der sich nicht anmelden kann, für CI- und Headless-Maschinen oder wenn Sie eine engere Auswahl an Bereichen wünschen als die Anmeldung gewährt.
Präfix und Lebenszyklus
| Schritt | Verhalten |
|---|---|
| Erstellen | Einstellungen → Verknüpfte Apps → Token erstellen |
| Anzeigen | Vollständiges Geheimnis wird einmalig angezeigt; beginnt mit pat-isms- |
| Speichern | Nur in der Client-Konfiguration; niemals in Git einchecken |
| Widerrufen | Dieselbe Einstellungsseite; wirkt sofort |
| Ablauf | Optional bei der Erstellung |
Bereiche (typisch)
Die genauen Bezeichnungen in der Benutzeroberfläche können leicht variieren; die Absicht ist:
Konto
| Fähigkeit | Lesen | Schreiben / Handeln |
|---|---|---|
| Kontoinformationen | ja | nein |
| Arbeitsbereiche | auflisten (workspaces:read) | persönliche Arbeitsbereiche mit create_workspace erstellen (workspaces:write) |
| Dokumente | nur Metadaten auflisten (kein Tool zum Abrufen nach ID) | nein |
| Erinnerungen | ja | erstellen / bearbeiten, wenn gewährt |
| Unternehmenskontext | get_company_context (company_context:read) | set_company_context (company_context:write), ein vollständiger Ersatz des Profils |
| Unterhaltungen | n/a | starten und senden, wenn gewährt |
Model API (Gruppe „Verknüpfte Apps“)
| Bereich | Zweck |
|---|---|
api_keys:read | Metadaten von sk-isms-Schlüsseln auflisten (keine Geheimnisse) |
api_keys:write | sk-isms-Schlüssel über MCP erstellen / widerrufen |
api_credits:read | Guthabenstand der vorab bezahlten API-Guthaben lesen |
api_credits:checkout | Stripe-Checkout-URL für Aufladung erstellen (eine Person zahlt im Browser) |
Diese Bereiche ermöglichen es einem pat-isms-Token nicht, Inferenzaufrufe durchzuführen. Der Orchestrator verwendet weiterhin einen separaten sk-isms-Schlüssel für api.ismscopilot.com. Siehe Einrichten aus Claude Code oder Grok.
Gewähren Sie den minimalen Satz für die Aufgabe des Orchestrators. Ein Nur-Lese-Arbeitsbereich-Token kann keine Unterhaltungen starten.
Harte Grenzen (by design)
- Die Erstellung von Arbeitsbereichen ist persönlich und budgetiert. Ein vom Orchestrator erstellter Arbeitsbereich wird nicht mit Ihrem Team geteilt, erbt nicht den erweiterten Datenschutz Ihrer Organisation und ist auf 10 neue Arbeitsbereiche pro 24 Stunden begrenzt (jede Erstellung zählt, einschließlich der Web-App und des Start-Arbeitsbereichs eines neuen Kontos). Legen Sie Persona, Anweisungen und Teamfreigabe in der Web-App fest.
- Schreibvorgänge im Unternehmenskontext sind ein vollständiger Ersatz.
set_company_contextüberschreibt das gesamte Profil mit den von Ihnen übergebenen Feldern (Firmenname, Branche, Größe, Hauptsitzland, Datenschutzrolle, Datentypen, Hosting-Region, Tech-Stack, Notizen); ein leeres Objekt löscht es. Lesen Sie es zuerst mitget_company_context, wenn Sie nur ein Feld ändern möchten. - Beyond ist verfügbar, wenn der Orchestrator
mode: "beyond"übergibt (Fast ist die Standardeinstellung). Bezahlte Pläne, 10 Durchläufe pro UTC-Tag (50 bei Unlimited). Siehe Beyond-Modus verwenden. - Erweiterter Datenschutz kann nicht über das Token umgeschaltet werden. Der Orchestrator kann den Status melden; Sie ändern ihn unter Einstellungen → Datenschutz.
- Ratenbegrenzungen gelten (in der Größenordnung von ~120 Anfragen/Minute pro Token; gleichzeitige Unterhaltungen sind pro Konto begrenzt). Wenn Sie auf Grenzen stoßen, warten Sie und versuchen Sie es erneut.
pat-ismsallein führt keine Model-API-Vervollständigungen durch. Model-API-Tools prägensk-ismsund öffnen die Guthaben-Checkout-Seite; die Abrechnung für Embed-Partner bleibt separat.
Sicherheitscheckliste
- Benennen Sie Tokens nach Gerät oder Zweck (
claude-laptop,cursor-ci). - Bevorzugen Sie kurze Ablaufzeiten für temporäre Maschinen.
- Widerrufen Sie Tokens, wenn ein Laptop verloren geht oder ein CI-Geheimnis rotiert.
- Geben Sie
pat-isms-…niemals in öffentlichen Repositories, Screenshots oder Support-Tickets preis.
Die Nutzung wird auf Ihr normales Chat-Abonnement und die Planlimits angerechnet, nicht auf vorab bezahlte API-Guthaben. Ihr Orchestrator liest jede zurückgegebene Antwort als Eingabe, sodass der Antworttext auch auf den Kontext und die Nutzung des aufrufenden Tools angerechnet wird.