Przegląd MCP

Shayan TaslimZaktualizowano

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:

text
https://api.userjot.com/v1/mcp

Uwierzytelnianie

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)

Wspólna konfiguracja

Claude Code

OAuth (lub token API)

Claude Code

Cursor

OAuth (instalacja jednym kliknięciem w Ustawieniach → MCP & API) lub token API

Cursor

Codex

OAuth (lub token API)

Codex

ChatGPT

OAuth (lub token API na komputerze)

ChatGPT

VS Code (Copilot)

OAuth (w menu More w Settings → MCP & API)

Wspólna konfiguracja

Gemini CLI

OAuth (w menu More w Settings → MCP & API)

Wspólna konfiguracja

Windsurf i narzędzia bez interfejsu/CI

Nagłówek tokenu API

Windsurf / Wspólna konfiguracja

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.

Note

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ż:

text
Authorization: Bearer YOUR_USERJOT_API_TOKEN

Moż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 (createConversation wymaga 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

Czy ten artykuł odpowiedział na Twoje pytanie?