ISMS Copilot Docs

Połączenie Cursor i Codex

Podłącz konto MCP ISMS Copilot do Cursor lub Codex za pomocą adresu URL punktu końcowego i nagłówka Bearer pat-isms.

Cursor i Codex obsługują MCP przez HTTP. Punkt końcowy i dane uwierzytelniające są takie same jak dla Claude Code, różni się jedynie plik konfiguracyjny. Na tej stronie znajdziesz schematy konfiguracji oraz sprawdzenia potwierdzające, że połączenie działa.

1. Utwórz token

W serwisie chat.ismscopilot.com otwórz Ustawienia → Connected apps → Create token. Przyznaj wymagane zakresy, skopiuj wartość pat-isms-… i upewnij się, że nie trafiła do zatwierdzonych plików.

Aby zapoznać się z listą możliwości i dowiedzieć, co może robić każde narzędzie, zobacz ISMS Copilot dla agentów. Informacje na temat zakresów i cyklu życia tokenów znajdziesz w sekcji Tokeny i zakresy.

2. Punkt końcowy

https://account.ismscopilot.com/v1/account/mcp

Transport: HTTP MCP. Uwierzytelnianie: Authorization: Bearer pat-isms-…

3. Konfiguracja Cursor

Cursor odczytuje serwery MCP z pliku mcp.json: na poziomie projektu w .cursor/mcp.json lub globalnie w ~/.cursor/mcp.json. Od września 2026 r. wpis serwera HTTP z niestandardowymi nagłówkami wygląda następująco:

{
  "mcpServers": {
    "ismscopilot": {
      "url": "https://account.ismscopilot.com/v1/account/mcp",
      "headers": {
        "Authorization": "Bearer pat-isms-..."
      }
    }
  }
}

Dodaj wpis (w Ustawieniach Cursor, w sekcji MCP, lub utwórz plik bezpośrednio), następnie zrestartuj Cursor i potwierdź, że ismscopilot pojawił się na liście narzędzi MCP.

Jest to standardowy wpis serwera HTTP MCP z niestandardowym nagłówkiem Authorization. Jeśli wersja Cursor obsługuje jedynie łączniki OAuth lub nie obsługuje niestandardowych nagłówków, nie może jeszcze korzystać z tej ścieżki. Przed debugowaniem tokenu sprawdź dokumentację MCP dla tej wersji klienta.

4. Konfiguracja Codex

Codex odczytuje plik ~/.codex/config.toml. Od września 2026 r. wpis serwera HTTP MCP wygląda następująco:

[mcp_servers.ismscopilot]
url = "https://account.ismscopilot.com/v1/account/mcp"

[mcp_servers.ismscopilot.http_headers]
"Authorization" = "Bearer pat-isms-..."

Zrestartuj Codex po edycji. Jeśli Twoja wersja Codex używa innej nazwy klucza dla nagłówków HTTP, postępuj zgodnie z jego aktualną dokumentacją MCP. Stałe elementy to adres URL i nagłówek Bearer pat-isms-….

5. Test połączenia

Poproś orkiestrator o wyświetlenie listy przestrzeni roboczych ISMS Copilot. Jeśli narzędzia nie pojawiają się:

  • zrestartuj klienta po dodaniu serwera,
  • upewnij się, że token nie został przycięty podczas wklejania (powinien zaczynać się od pat-isms-),
  • upewnij się, że adres URL to host konta podany powyżej, a nie host API.

Jeśli osiągniesz limit użycia

Połączenie korzysta z tego samego 4-godzinnego okna sesji UTC co aplikacja czatu. Jeśli create_conversation lub send_message osiągnie limit, pierwszy komunikat o błędzie zawiera informację o konieczności odczekania lub uaktualnieniu (wraz z czasem 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 dla zespołu: poproś właściciela o dodatkowe użycie lub odczekaj do następnego 4-godzinnego okna. Ich JSON zawiera quota_scope, org_role oraz extra_usage_buyable, ale nie zawiera linku do uaktualnienia.

Odczekaj do reset_at lub otwórz upgrade_url w przeglądarce, będąc zalogowanym na to samo konto ISMS Copilot (konta indywidualne i właściciele organizacji). Gdy JSON zawiera fallback_available: true, a Twój plan ma dostępny bufor (konta indywidualne płatne z wyłączoną Zaawansowaną Ochroną Danych, nigdy w puli zespołowej), możesz również polecić orkiestratorowi kontynuowanie: po jawnej zgodzie ponownie wysyła żądanie z overflow_consent: true, a tura działa z tym samym buforem do 2x, który oferuje aplikacja webowa (odpowiedź zawiera overflow_active: true). Narzędzia do odczytu nadal działają po osiągnięciu limitu czatu.

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

6. Rotacja

W celu regularnej rotacji wygeneruj nowy token, zastąp stary token w mcp.json (Cursor) lub config.toml (Codex), zrestartuj klienta i przeprowadź test połączenia. Następnie unieważnij stary token w Ustawieniach. Jeśli stary token mógł zostać ujawniony, unieważnij go natychmiast przed skonfigurowaniem nowego.

Token działa w Twoim imieniu. Przyznaj jedynie niezbędne zakresy i unieważniaj nieużywane tokeny.

Na tej stronie