MCP - MCP in Workpath einrichten – Help Center (DE)

Voraussetzungen

Du benötigst Administratorzugang in Workpath.
Eine MCP-kompatible Anwendung (z. B. Claude Desktop).

Claude Desktop

Schritt 1: MCP-Zugangsdaten in Workpath erstellen

Gehe zu Organisationseinstellungen > Integrationen > Verbindungen.
Klicke auf den MCP-Eintrag.
Klicke auf MCP einrichten.
Gib einen Namen für deine MCP-Anwendung ein.
Klicke auf Absenden.
Kopiere die URL, Client-ID und das Client-Secret - du brauchst diese im nächsten Schritt.

Schritt 2: Anwendung verbinden

Am Beispiel von Claude Desktop:

Klicke auf das Koffer-Symbol.
Unter Connectors klicke auf Add custom connector.
Gib einen Namen ein (z. B. "Workpath").
Füge die URL aus Schritt 1 ein.
Unter Advanced settings füge die Client-ID und das Client-Secret ein.

Schritt 3: Verbindung autorisieren

Der neue Connector wird als Not Connected angezeigt.
Klicke auf Connect.
Melde dich mit deinen Workpath-Zugangsdaten an.
Erlaube der Anwendung, Daten in deinem Namen zu lesen und zu schreiben.
Der Connector sollte nun als erfolgreich authentifiziert angezeigt werden.

Claude Code

claude mcp add --scope user --transport http --client-id "<CLIENT_ID>" --client-secret "workpath" "https://mcp.workpath.com/mcp"

Falls du Workpath MCP entfernen musst (z. B. aufgrund einer fehlgeschlagenen Authentifizierung durch ein fehlerhaftes Setup), findest du hier ein kurzes Snippet:

claude mcp remove workpath

Here are the two missing German sections, matching your existing style (informal "du", English UI/command terms left as-is). I kept it to exactly what your published English article says, so the Codex CLI troubleshooting stops at the `rm -rf` line.

Codex App

Codex speichert seine MCP-Konfiguration in einer einzigen Datei, die sowohl von der Desktop-App als auch vom CLI verwendet wird: ~/.codex/config.toml (macOS/Linux) bzw. %USERPROFILE%\.codex\config.toml (Windows). Da Codex kein Feld zum Einfügen vorregistrierter OAuth-Zugangsdaten bietet, wird die Workpath-Verbindung in dieser Datei über das Hilfsprogramm mcp-remote eingerichtet, das die Anmeldung durchführt und dein Token automatisch aktualisiert.

Voraussetzung: Node.js muss installiert sein (es stellt den Befehl npx bereit).

Schritt 1: Workpath zur Codex-Konfiguration hinzufügen

Öffne ~/.codex/config.toml (erstelle die Datei, falls sie nicht existiert) und füge den folgenden Block ein. Setze dabei die Client-ID und das Client-Secret aus "MCP-Zugangsdaten erstellen" (oben) ein:

toml
[mcp_servers.workpath]
command = "npx"
args = [
   "-y",
   "mcp-remote@latest",
   "https://mcp.workpath.com/mcp",
   "--static-oauth-client-info",
   "{\"client_id\":\"<CLIENT_ID>\",\"client_secret\":\"<CLIENT_SECRET>\"}",
]
startup_timeout_sec = 60.0

Falls Codex meldet, dass npx nicht gefunden werden kann (häufig, wenn Node über nvm verwaltet wird), ersetze "npx" durch den vollständigen Pfad. Diesen findest du, indem du which npx im Terminal ausführst, z. B. /Users/you/.nvm/versions/node/v24.14.0/bin/npx.

Schritt 2: Neu starten und autorisieren

Speichere die Datei und beende Codex vollständig und starte es neu. Bitte Codex anschließend, ein Workpath-Tool zu verwenden, zum Beispiel "liste meine Zyklen auf". Beim ersten Mal öffnet sich ein Browserfenster - melde dich mit deinen Workpath-Zugangsdaten an und erteile den Zugriff. Dein Token wird lokal gespeichert und ab dann automatisch aktualisiert, sodass du dich nur einmal anmelden musst.

Codex CLI

Das Codex CLI verwendet dieselbe ~/.codex/config.toml wie die Codex-App (siehe oben). Wenn du das Codex-App-Setup bereits abgeschlossen hast, funktioniert das CLI ohne weitere Schritte.

Wenn du nur das CLI nutzt, füge denselben [mcp_servers.workpath]-Block aus dem Abschnitt "Codex App" zu ~/.codex/config.toml hinzu und löse anschließend die einmalige Anmeldung aus, indem du einen Prompt ausführst, der ein Workpath-Tool verwendet:

codex exec "List my Workpath cycles using the workpath MCP server."

Beim ersten Ausführen öffnet sich ein Browser zur Anmeldung; danach wird das Token automatisch aktualisiert. Um zu prüfen, ob der Server registriert ist, führe aus:

codex mcp list

Fehlerbehebung: Falls du jemals einen Authentifizierungsfehler erhältst, lösche die zwischengespeicherten Tokens und versuche es erneut:

rm -rf ~/.mcp-auth/mcp-remote-*

Was enthalten ist

Die MCP-Integration bietet ~30 Lese-Tools, darunter:

Ziele, Key Results und Initiativen suchen und abrufen
Alignment-Vorschläge und Kollaborationsanfragen abrufen
Zyklen, Teams, KPIs und Labels nachschlagen
Notizen und Quality Checks einsehen

Du kannst diese Tools nutzen, um Fragen zu deinen Workpath-Daten zu stellen, Präsentationen zu erstellen oder Workpath-Kontext in deinen bevorzugten KI-gestützten Workflow zu integrieren.