Anleitung · Etwa 5 Minuten

So verbinden Sie Onplana mit Windsurf

Fünf Schritte. Token erzeugen, mcpServers-Ausschnitt einfügen (Windsurf verwendet serverUrl), Cascade aktualisieren, mit einem Werkzeugaufruf prüfen. Etwa 5 Minuten.

Danach können Sie Cascade etwa bitten: „Erstelle einen Projektplan für den Start in Q3 mit wöchentlichen Meilensteinen“ oder „Fasse die Risiken dieser Woche über alle aktiven Projekte zusammen“, und Windsurf erledigt die Arbeit direkt in Onplana, ohne dass Sie den Editor verlassen.

Onplana öffnen → Einstellungen → Agenten MCP-Dokumentation von Windsurf

Die fünf Schritte

  1. 1

    Ein Onplana-Verbindungstoken erzeugen

    Melden Sie sich bei Onplana unter app.onplana.com an. Öffnen Sie Einstellungen → Agenten → Agent verbinden, wählen Sie die Kachel Windsurf (oder Custom MCP client), dann Persönliches Zugriffstoken und anschließend Token erzeugen und Verbindungsausschnitt anzeigen. Kopieren Sie das persönliche Zugriffstoken (es beginnt mit pat_). Das Token hat nur den Scope MCP_AGENT: Es kann MCP-Werkzeuge aufrufen, aber keine weiteren Tokens erstellen, keine Abrechnung ändern und nichts außerhalb der MCP-Oberfläche anfassen.

  2. 2

    Die MCP-Konfiguration von Windsurf Cascade öffnen

    Öffnen Sie in Windsurf den Bereich Plugins (MCP) und wählen Sie "View raw config". Damit öffnet sich mcp_config.json. Unter macOS und Linux liegt sie unter ~/.codeium/windsurf/mcp_config.json, unter Windows im Ordner .codeium\windsurf Ihres Benutzerprofils. Ist die Datei leer, beginnen Sie sie mit {}.

  3. 3

    Die Konfiguration des Onplana-MCP-Servers einfügen

    Fügen Sie unter dem Schlüssel "mcpServers" einen Eintrag "onplana" hinzu. Die vollständige Konfiguration: {"mcpServers": {"onplana": {"serverUrl": "https://mcp.onplana.com/mcp", "headers": {"Authorization": "Bearer pat_paste-your-token-here"}}}}. Windsurf verwendet für entfernte HTTP-Server den Schlüssel "serverUrl" (nicht "url"). Ersetzen Sie pat_paste-your-token-here durch das Token aus Schritt 1 und speichern Sie.

  4. 4

    Cascade aktualisieren

    Klicken Sie im Bereich Plugins (MCP) auf "Refresh" (den runden Pfeil), damit Cascade die Konfiguration neu liest und den MCP-Handshake ausführt. Der Server onplana sollte einen grünen Status und eine Zahl verfügbarer Werkzeuge zeigen. Cascade hält höchstens 100 MCP-Werkzeuge aktiv, und Onplana stellt 346 bereit; fehlen also Onplana-Werkzeuge, schalten Sie andere Server oder Werkzeuge ab, die Sie nicht brauchen.

  5. 5

    Die Verbindung prüfen

    Fragen Sie in Cascade: „Liste meine Onplana-Projekte auf“. Windsurf ruft das Onplana-Werkzeug list_projects auf und zeigt das Ergebnis. Bei einem Fehler prüfen Sie das Token erneut, ob der Schlüssel "serverUrl" (nicht "url") lautet und ob das JSON gültig ist.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "onplana": {
      "serverUrl": "https://mcp.onplana.com/mcp",
      "headers": {
        "Authorization": "Bearer pat_paste-your-token-here"
      }
    }
  }
}

So prüfen Sie, ob es funktioniert

Öffnen Sie Cascade und probieren Sie eines davon:

  • „Liste meine Onplana-Projekte auf.“
  • „Was ist in meinem Onplana-Konto überfällig?“
  • „Lege in Projekt X einen Onplana-Vorgang namens ‚Postgres nach Aurora migrieren‘ an.“
  • „Erstelle einen Statusbericht für Projekt Y.“

