Typowa konfiguracja

Shayan TaslimZaktualizowano

UserJot nie wymaga lokalnego pakietu MCP. Połącz klienta bezpośrednio ze zdalnym adresem URL serwera MCP UserJot, a następnie zaloguj się przez OAuth lub przekaż token API.

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

Zaloguj się przez OAuth (zalecane)

Otwórz Ustawienia → MCP i API w panelu UserJot, aby skorzystać z przycisków instalacji jednym kliknięciem i poleceń do skopiowania. Gdy klient poprosi o zalogowanie, w przeglądarce otworzy się UserJot. Wybierz obszar roboczy i kliknij Zezwól.

  • Claude (w przeglądarce, na komputerze i urządzeniu mobilnym): Wybierz Claude w Ustawieniach → MCP i API, a następnie kliknij Dodaj do Claude. Claude otworzy się z wstępnie wypełnionym łącznikiem. Potwierdź, klikając Dodaj, i zaloguj się.

  • VS Code (tryb agenta Copilot): Otwórz Więcej → VS Code w Ustawieniach → MCP & API i kliknij Dodaj do VS Code, a następnie potwierdź, klikając Zainstaluj, i zaloguj się.

  • Gemini CLI: Otwórz Więcej → Gemini CLI w Ustawieniach → MCP & API lub uruchom to polecenie w terminalu, a następnie uruchom /mcp auth userjot w Gemini CLI, aby się zalogować:

Bash
gemini mcp add --transport http --scope user userjot https://api.userjot.com/v1/mcp

Połączone aplikacje są widoczne w sekcji Połączone aplikacje w Ustawieniach → MCP & API wraz z nazwą właściciela lub administratora, który je autoryzował. Aplikacja pozostaje aktywna tylko wtedy, gdy ta osoba nadal jest właścicielem lub administratorem obszaru roboczego. Użyj opcji Przytrzymaj, aby unieważnić, aby natychmiast odłączyć dostęp.

Użyj tokenu API

W przypadku klientów wymagających własnego nagłówka (takich jak Windsurf) lub środowisk bez interfejsu graficznego utwórz token w Ustawieniach → MCP i API i przekaż:

text
Server URL:    https://api.userjot.com/v1/mcp
Authorization: Bearer YOUR_USERJOT_API_TOKEN

Większość zdalnych klientów MCP HTTP akceptuje konfigurację JSON w takim formacie (w przypadku klientów OAuth pomiń blok headers):

JSON
{
  "mcpServers": {
    "userjot": {
      "type": "http",
      "url": "https://api.userjot.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_USERJOT_API_TOKEN"
      }
    }
  }
}

Sprawdź połączenie

Po nawiązaniu połączenia poproś klienta o sprawdzenie serwera userjot lub wywołanie getWorkspace. Jeśli połączenie działa, klient wyświetli szczegóły Twojego obszaru roboczego i dostępne narzędzia bez konieczności lokalnej konfiguracji.

Rozwiązywanie problemów

Jeśli połączenie nie działa, najpierw sprawdź:

  • Jeśli logujesz się przez OAuth, sprawdź, czy aplikacja nadal jest widoczna w sekcji Połączone aplikacje w Ustawieniach → MCP i API oraz czy nadal jesteś właścicielem lub administratorem obszaru roboczego.

  • Jeśli używasz tokenu API, sprawdź, czy nie został on unieważniony i czy nagłówek Authorization zaczyna się od Bearer .

  • Sprawdź, czy Twój klient obsługuje zdalne serwery MCP przez HTTP (Streamable HTTP).

  • Sprawdź, czy plik konfiguracyjny znajduje się we właściwej lokalizacji. Po jego edycji uruchom ponownie klienta.

  • Sprawdź, czy nie został przekroczony limit szybkości API w Twoim planie.

Następne kroki

  • Zapoznaj się ze wszystkimi 98 dostępnymi narzędziami i szczegółami dotyczącymi bezpieczeństwa w sekcji Przegląd MCP.

  • Jeśli tworzysz kod bezpośrednio dla backendu, użyj REST API.

Czy ten artykuł odpowiedział na Twoje pytanie?