Anleitung · Etwa 5 Minuten

So verbinden Sie Onplana mit Cursor

Fünf Schritte. Token erzeugen, mcpServers-Ausschnitt einfügen, Cursor neu laden, mit einem Werkzeugaufruf prüfen. Etwa 5 Minuten.

Danach können Sie den Agent von Cursor 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 Cursor erledigt die Arbeit direkt in Onplana, ohne dass Sie den Editor verlassen.

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

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 Cursor (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-Einstellungen von Cursor öffnen

    Öffnen Sie in Cursor die Einstellungen (Befehl+Umschalt+J unter macOS, Strg+Umschalt+J unter Windows oder Linux), gehen Sie zu Tools & MCP und wählen Sie New MCP Server. Cursor liest auch direkt eine JSON-Konfiguration: für das Projekt unter .cursor/mcp.json im Stammverzeichnis Ihres Repos oder global unter ~/.cursor/mcp.json. Die JSON-Datei zu bearbeiten führt zum selben Ergebnis wie die Oberfläche.

  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": {"url": "https://mcp.onplana.com/mcp", "headers": {"Authorization": "Bearer pat_paste-your-token-here"}}}}. Ersetzen Sie pat_paste-your-token-here durch das Token aus Schritt 1. Speichern Sie die Datei.

  4. 4

    Cursor neu laden

    Laden Sie das Cursor-Fenster neu (Befehl+Umschalt+P oder Strg+Umschalt+P, dann "Reload Window"), oder schalten Sie den Server onplana unter Einstellungen, dann Tools & MCP, aus und wieder ein. Die Onplana-Werkzeuge erscheinen in der Werkzeugliste des Agent mit einem grünen Statuspunkt, sobald der Handshake gelingt.

  5. 5

    Die Verbindung prüfen

    Fragen Sie im Agent-Chat von Cursor: „Liste meine Onplana-Projekte auf“. Cursor ruft das Onplana-Werkzeug list_projects auf und zeigt das Ergebnis. Bei einem Fehler prüfen Sie das Token erneut und ob die Konfigurationsdatei gültiges JSON ist.

.cursor/mcp.json (Projekt) oder ~/.cursor/mcp.json (global)

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

So prüfen Sie, ob es funktioniert

Öffnen Sie den Agent-Chat von Cursor 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.“

Cursor 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.

Ist die MCP-Unterstützung von Cursor stabil?

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

Projektkonfiguration oder globale Konfiguration?

Beides geht. .cursor/mcp.json im Stammverzeichnis eines Repos beschränkt die Verbindung auf dieses Projekt (praktisch, wenn verschiedene Repos über eigene Tokens zu verschiedenen Onplana-Organisationen gehören). ~/.cursor/mcp.json gilt für jedes Cursor-Fenster. Definieren beide einen Server "onplana", gewinnt die Projektkonfiguration.

Auf welche Werkzeuge hat Cursor 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 Cursor ü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.

Gibt es OAuth statt eines eingefügten Tokens?

Onplana veröffentlicht Discovery-Metadaten für OAuth 2.1 (RFC 9728 und RFC 8414) unter mcp.onplana.com/.well-known/. Ob Cursor sie automatisch nutzt, hängt von der MCP-Anmeldeunterstützung Ihrer Cursor-Version ab; der hier beschriebene Weg mit Token im Header funktioniert in jeder Version, die entfernte MCP-Server unterstützt.

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 Cursor 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