ISMS Copilot Docs

Połącz ISMS Copilot z Claude Code

Używaj swojego konta ISMS Copilot z poziomu Claude Code. Dodaj serwer jednym poleceniem, zaloguj się i zatwierdź, a następnie przeglądaj swoje przestrzenie robocze i pamięci oraz prowadź prawdziwe rozmowy z ISMS Copilot bezpośrednio z terminala. Tokeny dostępu osobistego pozostają dostępne jako awaryjne rozwiązanie.

Claude wykonuje pracę. ISMS Copilot jest ekspertem ds. zgodności, z którym się konsultuje i który weryfikuje tę pracę. Ty decydujesz i podpisujesz.

Możesz używać swojego konta ISMS Copilot bezpośrednio z Claude Code, Cursor lub dowolnego narzędzia AI zgodnego z MCP. Po połączeniu, twoje narzędzie AI może wyświetlać listę twoich przestrzeni roboczych i dokumentów, odczytywać pamięci oraz prowadzić prawdziwe rozmowy z ISMS Copilot, działając w twoim imieniu i objęte istniejącą subskrypcją.

Czego potrzebujesz

  • Konta w ISMS Copilot. Połączenie jest objęte twoją subskrypcją, bez dodatkowych opłat.
  • Terminala z zainstalowanym Claude Code (lub innym klientem MCP).
  • Niektóre funkcje zależą od twojego planu (zobacz Wybór trybu odpowiedzi).

Połącz w trzech krokach

Już połączony za pomocą tokena dostępu osobistego? Najpierw usuń ten serwer, w przeciwnym razie Claude Code będzie go nadal używać: claude mcp remove ismscopilot.

  1. Dodaj serwer (token nie jest potrzebny):
claude mcp add --scope user --transport http ismscopilot https://account.ismscopilot.com/v1/account/mcp
  1. W sesji Claude Code uruchom /mcp, wybierz ismscopilot i postępuj zgodnie z instrukcjami w przeglądarce. Z terminala polecenie claude mcp login ismscopilot działa tak samo.
  2. Zaloguj się do ISMS Copilot i kliknij Zatwierdź na stronie zgody.

Następnie zapytaj, na przykład: "wyświetl moje przestrzenie robocze ISMS Copilot."

Flaga --scope user sprawia, że ISMS Copilot jest dostępny w każdym folderze. Bez niej połączenie rejestruje się tylko w katalogu, w którym uruchomiono polecenie, co jest najczęstszym powodem problemu "połączono, ale nie widać".

claude.ai i Claude Desktop łączą się z tym samym adresem URL serwera przy użyciu tego samego logowania: zobacz Połącz dowolnego klienta MCP. ChatGPT łączy się w ten sam sposób, jako niestandardowa aplikacja MCP: zobacz tę samą stronę. W przypadku Cursor i Codex, zobacz Połącz Cursor i Codex.

Awaryjne rozwiązanie: połącz za pomocą tokena dostępu osobistego

Użyj tokena, gdy logowanie nie jest możliwe, na przykład w CI lub na maszynie bez interfejsu graficznego:

  1. W ISMS Copilot otwórz Ustawienia, następnie Połączone aplikacje.
  2. Kliknij Utwórz token. Nadaj mu nazwę (na przykład "Claude Code CI"), wybierz uprawnienia, jakie powinien mieć (zobacz Uprawnienia), i skopiuj token. Zobaczysz go tylko raz.
  3. Wklej pokazane polecenie do terminala. Wygląda ono tak:
claude mcp add --scope user --transport http ismscopilot https://account.ismscopilot.com/v1/account/mcp --header "Authorization: Bearer pat-isms-..."

Co może zrobić twoje narzędzie AI

Połączenie może odczytywać i wykonywać następujące czynności, i nic poza tym. Połączenie przez logowanie uzyskuje wszystkie poniższe uprawnienia; token uzyskuje tylko te, które obejmują jego uprawnienia:

ZdolnośćOdczytZmiana
Informacje o koncieTakNie
Przestrzenie roboczeTak (lista)Tak (utwórz osobistą przestrzeń roboczą za pomocą create_workspace, maksymalnie 10 na 24 godziny)
DokumentyTylko metadane (lista nazw i szczegółów; bez zawartości plików)Nie
PamięciTakTak (tworzenie i edycja)
FirmyTak (get_company_context, list_companies, get_company)Tak (set_company_context, create_company, update_company, delete_company, link_company_to_workspace, unlink_workspace_company), do limitu firm w twoim planie
Rozmowyn/aTak (rozpoczęcie nowej, wysyłanie wiadomości)

