MCP – Überblick

Shayan TaslimAktualisiert

Mit dem UserJot-MCP-Server können sich KI-Tools direkt über Remote-HTTP mit deinem UserJot-Arbeitsbereich verbinden. Dafür musst du weder ein lokales Paket noch einen Bridge-Prozess installieren.

Server-URL

UserJot stellt einen Remote-MCP-Endpunkt bereit:

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

Authentifizierung

Die meisten modernen MCP-Clients unterstützen die OAuth-Anmeldung direkt. Füge die Server-URL ein (oder verwende die Schaltfläche bzw. den Befehl zur Installation mit einem Klick unter Einstellungen → MCP & API; VS Code und Gemini CLI findest du im Menü Mehr), melde dich bei UserJot an, wähle deinen Arbeitsbereich aus und klicke auf Zulassen.

Client

Empfohlene Authentifizierung

Einrichtungsanleitung

Claude (Web, Desktop, Mobilgeräte)

OAuth (mit einem Klick unter Einstellungen → MCP & API)

Allgemeine Einrichtung

Claude Code

OAuth (oder API-Token)

Claude Code

Cursor

OAuth (mit einem Klick unter Einstellungen → MCP & API) oder API-Token

Cursor

Codex

OAuth (oder API-Token)

Codex

ChatGPT

OAuth (oder API-Token auf dem Desktop)

ChatGPT

VS Code (Copilot)

OAuth (unter Mehr in Einstellungen → MCP & API)

Allgemeine Einrichtung

Gemini CLI

OAuth (unter Mehr in Einstellungen → MCP & API)

Allgemeine Einrichtung

Windsurf und Headless-/CI-Tools

API-Token-Header

Windsurf / Allgemeine Einrichtung

Über OAuth verbundene Apps werden unter Verbundene Apps in Einstellungen → MCP & API angezeigt. Dort siehst du, wer die jeweilige App verbunden hat. Verwende Zum Widerrufen gedrückt halten, um den Zugriff einer App bei ihrer nächsten Anfrage zu sperren.

Note

Nur Arbeitsbereichsinhaber und Administratoren können eine OAuth-App verbinden. Eine verbundene App funktioniert nur so lange, wie die Person, die sie verbunden hat, Inhaber oder Administrator bleibt.

Bei Clients, die einen statischen Header oder automatisierte Skripte erfordern, erstellst du unter Einstellungen → MCP & API ein API-Token und übergibst:

text
Authorization: Bearer YOUR_USERJOT_API_TOKEN

Was der MCP-Server kann

Der Remote-MCP-Server stellt 98 Tools für die Daten und Workflows deines Arbeitsbereichs bereit (zwei REST-Operationen – Multipart-Upload createAsset und DSGVO-Löschung deleteMember – sind nur über REST verfügbar):

  • Arbeitsbereich und Boards: Arbeitsbereichsmetadaten anzeigen sowie Boards erstellen, auflisten, aktualisieren oder löschen.

  • Anfragen, Kommentare, Stimmen und Tags: Anfragen auflisten, erstellen, aktualisieren, verschieben und zusammenführen oder die Zusammenführung aufheben, ähnliche Anfragen finden, Abonnements verwalten, Kommentare veröffentlichen und anheften, Stimmen hinzufügen oder entfernen, Tags verwalten und Bilder anhängen.

  • Changelog: Einträge auflisten, erstellen, aktualisieren und löschen sowie verknüpfte Anfragen, Autoren und Tags verwalten.

  • Unterhaltungen: Unterhaltungen auflisten, lesen und ausgehend starten (createConversation erfordert einen kostenpflichtigen Tarif: 5 pro Tag im Starter-Tarif, 15 pro Tag im Professional-Tarif), Zeitachsen lesen, Antworten und interne Notizen veröffentlichen sowie Status oder zuständige Person aktualisieren.

  • Mitglieder und Unternehmen: Mitglieder und Unternehmen suchen, auflisten, synchronisieren und aktualisieren sowie Unternehmensmitgliedschaften verwalten.

  • Hilfe-Center: Sammlungen und Artikel erstellen, aktualisieren, löschen, veröffentlichen, die Veröffentlichung aufheben und durchsuchen.

  • Assets: Remote-Bilder importieren oder vorab signierte Uploads für Änderungsprotokolle und Hilfeartikel erstellen.

Für alle Tools zum Ändern und Löschen gelten die vollen Berechtigungen des Arbeitsbereichs. Sie sind als destruktiv gekennzeichnet, damit Clients vor einer Datenänderung nachfragen.

Ratenbegrenzungen und Tarifzugriff

MCP ist in allen Tarifen verfügbar, auch im Free-Tarif. Tool-Aufrufe nutzen dieselben Ratenbegrenzungen wie die REST API deines Arbeitsbereichs: 10 Anfragen/Min. (150/Std.) bei Free, 60 Anfragen/Min. (1.500/Std.) bei Starter und 120 Anfragen/Min. (5.000/Std.) bei Professional. Bei intensiven Agent-Sitzungen kann das Limit des Free-Tarifs schnell erreicht sein.

MCP im Vergleich zur REST-API

Verwende MCP, wenn du einen KI-Assistenten oder ein Coding-Tool verbindest, das das Model Context Protocol unterstützt. Verwende die REST API, wenn du eine eigene Backend-Integration, ein Skript oder Anwendungscode erstellst.

Umgang mit Tokens

Wenn du statt OAuth ein API-Token verwendest, behandle es wie jedes andere Geheimnis:

  • Schreibe es nicht fest in Dateien mit Konfigurationen, die ins Repository übernommen werden.

  • Verwende vorzugsweise Umgebungsvariablen oder einen lokalen Secrets-Manager.

  • Verwende separate Tokens für verschiedene Umgebungen oder Teammitglieder.

  • Widerrufe nicht verwendete Tokens unter Einstellungen → MCP & API mit Zum Widerrufen gedrückt halten.

Nächste Schritte

Hat das Ihre Frage beantwortet?