Połącz ISMS Copilot z Claude Code

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

Czego potrzebujesz

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

Połączenie w trzech krokach

Masz już połączenie z osobistym tokenem dostępu? Najpierw usuń ten serwer, w przeciwnym razie Claude Code nadal będzie go 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

2. 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.
3. Zaloguj się do ISMS Copilot i kliknij Zatwierdź na stronie zgody.

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

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ę. Dla Cursor i Codex zobacz Połącz Cursor i Codex.

Awaryjne rozwiązanie: połączenie 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ć tylko poniższe czynności, nic więcej. Połączenie przez logowanie otrzymuje wszystkie poniższe uprawnienia; token otrzymuje tylko te, które obejmują jego uprawnienia:

Dzięki temu z poziomu narzędzia AI możesz wyświetlić listę swoich przestrzeni roboczych i dokumentów, utworzyć prywatną przestrzeń roboczą, dodać lub edytować wspomnienie oraz prowadzić zakorzenioną rozmowę z ISMS Copilot, wszystko bez opuszczania edytora.

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

Gdy rozpoczynasz lub kontynuujesz rozmowę z poziomu narzędzia AI, wybierasz tryb. Połączenie nie wybiera go na podstawie pytania. Jeśli orkiestrator pominie mode, ISMS Copilot używa Fast.

• Fast (domyślnie): szybkie odpowiedzi, bez rozszerzonego rozumowania.
• Think: głębsze rozumowanie dla trudniejszych pytań. 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 zostanie zakończone. 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. Orkiestrator nie uaktualni trudnego pytania samodzielnie.

Tura 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): tekst błędu podaje limit i czas jego odnowienia, bez zachęty do zmiany planu. JSON zawiera reset_at, ale nigdy upgrade_url, usage_url ani extra_usage_buyable. Opisane niżej pola dotyczące zmiany planu i zakupu pojawiają się tylko w połączeniach z osobistym tokenem dostępu.

Połączenie wykorzystuje to samo 4-godzinne okno sesji UTC co aplikacja czatu. Jeśli create_conversation lub send_message napotka limit, pierwszy komunikat o błędzie zawiera informację o czasie oczekiwania lub uaktualnieniu (w tym czasie 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 komunikat zespołowy: 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 zawiera linku 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 twój plan umożliwia przepełnienie (indywidualne konta płatne z wyłączoną Zaawansowaną Ochroną Danych; nigdy w puli zespołowej), powiedz orkiestratorowi, aby kontynuował: na twoje wyraźne polecenie ponownie wyśle z overflow_consent: true i tura zostanie uruchomiona na tym samym, do dwukrotnie większym przepełnieniu, które oferuje aplikacja webowa (odpowiedź zawiera overflow_active: true).
4. Nadal korzystać z narzędzi do odczytu. Przestrzenie robocze, wspomnienia, 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 webowej

Chronione ustawienia konta są tylko do odczytu z poziomu połączenia (kontekst firmy, jak wspomniano powyżej, to jedyny profil, który token z company_context:write może zastąpić). W szczególności Zaawansowana Ochrona Danych (która kieruje twoje dane przez dostawcę z siedzibą w UE, bez retencji) 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 ona 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.

Uprawnienia

Gdy logujesz się i klikasz Zatwierdź, narzędzie otrzymuje jeden stały zestaw: odczyt twojego konta, przestrzeni roboczych, dokumentów (metadane), wspomnień i profilu firmy; zadawanie pytań ISMS Copilot i odczytywanie odpowiedzi; aktualizowanie profilu firmy i wspomnień oraz tworzenie przestrzeni roboczych. Nie może tworzyć kluczy API ani kupować kredytów. Zmiany wprowadzane 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 tworzysz token, wybierasz dokładnie, co może robić (odczytywać przestrzenie robocze, odczytywać dokumenty, odczytywać i zapisywać wspomnienia, rozpoczynać rozmowy itp.). Przyznaj tylko to, czego potrzebujesz. Token, który tylko odczytuje twoje przestrzenie robocze, nie może zmieniać wspomnień ani rozpoczynać rozmów.

Możesz zobaczyć i odłączyć każde połączenie w dowolnym momencie w Ustawieniach, Połączone aplikacje: tokeny w liście tokenów, połączenia logowania w sekcji Połączone agenty.

Ponowne łączenie lub rotacja tokena

Jeśli połączenie logowania 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 zachowa stary token:

claude mcp remove ismscopilot

Następnie dodaj serwer ponownie, logując się lub używając nowego tokena.

Bezpieczeństwo

• Połączenie działa w twoim imieniu, więc może uzyskać dostęp dokładnie do tego, do czego twoje konto już ma dostęp, ograniczone tym, co zatwierdziłeś lub uprawnieniami, które przyznałeś.
• Jest objęte twoją subskrypcją, bez osobnych opłat.
• Możesz odłączyć je 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 uruchom claude mcp remove ismscopilot i dodaj je ponownie.
• Uwierzytelnianie nie powiodło się lub "wymaga uwierzytelnienia": połączenie logowania 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 o wysłanie mode: "beyond" lub powiedz „użyj Beyond” w następnej turze. Sprawdź beyond_denied_reason, jeśli żądanie Beyond zostało obniżone.
• Niektóre funkcje nie działają: sprawdź, czy masz odpowiedni plan i uprawnienia. Na przykład Beyond i Think wymagają płatnego planu.