Skip to main content

​
Was ist der Novaplan AI MCP-Server?

Novaplan AI stellt unter /mcp einen entfernten MCP-Endpunkt über Streamable HTTP bereit. MCP-Clients verbinden sich direkt mit diesem Endpunkt; für diese Verbindung sind weder ein lokales npm-Paket noch ein stdio-Prozess erforderlich. Damit können Clients wie Cursor, Claude Code, Gemini CLI, Claude.ai, LibreChat und Omnigent indexierte Dokumente Ihrer Organisation durchsuchen, Fragen dazu stellen, Personen und Gruppen finden sowie Dateien herunterladen.
Die einzelnen verfügbaren Werkzeuge, Argumente und Einsatzfälle stehen in der Werkzeugreferenz. Die Anleitung für Coding-Agenten bietet einen Einstieg für Entwicklungsumgebungen.
QM ist kein MCP-Client. Die Integration verwendet eine CLI im Agenten-Sandbox-Prozess. Die bestehende technische Anleitung enthält den dazugehörigen Befehl.

​
Voraussetzungen

  • Zugang zu einem bestehenden Novaplan AI Workspace und seiner Adresse. Falls der Zugang noch nicht eingerichtet ist, wenden Sie sich an Novaplan Support.
  • Entweder eine OAuth-Anwendung oder ein persönliches Zugriffstoken, abhängig vom Client.
Novaplan übernimmt den Großteil der Einrichtung. Die folgenden Schritte bleiben als Referenz für Administratoren und Integrationsverantwortliche verfügbar; stimmen Sie Änderungen an der Zugriffsverwaltung mit dem Novaplan-Team ab.
Die meisten unten genannten Client-Anleitungen verwenden OAuth und benötigen eine OAuth-Anwendung. Claude Code und Omnigent können sich stattdessen mit einem persönlichen Zugriffstoken im Authorization-Header verbinden. Claude Code unterstützt weiterhin eine OAuth-Anwendung für gemeinsam verwaltete Einrichtungen.Für eigene Werkzeuge können Sie unter Developer Settings > Personal Access Tokens ein Token erstellen und es als Bearer-Token verwenden: direkt am /mcp-Endpunkt, mit --bearer-auth in der lokalen Stdio-Brücke oder in einem Client mit konfigurierbarem Authorization-Header.

​
Schritt 1: OAuth-Anwendung erstellen

1

Developer Settings öffnen

Melden Sie sich mit einem Administratorkonto an und öffnen Sie Settings > Developer Settings > OAuth Apps.
2

Anwendung erstellen

Klicken Sie auf Create OAuth App. Geben Sie einen Namen ein, beispielsweise MCP Integration, und fügen Sie die Redirect-URIs der gewünschten Clients hinzu.
3

Zugangsdaten sichern

Speichern Sie die Anwendung und kopieren Sie Client ID und Client Secret an einen sicheren Ort.

​
Redirect-URIs

Tragen Sie die URIs der Clients ein, die Sie verwenden möchten:
Die OAuth-Anwendung muss die vom Client tatsächlich angeforderten Scopes erlauben. Ein angeforderter Scope außerhalb der erlaubten Menge führt zu einem Autorisierungsfehler. Novaplan verwaltet die serverseitigen MCP_SCOPES-Standardwerte; wenn der Client eine freigegebene Teilmenge anfordert, muss die Anwendung nicht jeden bekannt gegebenen Scope erlauben.

​
Standard-Scopes anpassen

Novaplan AI gibt über /.well-known/oauth-protected-resource/mcp standardmäßig Scopes für die automatische Erkennung bekannt. Novaplan kann diese serverseitigen Standardwerte mit MCP_SCOPES prüfen und anpassen. Claude Code kann zusätzlich mit oauth.scopes eine freigegebene Teilmenge anfordern; allein die Bekanntgabe eines Scopes bedeutet nicht, dass die OAuth-Anwendung alle katalogisierten Scopes erlauben muss. Der zugängliche Quellcode und die Enterprise-Deployment-Vorlage verwenden den folgenden Standardkatalog. Das ist keine Empfehlung, jeder OAuth-Anwendung sämtliche Scopes zu gewähren. Prüfen Sie die vom Client angeforderten Scopes und die tatsächlich benötigten Werkzeuge:

​
Platzhalter in den Beispielen

Ersetzen Sie die Platzhalter in den Client-Konfigurationen: Der entfernte MCP-Endpunkt lautet NOVAPLAN_WORKSPACE_URL/mcp.

​
Client-Anleitungen

Wählen Sie die Anleitung für Ihren Client:

​
Funktionsweise

​
Architektur

​
OAuth Protected Resource Discovery

Novaplan AI stellt die OAuth-Erkennung unter folgender Adresse bereit:
Darüber erhält der Client die OAuth-Endpunkte:
  • Autorisierung: NOVAPLAN_WORKSPACE_URL/api/v1/oauth2/authorize
  • Token: NOVAPLAN_WORKSPACE_URL/api/v1/oauth2/token
  • Widerruf: NOVAPLAN_WORKSPACE_URL/api/v1/oauth2/revoke
  • JWKS: NOVAPLAN_WORKSPACE_URL/.well-known/jwks.json

​
Fehlerbehebung

Der Client versucht eine dynamische Registrierung statt der vorbereiteten OAuth-Zugangsdaten. Prüfen Sie --client-id und --client-secret für Claude Code beziehungsweise das auth-Objekt für Cursor.
Die Redirect URI der OAuth-Anwendung muss exakt zur vom Client verwendeten URI passen. Prüfen Sie außerdem, ob die OAuth-Anwendung in Novaplan AI aktiv ist. Beispiele für die einzelnen Clients stehen in der Tabelle oben.
Prüfen Sie die Erreichbarkeit mit curl -X POST NOVAPLAN_WORKSPACE_URL/mcp. Ohne Token sollte der Server mit 401 antworten; ein Verbindungsfehler weist auf ein anderes Problem hin.
Starten Sie npx @modelcontextprotocol/inspector und verbinden Sie den Inspector mit NOVAPLAN_WORKSPACE_URL/mcp und einem Bearer-Token.

​
Häufige Frage: Wie ändere ich Scopes?

  1. Prüfen Sie, welche Scopes der Client tatsächlich anfordert. Claude Code kann mit oauth.scopes eine Teilmenge festlegen. Stimmen Sie eine Änderung von MCP_SCOPES nur dann mit Novaplan ab, wenn die serverseitig bekannt gegebenen Standardwerte geändert werden sollen.
  2. Passen Sie die Scopes der OAuth-Anwendung unter Settings > Developer Settings > OAuth Apps an.
  3. Verbinden Sie den Client erneut, da bestehende Tokens die bisherigen Scopes enthalten. Cursor kann neu hinzugefügt, Claude Code über /mcp erneut angemeldet und Claude.ai unter Customize → Connectors neu verbunden werden. Für Gemini CLI finden Sie den aktuellen Wiederanmeldungsbefehl in der Client-Anleitung.