Skip to main content
Claude Code kann sich mit dem entfernten MCP-Endpunkt NOVAPLAN_WORKSPACE_URL/mcp verbinden: mit einem persönlichen Zugriffstoken für den eigenen Client oder mit einer OAuth-Anwendung für gemeinsam verwaltete Einrichtungen. Für diese direkte Verbindung wird keine lokale Stdio-Brücke benötigt. Deren /api/v1-Basis-URL gilt hier nicht.

​
Mit persönlichem Zugriffstoken verbinden

  1. Erstellen Sie unter Developer Settings → Personal Access Tokens ein Token für Ihr eigenes Konto mit den benötigten Scopes. Übernehmen Sie die MCP-URL und den Token aus dem einmal angezeigten Paste-Block in einen lokalen Secret-Speicher oder in die Umgebungsvariablen PIPESHUB_MCP_URL und PIPESHUB_MCP_TOKEN. Diese Namen sind technische Kennungen des derzeitigen Token-Ablaufs. Die URL endet bereits auf /mcp.
  2. Legen Sie im Projekt eine .mcp.json mit Variablenreferenzen statt einem echten Tokenwert an:
  1. Prüfen Sie die Verbindung mit claude mcp list und einer zulässigen Testabfrage. Claude Code ersetzt Umgebungsvariablen in entfernten Server-URLs und Headern. Beide Variablen müssen beim Start von Claude Code verfügbar sein.
Für einen entfernten Workspace muss die MCP-URL HTTPS verwenden, da der Token bei jeder Anfrage als Bearer-Header gesendet wird. Speichern Sie den Token niemals direkt in einer eingecheckten Projektdatei. Widerrufen Sie einen offengelegten Token unter Personal Access Tokens. Lassen Sie die Verfügbarkeit von PAT und MCP in Ihrem verwalteten Workspace von Novaplan bestätigen.

​
Mit OAuth-Anwendung verbinden

Für eine gemeinsam oder administrativ verwaltete Einrichtung erstellen Sie eine Novaplan-OAuth-Anwendung und sichern Client ID und Client Secret. Der MCP-Überblick beschreibt die Einrichtung.
Claude Code kann mit oauth.scopes eine freigegebene Teilmenge der OAuth-Scopes anfordern. Ohne diese Einstellung verwendet eine aktuelle Claude-Code-Version die Scopes aus der Authentifizierungsantwort oder den Metadaten der geschützten Ressource, sofern dort Scopes angegeben sind. Die Novaplan-OAuth-Anwendung muss die tatsächlich angeforderten Scopes erlauben. Wenn die serverseitig bekannt gegebenen Standardwerte angepasst werden müssen, stimmen Sie dies mit Novaplan ab.

​
Verbindung mit der CLI hinzufügen

Der Name novaplan ist ein lokaler Alias. --client-secret ohne Wert fordert bei Hinzufügen des Servers eine verdeckte Eingabe an. Wenn die Verbindung für alle Ihre Projekte gelten soll, ergänzen Sie --scope user. Verwenden Sie die vom Workspace bereitgestellte URL und veröffentlichen Sie das Secret nicht in einer Projektdatei. Hinterlegen Sie in der Novaplan-OAuth-Anwendung die Redirect URI für den gewählten Callback-Port, beispielsweise http://localhost:8080/callback.

​
Alternative: JSON und Projektkonfiguration

Sie können dieselbe Verbindung mit claude mcp add-json hinzufügen. Das Secret wird separat abgefragt:
Wenn die Konfiguration für ein Projekt freigegeben werden soll, führen Sie den obigen CLI-Befehl im Projektordner mit --scope project aus. Claude Code legt dann .mcp.json mit der nicht geheimen Serverkonfiguration an. Prüfen Sie die Datei vor dem Einchecken; alle Teammitglieder benötigen weiterhin eigenen Workspace-Zugang und müssen sich selbst anmelden. Claude Code speichert das bei der Einrichtung eingegebene Secret außerhalb dieser Projektdatei. Wo es liegt, hängt vom Betriebssystem ab. Für einen engeren Scope-Satz tragen Sie in der JSON-Konfiguration unter oauth.scopes eine einzelne, durch Leerzeichen getrennte Zeichenfolge der für die benötigten Werkzeuge freigegebenen Scopes ein und melden sich erneut an. Das aktuelle Format steht in der Claude-Code-Dokumentation.

​
Anmelden und prüfen

Öffnen Sie in Claude Code /mcp und folgen Sie der Browseranmeldung. Mit claude mcp list oder claude mcp get novaplan prüfen Sie den Servereintrag. Bei einem Anmeldefehler vergleichen Sie Callback-Port, Redirect URI, Client ID sowie die angeforderten und in der OAuth-Anwendung erlaubten Scopes.