Dzięki temu z poziomu narzędzia AI możesz wyświetlać listę swoich przestrzeni roboczych i dokumentów, tworzyć osobistą przestrzeń roboczą, dodawać lub edytować pamięć oraz prowadzić ugruntowaną rozmowę z ISMS Copilot, wszystko bez opuszczania edytora.

Wybór trybu odpowiedzi (Fast, Think i Beyond)

Serwer nie wybiera trybu. Twój orkiestrator domyślnie używa trybu Fast, Think do sprawdzania i wieloetapowej analizy, a Beyond na żądanie, do ostatecznej weryfikacji tuż przed audytem lub do długotrwałego tworzenia projektów na poziomie badawczym. Jeśli orkiestrator pominie mode, ISMS Copilot używa Fast.

  • Fast (domyślnie): szybkie odpowiedzi, bez rozszerzonego rozumowania.
  • Think: głębsze rozumowanie do sprawdzania i wieloetapowej analizy. Tylko w płatnych planach. W darmowym planie żądanie Think przechodzi na Fast.
  • Beyond: wieloetapowy plan, szkic i weryfikacja. Tylko w płatnych planach, 10 uruchomień na dobę UTC (50 w planie Unlimited). Trwa kilka minut. Orkiestrator musi przekazać mode: "beyond" w create_conversation lub send_message, a następnie sondować get_reply co około 10-20 sekund, aż uruchomienie się zakończy. Jeśli Beyond nie może zostać uruchomiony, tura odpowiada przez normalny przepływ i zawiera beyond_denied_reason.

W praktyce:

  • „Przemyśl to dokładnie” wystarczy, aby użyć Think.
  • „Użyj Beyond” lub „uruchom to w Beyond” wystarczy, aby użyć Beyond. Bez tego orkiestrator może nadal wybrać Beyond do ostatecznej weryfikacji tuż przed audytem lub do długotrwałego tworzenia projektów na poziomie badawczym.

Tura w trybie Fast lub Think, która nie jest gotowa natychmiast, zwraca status: "generating". Orkiestrator następnie sonduje get_reply co około 2-5 sekund, aż zwróci complete.

Zobacz Korzystanie z trybu Beyond.

Jeśli napotkasz limit użytkowania

Połączenia przez logowanie (Claude, ChatGPT): komunikat o błędzie podaje limit i czas jego resetu, bez zaproszenia do uaktualnienia. JSON zawiera reset_at, ale nigdy upgrade_url, usage_url ani extra_usage_buyable. Pola dotyczące uaktualnienia i zakupu, opisane poniżej, pojawiają się tylko w połączeniach z tokenem dostępu osobistego.

Połączenie korzysta z tego samego limitu użycia co aplikacja czatu: limitu Twojego planu, z czasem resetu pokazanym w aplikacji. Jeśli create_conversation lub send_message osiągnie limit, pierwszy komunikat o błędzie zawiera zdanie o czekaniu lub uaktualnieniu (w tym czas następnego resetu), a blok JSON zawiera reset_at. Konta indywidualne i właściciele organizacji otrzymują również upgrade_url. Członkowie organizacji otrzymują zamiast tego zdanie o zespole: poproś właściciela o dodatkowe użycie lub poczekaj do następnego 4-godzinnego okna. Ich JSON zawiera quota_scope, org_role i extra_usage_buyable, ale nie link do uaktualnienia.

Możesz:

  1. Poczekać do reset_at.
  2. Otworzyć upgrade_url w przeglądarce, będąc zalogowanym na to samo konto ISMS Copilot (konta indywidualne i właściciele organizacji).
  3. Gdy JSON zawiera fallback_available: true i dostępny jest nadmiarowy limit twojego planu (indywidualne płatne konta z wyłączoną Zaawansowaną Ochroną Danych; nigdy w puli zespołowej), poinstruuj orkiestratora, aby kontynuował: na twoje wyraźne polecenie ponownie wyśle z overflow_consent: true i tura zostanie wykonana w tym samym do 2x nadmiarze, który oferuje aplikacja internetowa (odpowiedź zawiera overflow_active: true).
  4. Nadal korzystać z narzędzi do odczytu. Przestrzenie robocze, pamięci, dokumenty i informacje o koncie nadal działają po osiągnięciu limitu czatu.

Zobacz Co zrobić, gdy osiągniesz limit użytkowania.

Ustawienia pozostają w aplikacji internetowej

Chronione ustawienia konta są tylko do odczytu z poziomu połączenia (firmy, jak wyżej, są wyjątkiem: połączenie przez logowanie lub token z company_context:write może je tworzyć, zmieniać i usuwać oraz łączyć je z przestrzeniami roboczymi lub odłączać, do limitu firm w twoim planie). W szczególności Zaawansowana Ochrona Danych (która kieruje twoje dane przez dostawcę z siedzibą w UE, bez przechowywania) nie może być włączana ani wyłączana z poziomu narzędzia AI.

