Anleitung · Etwa 5 Minuten

So verbinden Sie Onplana mit Claude Desktop

Fünf Schritte. Token erzeugen, Konfigurationsausschnitt einfügen, Claude Desktop neu starten, mit einem Werkzeugaufruf prüfen. Insgesamt etwa 5 Minuten.

Danach können Sie Claude 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 Claude erledigt die Arbeit direkt in Onplana.

Onplana öffnen → Einstellungen → Agenten Claude Desktop herunterladen

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 Claude Desktop (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 Konfiguration von Claude Desktop öffnen

    Klicken Sie in Claude Desktop auf Settings → Developer → Edit Config. Damit öffnet sich claude_desktop_config.json in Ihrem Standardeditor. Unter macOS liegt sie unter ~/Library/Application Support/Claude/claude_desktop_config.json, unter Windows unter %APPDATA%\Claude\claude_desktop_config.json. Ist die Datei leer oder fehlt sie, legen Sie sie mit `{}` an.

  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

    Claude Desktop neu starten

    Beenden Sie Claude Desktop vollständig (Befehl+Q unter macOS, ganz schließen unter Windows) und öffnen Sie es wieder. Das Onplana-Werkzeug sollte in der Werkzeugauswahl erscheinen.

  5. 5

    Die Verbindung prüfen

    Fragen Sie in einem neuen Gespräch: „Liste meine Onplana-Projekte auf“. Claude ruft das Onplana-Werkzeug list_projects auf und zeigt Ihnen das Ergebnis. Bei einem Fehler prüfen Sie das Token erneut und ob die Konfigurationsdatei gültiges JSON ist.

claude_desktop_config.json

{
  "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 ein neues Gespräch in Claude Desktop 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.“

Claude zeigt den Werkzeugaufruf vor der Ausführung direkt im Gespräch, 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.

Gibt es OAuth als Alternative zum Token?

Ja. Onplana ist im Connectors-Verzeichnis von Claude gelistet: Öffnen Sie in Claude Desktop (oder auf claude.ai) Settings, suchen Sie Connectors, durchsuchen Sie das Verzeichnis, wählen Sie Onplana und bestätigen Sie die Anmeldung im Browser, ohne etwas einzufügen. Darunter liegt OAuth 2.1 mit PKCE, und Onplana veröffentlicht Discovery-Metadaten nach RFC 9728 und RFC 8414 unter https://mcp.onplana.com/.well-known/oauth-protected-resource und oauth-authorization-server. Der hier beschriebene Weg mit eingefügtem Token ist für den Fall, dass Sie die Konfigurationsdatei wollen; OAuth ist für alle, die keine langlebigen Tokens verwalten möchten.

Auf welche Werkzeuge hat Claude Zugriff?

346 Werkzeuge: Lesen (z. B. list_projects, get_project, list_tasks, list_my_tasks, list_overdue, list_risks, search_org_knowledge, summarize_project, analyze_project_risks, generate_status_report), Schreiben (z. B. create_project, create_task, update_task, assign_task, create_milestone, create_comment, bulk_update_tasks, create_sprint_with_tasks, submit_timesheet, link_dependency, move_task_to_sprint) sowie Governance, Änderungssteuerung, Compliance, Dokumente und Workflows vollständig. Der Tarif schaltet einige Werkzeuge frei; den vollständigen Katalog finden Sie unter onplana.com/mcp.

Kann Claude ü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.

Kann ich statt Claude Desktop Claude Code (CLI) verwenden?

Ja. Claude Code bringt MCP-Unterstützung mit. Installation in einer Zeile: `claude mcp add onplana --transport http https://mcp.onplana.com/mcp`. Claude Code startet OAuth beim ersten Werkzeugaufruf (kein Token zum Einfügen), öffnet einen Browser zur Anmeldung bei Onplana und führt die Zustimmung durch; danach sieht jede weitere `claude`-Sitzung in diesem Projekt den Onplana-Werkzeugkatalog. Für ein Token statt OAuth hängen Sie `--header "Authorization: Bearer pat_…"` an den Befehl an. Prüfen Sie mit `claude mcp list`. Funktioniert unter macOS, Linux und WSL unter Windows.

Wo kann ich die Verbindung widerrufen?

In Onplana listet Einstellungen → Agenten → Verbindungen jede Verbindung auf, persönliche Zugriffstokens ebenso wie Anmeldungen über den Browser: Wählen Sie in der Zeile Widerrufen. Das wirkt sofort; der nächste Werkzeugaufruf von Claude liefert 401, und Claude bittet Sie, die Verbindung neu herzustellen.

Was passiert, wenn mein Token durchsickert?

Widerrufen Sie es sofort (siehe oben) und erzeugen Sie im selben Bereich ein neues. Das kompromittierte Token funktioniert ab seinem nächsten Aufruf nicht mehr. Ab dem Tarif Enterprise sieht ein Eigentümer oder Administrator der Organisation jeden Aufruf des durchgesickerten Tokens auf der Seite Audit Logs unter Agent Activity, so prüfen Sie, was ein Angreifer gesehen oder geändert haben könnte.

Funktioniert das unter Linux?

Claude Desktop gibt es derzeit nur für macOS und Windows. Unter Linux verwenden Sie einen anderen MCP-Client wie den offiziellen MCP Inspector (npx @modelcontextprotocol/inspector) oder Cursor (läuft unter Linux), oder Sie binden die Onplana-Verbindung mit dem typisierten TypeScript-Client-SDK von Onplana in ein lokales Agentenskript ein.

Weiterlesen