Tokeny, zakresy i bezpieczeństwo
Jak działają połączenia logowania (OAuth) i tokeny pat-isms: co każdy z nich może zrobić, zakresy, rozłączanie, wygaśnięcie i twarde limity.
Klient MCP działa jako twój użytkownik na jeden z dwóch sposobów: logujesz się i zatwierdzasz (OAuth, domyślnie) lub przekazujesz mu osobisty token dostępu ograniczony przez wybrane zakresy.
Logowanie (OAuth)
Gdy dodasz https://account.ismscopilot.com/v1/account/mcp do klienta bez nagłówka, klient poprosi cię o zalogowanie się do ISMS Copilot. Strona zgody pokazuje adres, na który trafią wyniki, oraz nazwę, jaką aplikacja nadała sama sobie. Zatwierdzaj tylko wtedy, gdy połączenie zainicjowałeś z własnego narzędzia AI.
Jedno Zatwierdź przyznaje jeden stały zestaw:
| Może | Zakresy |
|---|---|
| Odczytywać Twoje konto, przestrzenie robocze, dokumenty (metadane), wspomnienia i profil firmy | account:read, workspaces:read, documents:read, memories:read, company_context:read |
| Zadawać pytania ISMS Copilot i odczytywać odpowiedzi | conversations:create |
| Aktualizować profil firmy i wspomnienia oraz tworzyć przestrzenie robocze | company_context:write, memories:write, workspaces:write |
Połączenie przez logowanie nigdy nie może tworzyć, wyświetlać ani unieważniać kluczy API i nigdy nie może sprawdzać ani kupować kredytów API. Te czynności są dostępne tylko dla tokenów. Jego odpowiedzi nigdy też nie zawierają pól dotyczących zmiany planu ani zakupu, takich jak upgrade_url czy extra_usage_buyable.
Zmiany dokonane przez zalogowaną aplikację są oznaczane w ISMS Copilot nazwą, jaką aplikacja zarejestrowała: Added by OAuth app: <name> we wspomnieniach, Updated by OAuth app: <name> w profilu firmy i przestrzeniach roboczych. Nazwa jest wybierana przez samą aplikację, więc traktuj ją jako wskazówkę, a nie dowód. Późniejsza zmiana z aplikacji internetowej lub tokena zastępuje etykietę.
Rozłączanie: Ustawienia → Podłączone aplikacje, w sekcji Podłączone agenty. Następne wywołanie z tej aplikacji zostanie odrzucone, a jej token odświeżania przestanie działać. Aby połączyć się ponownie, zaloguj się i zatwierdź ponownie.
Osobiste tokeny dostępu (awaryjne)
Użyj tokena dla klienta, który nie może się zalogować, dla CI i maszyn bez interfejsu graficznego lub gdy chcesz węższego zestawu zakresów niż te przyznawane przy logowaniu.
Prefiks i cykl życia
| Krok | Zachowanie |
|---|---|
| Tworzenie | Ustawienia → Podłączone aplikacje → Utwórz token |
| Wyświetlanie | Pełny sekret pokazywany jednokrotnie; zaczyna się od pat-isms- |
| Przechowywanie | Tylko w konfiguracji klienta; nigdy nie commituj do git |
| Unieważnianie | Ta sama strona Ustawień; wchodzi w życie natychmiast |
| Wygaśnięcie | Opcjonalne przy tworzeniu |
Zakresy (typowe)
Dokładne etykiety w interfejsie mogą się nieznacznie różnić; chodzi o intencję:
Konto
| Możliwość | Odczyt | Zapis / działanie |
|---|---|---|
| Informacje o koncie | tak | nie |
| Przestrzenie robocze | wyświetlanie (workspaces:read) | tworzenie osobistych przestrzeni roboczych z create_workspace (workspaces:write) |
| Dokumenty | wyświetlanie tylko metadanych (bez narzędzia pobierania po ID) | nie |
| Wspomnienia | tak | tworzenie / edycja, gdy przyznano uprawnienia |
| Kontekst firmy | get_company_context (company_context:read) | set_company_context (company_context:write), pełne zastąpienie profilu |
| Konwersacje | nie dotyczy | rozpoczynanie i wysyłanie, gdy przyznano uprawnienia |
Model API (grupa Podłączone aplikacje)
| Zakres | Cel |
|---|---|
api_keys:read | Wyświetlanie metadanych kluczy sk-isms (bez sekretów) |
api_keys:write | Tworzenie / unieważnianie kluczy sk-isms przez MCP |
api_credits:read | Odczyt salda przedpłaconych kredytów API |
api_credits:checkout | Tworzenie adresu URL Stripe Checkout do doładowania (płatność przez człowieka w przeglądarce) |
Te zakresy nie pozwalają tokenowi pat-isms na wywoływanie inferencji. Orkiestrator nadal używa oddzielnego klucza sk-isms dla api.ismscopilot.com. Zobacz Konfiguracja z Claude Code lub Grok.
Przyznaj minimalny zestaw wymagany do zadania orkiestratora. Token tylko do odczytu przestrzeni roboczej nie może rozpoczynać konwersacji.
Twarde limity (z założenia)
- Tworzenie przestrzeni roboczych jest tylko osobiste i limitowane. Przestrzeń robocza utworzona przez agenta nie jest udostępniana Twojemu zespołowi, nie dziedziczy Zaawansowanej Ochrony Danych Twojej organizacji i jest ograniczona do 10 nowych przestrzeni roboczych na 24 godziny (każde utworzenie jest liczone, w tym te z aplikacji internetowej i przestrzeń startowa nowego konta). Ustaw personę, instrukcje i udostępnianie zespołowi w aplikacji internetowej.
- Zapisy kontekstu firmy są pełnym zastąpieniem.
set_company_contextnadpisuje cały profil polami, które przekazujesz (nazwa firmy, sektor, skala, kraj siedziby, rola prywatności, typy danych, region hostingu, stos technologiczny, notatki); pusty obiekt czyści profil. Najpierw odczytaj go za pomocąget_company_context, jeśli chcesz zmienić tylko jedno pole. - Beyond jest dostępny, gdy agent przekazuje
mode: "beyond"(Fast jest domyślny). Plany płatne, 10 uruchomień na dzień UTC (50 w planie Unlimited). Zobacz Korzystanie z trybu Beyond. - Zaawansowana Ochrona Danych nie może być przełączana przez token. Agent może raportować status; zmieniasz ją w Ustawienia → Ochrona Danych.
- Limity szybkości obowiązują (rzędu ~120 żądań/minutę na token; równoczesne konwersacje są limitowane na konto). Jeśli napotkasz limity, zwolnij i spróbuj ponownie.
pat-ismssam nie uruchamia uzupełnień model-API. Narzędzia Model API generująsk-ismsi otwierają checkout kredytów; rozliczenia Embed partnera pozostają oddzielne.
Lista kontrolna bezpieczeństwa
- Nazywaj tokeny według urządzenia lub celu (
claude-laptop,cursor-ci). - Preferuj krótki czas wygaśnięcia dla tymczasowych maszyn.
- Unieważniaj, gdy laptop zostanie zgubiony lub sekret CI się zmieni.
- Nigdy nie umieszczaj
pat-isms-…w publicznych repozytoriach, zrzutach ekranu ani zgłoszeniach wsparcia.
Wykorzystanie liczy się w ramach normalnej subskrypcji czatu i limitów planu, a nie przedpłaconych kredytów API. Twój agent nadal odczytuje każdą zwróconą odpowiedź jako dane wejściowe, więc tekst odpowiedzi również liczy się do kontekstu i wykorzystania narzędzia wywołującego.