Jeśli zapytasz swoje narzędzie AI o Ochronę Danych, może ono poinformować, czy jest włączona dla twojego konta, i wskaże ci Ustawienia, Ochrona Danych pod adresem chat.ismscopilot.com, aby ją zmienić. Jest to celowe: token połączenia nie powinien móc zmienić globalnego ustawienia dotyczącego miejsca przechowywania danych.

Ustawienia przestrzeni roboczej lub organizacji mogą wymuszać Zaawansowaną Ochronę Danych na określonych przestrzeniach roboczych, niezależnie od domyślnych ustawień twojego konta osobistego, więc konkretna rozmowa może być prowadzona w trybie UE, nawet gdy domyślne ustawienia konta są wyłączone.

Uprawnienia

Gdy się zalogujesz i klikniesz Zatwierdź, narzędzie otrzymuje jeden stały zestaw uprawnień: odczyt twojego konta, przestrzeni roboczych, dokumentów (metadane), pamięci i firm; zadawanie pytań ISMS Copilot, odczytywanie odpowiedzi i oznaczanie zatrzymanej odpowiedzi jako nieudanej; tworzenie, zmienianie i usuwanie firm oraz łączenie ich z przestrzeniami roboczymi lub odłączanie, edycja pamięci oraz tworzenie przestrzeni roboczych. Nie może tworzyć kluczy API ani kupować kredytów. Zmiany wprowadzone przez nie są oznaczane w ISMS Copilot nazwą narzędzia, jako Added by OAuth app: <name> lub Updated by OAuth app: <name>.

Gdy zamiast tego utworzysz token, wybierasz dokładnie, co może zrobić (odczyt przestrzeni roboczych, odczyt dokumentów, odczyt i zapis pamięci, rozpoczynanie rozmów itp.). Przyznaj tylko to, czego potrzebujesz. Token, który może tylko odczytywać twoje przestrzenie robocze, nie może zmieniać twoich pamięci ani rozpoczynać rozmów.

W każdej chwili możesz zobaczyć i odłączyć każde połączenie w Ustawieniach, Połączone aplikacje: tokeny w liście tokenów, połączenia przez logowanie w sekcji Połączone agenty.

Ponowne łączenie lub rotacja tokena

Jeśli połączenie przez logowanie przestanie działać (na przykład po jego odłączeniu), uruchom /mcp, wybierz ismscopilot i zaloguj się ponownie.

Jeśli połączyłeś się za pomocą tokena i chcesz przełączyć się na nowy, najpierw usuń istniejący serwer. W przeciwnym razie Claude Code będzie nadal używać starego tokena:

claude mcp remove ismscopilot

Następnie dodaj serwer ponownie, przez logowanie lub z nowym tokenem.

Bezpieczeństwo

  • Połączenie działa w twoim imieniu, więc może uzyskać dostęp dokładnie do tego, do czego twoje konto ma już dostęp, ograniczone tym, co zatwierdziłeś lub uprawnieniami, które przyznałeś.
  • Jest objęte twoją subskrypcją, bez dodatkowych opłat.
  • Możesz je odłączyć w dowolnym momencie w Ustawieniach, Połączone aplikacje. Odłączenie działa natychmiast.
  • Traktuj token jak hasło. Jeśli zostanie ujawniony, cofnij go i utwórz nowy.

Rozwiązywanie problemów

  • Połączono, ale narzędzia nie pojawiają się: uruchom ponownie polecenie połączenia z --scope user lub wykonaj claude mcp remove ismscopilot i dodaj ponownie.
  • Uwierzytelnianie nie powiodło się lub "wymaga uwierzytelnienia": połączenie przez logowanie zostało odłączone lub wygasło: uruchom /mcp i zaloguj się ponownie. Token mógł zostać cofnięty lub wygasł: utwórz nowy w Ustawieniach, Połączone aplikacje.
  • Tryb Think nie wydaje się głębszy: Tryb Think wymaga płatnego planu. W darmowym planie przechodzi na Fast.
  • Beyond uruchomił się jako normalna odpowiedź: orkiestrator prawdopodobnie pominął mode. Poproś go, aby wysłał mode: "beyond", lub powiedz „użyj Beyond” w następnej turze. Sprawdź beyond_denied_reason, jeśli żądanie Beyond zostało obniżone.
  • Błąd limitu użytkowania: zobacz sekcję Jeśli napotkasz limit użytkowania.

Na tej stronie