Przegląd MCP
Serwer MCP UserJot umożliwia narzędziom AI bezpośrednie łączenie się z Twoim obszarem roboczym UserJot przez zdalne HTTP — bez konieczności instalowania lokalnego pakietu ani procesu pośredniczącego.
Adres URL serwera
UserJot udostępnia jeden zdalny punkt końcowy MCP:
https://api.userjot.com/v1/mcpUwierzytelnianie
Większość nowoczesnych klientów MCP obsługuje bezpośrednie logowanie przez OAuth. Wklej adres URL serwera (lub użyj przycisku instalacji jednym kliknięciem albo polecenia w Settings → MCP & API; VS Code i Gemini CLI znajdziesz w menu More), zaloguj się do UserJot, wybierz obszar roboczy i kliknij Allow.
Klient | Zalecana metoda uwierzytelniania | Instrukcja konfiguracji |
|---|---|---|
Claude (web, komputer, urządzenia mobilne) | OAuth (instalacja jednym kliknięciem w Ustawieniach → MCP & API) | |
Claude Code | OAuth (lub token API) | |
Cursor | OAuth (instalacja jednym kliknięciem w Ustawieniach → MCP & API) lub token API | |
Codex | OAuth (lub token API) | |
ChatGPT | OAuth (lub token API na komputerze) | |
VS Code (Copilot) | OAuth (w menu More w Settings → MCP & API) | |
Gemini CLI | OAuth (w menu More w Settings → MCP & API) | |
Windsurf i narzędzia bez interfejsu/CI | Nagłówek tokenu API |
Aplikacje połączone przez OAuth są widoczne w sekcji Connected apps w Settings → MCP & API. Zobaczysz tam, kto połączył każdą aplikację. Użyj opcji Hold to revoke, aby zablokować dostęp aplikacji przy jej następnym żądaniu.
Aplikację OAuth mogą połączyć tylko właściciele i administratorzy obszaru roboczego. Połączona aplikacja działa tylko wtedy, gdy osoba, która ją połączyła, nadal ma uprawnienia właściciela lub administratora.
W przypadku klientów wymagających statycznego nagłówka lub skryptów automatyzujących utwórz token API w Ustawieniach → MCP & API i przekaż:
Authorization: Bearer YOUR_USERJOT_API_TOKENMożliwości serwera MCP
Zdalny serwer MCP udostępnia 98 narzędzi do obsługi danych i przepływów pracy w obszarze roboczym (dwie operacje REST: przesyłanie wieloczęściowe createAsset i usuwanie danych zgodnie z RODO deleteMember są dostępne wyłącznie przez REST):
Obszar roboczy i tablice: Wyświetlanie metadanych obszaru roboczego oraz tworzenie, wyświetlanie, aktualizowanie i usuwanie tablic.
Zgłoszenia, komentarze, głosy i tagi: Wyświetlanie, tworzenie, aktualizowanie, przenoszenie i łączenie zgłoszeń, rozdzielanie połączonych zgłoszeń, wyszukiwanie podobnych zgłoszeń, zarządzanie subskrypcjami, publikowanie i przypinanie komentarzy, dodawanie i usuwanie głosów, zarządzanie tagami oraz dołączanie obrazów.
Dziennik zmian: Wyświetlanie, tworzenie, aktualizowanie i usuwanie wpisów oraz zarządzanie powiązanymi zgłoszeniami, autorami i tagami.
Rozmowy: wyświetlanie listy i odczytywanie rozmów, rozpoczynanie rozmów wychodzących (
createConversationwymaga płatnego planu: 5 dziennie w planie Starter, 15 w planie Professional), przeglądanie osi czasu, publikowanie odpowiedzi i notatek wewnętrznych oraz aktualizowanie statusu lub osoby przypisanej.Użytkownicy i firmy: Wyszukiwanie, wyświetlanie, synchronizowanie i aktualizowanie użytkowników oraz firm, a także zarządzanie członkostwem w firmach.
Centrum pomocy: Tworzenie, aktualizowanie, usuwanie, publikowanie i wycofywanie publikacji oraz wyszukiwanie kolekcji i artykułów.
Zasoby: importowanie obrazów zdalnych lub tworzenie podpisanych adresów URL do przesyłania plików na potrzeby dzienników zmian i artykułów pomocy.
Wszystkie narzędzia zapisujące i usuwające dane mają pełne uprawnienia do obszaru roboczego i są oznaczone jako destrukcyjne, aby klienci pytały o potwierdzenie przed wprowadzeniem zmian.
Limity liczby żądań i dostępność w planach
MCP jest dostępne w każdym planie, także Free. Wywołania narzędzi podlegają limitom API REST obowiązującym w Twoim obszarze roboczym: 10 żądań/min (150/godz.) w planie Free, 60 żądań/min (1500/godz.) w planie Starter i 120 żądań/min (5000/godz.) w planie Professional. Intensywne sesje agentów mogą szybko wyczerpać limit planu Free.
MCP a REST API
Użyj MCP, aby połączyć asystenta AI lub narzędzie programistyczne obsługujące Model Context Protocol. Użyj API REST, jeśli tworzysz własną integrację zaplecza, skrypt lub kod aplikacji.
Obsługa tokenów
Jeśli zamiast OAuth używasz tokenu API, traktuj go jak każdy inny sekret:
Nie umieszczaj go na stałe w plikach konfiguracyjnych dodawanych do repozytorium.
Korzystaj ze zmiennych środowiskowych lub lokalnego menedżera sekretów.
Używaj osobnych tokenów dla różnych środowisk lub członków zespołu.
Unieważniaj nieużywane tokeny w Settings → MCP & API, używając opcji Hold to revoke.
Następne kroki
Skorzystaj z instrukcji Wspólna konfiguracja, aby skonfigurować OAuth, Claude w wersji webowej/komputerowej, VS Code, Gemini CLI lub ogólną konfigurację JSON.
Przejdź bezpośrednio do instrukcji dla Claude Code, Cursor, Codex, ChatGPT lub Windsurf.