Cascade zeigt den Werkzeugaufruf, bevor er ausgeführt wird, so prüfen Sie, welche Daten gelesen oder geschrieben werden. Änderungen greifen in jedem Tarif; in Free haben einige Schreibaktionen eine monatliche Obergrenze (keine ab dem Tarif Professional), und der Agent kann über die Option dryRun eine Vorschau anfordern, die nichts festschreibt.

Häufige Fragen

Welcher Onplana-Tarif enthält MCP?

MCP ist in jedem Tarif, auch im kostenlosen enthalten. Die Zahl gleichzeitiger Agentenverbindungen wächst mit dem Tarif (Free 2, Professional 3, Business 5, Enterprise 10, Enterprise+ unbegrenzt), und Ihr KI-Token-Guthaben (ein monatliches Kontingent in den kostenpflichtigen Tarifen, ein einmaliger Bonus in Free, dazu gekauftes Guthaben) begrenzt die tatsächliche KI-Nutzung. Den Tarif wechseln Sie jederzeit unter app.onplana.com/billing.

Warum verwendet Windsurf "serverUrl" statt "url"?

So sieht das Konfigurationsschema von Windsurf für entfernte MCP-Server über HTTP aus. Claude Desktop und Cursor verwenden "url"; Windsurf Cascade verwendet "serverUrl". Der Rest des Eintrags (der Servername onplana und der Header Authorization) ist gleich. Versehentlich "url" zu verwenden ist der häufigste Grund, warum eine Windsurf-Verbindung stillschweigend nicht erscheint.

Ist die MCP-Unterstützung von Windsurf stabil?

Ja, MCP ist in Windsurf eine fertige Funktion und keine Vorschau mehr. Die Onplana-Verbindung wird dem Anbieter WINDSURF zugeordnet und bekommt die volle Werkzeugpalette zum Lesen, Anlegen und Ändern. Die Einstellungen von Windsurf können sich zwischen Versionen trotzdem verschieben; dann sehen Sie unter docs.windsurf.com nach und behalten denselben Eintrag für den Server onplana.

Auf welche Werkzeuge hat Windsurf Zugriff?

Denselben Katalog mit 346 Werkzeugen, den jeder MCP-Client sieht: Lesen (list_projects, get_project, list_tasks, list_my_tasks, list_overdue, list_risks, search_org_knowledge, summarize_project, generate_status_report), Schreiben (create_project, create_task, update_task, assign_task, create_milestone, create_comment, bulk_update_tasks, create_sprint_with_tasks, link_dependency) sowie Governance, Änderungssteuerung, Compliance, Dokumente und Workflows. Der Tarif schaltet einige Werkzeuge frei; den vollständigen Katalog finden Sie unter onplana.com/mcp.

Kann Windsurf über MCP Projekte oder Vorgänge löschen?

Ja, wiederherstellbar, sofern ein Administrator es nicht abgeschaltet hat. Die löschenden Werkzeuge über MCP sind: einen Vorgang, ein Projekt, eine Liste oder ein Dokument löschen. Jedes ist ein Schalter pro Arbeitsbereich, der eingeschaltet ist, bis ein Administrator eine Wahl speichert, und der Aufrufer braucht weiterhin die Berechtigung, die er ohnehin bräuchte. Alle löschen weich in den Papierkorb, und ein gelöschter Vorgang oder ein gelöschtes Projekt wird mit seinem ganzen Teilbaum erfasst und unter den ursprünglichen IDs wiederhergestellt, sodass Abhängigkeiten und Hierarchie erhalten bleiben. Für Sprints, Meilensteine, Epics und Ziele gibt es über MCP überhaupt kein Löschwerkzeug.

Wo widerrufe ich die Verbindung?

In Onplana unter Einstellungen, dann Agenten, dann Verbindungen, und dort Widerrufen in der Zeile des Tokens. Das wirkt sofort; der nächste Werkzeugaufruf von Windsurf liefert 401. Ab dem Tarif Enterprise sieht ein Eigentümer oder Administrator der Organisation jeden Aufruf des Tokens auf der Seite Audit Logs unter Agent Activity.

Weiterlesen