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/mcpTransport: 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.