Anleitung · Etwa 3 Minuten

So verbinden Sie Onplana mit Gemini CLI und Code Assist

Installation in einer Zeile. Onplana liefert im Stammverzeichnis des Repos ein Manifest für eine Gemini-Erweiterung mit, die ganze Einrichtung ist also:gemini extensions install <repo>.

Danach können Sie Gemini etwa bitten: „Fasse meine überfälligen Onplana-Vorgänge zusammen“, „Erstelle einen Projektplan für den Start in Q3 mit 5 wöchentlichen Meilensteinen“ oder „Liste meine Teammitglieder im Projekt Datenplattform auf“, und Gemini führt es direkt in Onplana aus.

Onplana öffnen → Einstellungen → Agenten Gemini CLI auf GitHub

Kurz gesagt: drei Befehle

# 1. Set your Onplana token
export ONPLANA_PAT=pat_paste-your-token-here

# 2. Install the extension
gemini extensions install https://github.com/Onplana/onplana-mcp-server

# 3. Restart and verify
gemini
> list my Onplana projects via the onplana tool

Die Schritte im Einzelnen folgen unten.

Die fünf Schritte im Einzelnen

  1. 1

    Gemini CLI installieren (falls noch nicht geschehen)

    Unter macOS / Linux: npm install -g @google/gemini-cli. Unter Windows: derselbe Befehl in einer Shell mit Node. Prüfen Sie mit `gemini --version`. Wenn Sie Gemini Code Assist in VS Code oder JetBrains nutzen, haben Sie schon alles, was Sie brauchen: Code Assist teilt sich die Konfigurationsdatei mit der CLI.

  2. 2

    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 Gemini CLI + Code Assist, dann Persönliches Zugriffstoken und anschließend Token erzeugen und Verbindungsausschnitt anzeigen. Kopieren Sie das persönliche Zugriffstoken (es beginnt mit `pat_`). Setzen Sie es als Umgebungsvariable: export ONPLANA_PAT=pat_your-token-here (fügen Sie die Zeile in ~/.bashrc oder ~/.zshrc ein, damit sie bleibt).

  3. 3

    Die Gemini-Erweiterung von Onplana installieren (ein Befehl)

    Führen Sie aus: gemini extensions install https://github.com/Onplana/onplana-mcp-server. Das Onplana-Repo enthält im Stammverzeichnis ein Manifest gemini-extension.json, das Gemini CLI liest, um die Verbindung zum MCP-Server automatisch einzurichten. Alternativ bearbeiten Sie ~/.gemini/settings.json von Hand; das Format ist unter developers.google.com/gemini-code-assist/docs beschrieben.

  4. 4

    Gemini CLI neu starten oder den Editor neu laden

    Für Gemini CLI: beenden und `gemini` neu öffnen. Für Gemini Code Assist in VS Code: Cmd/Strg+Umschalt+P → "Developer: Reload Window". Für JetBrains: die IDE neu starten. Die Onplana-Werkzeuge erscheinen nach dem Neustart in der Auswahl /mcp.

  5. 5

    Die Verbindung prüfen

    Fragen Sie in einer neuen Gemini-Sitzung: „list my Onplana projects via the onplana tool“. Gemini ruft das Onplana-Werkzeug list_projects auf und zeigt Ihnen das Ergebnis. Bei einem Fehler prüfen Sie, ob ONPLANA_PAT in der Umgebung gesetzt ist, die Gemini nutzt, und ob das Manifest der Erweiterung richtig installiert ist, mit `gemini extensions list`.

Oder von Hand einrichten

Wenn Sie die Erweiterung nicht installieren möchten, bearbeiten Sie~/.gemini/settings.json(oder .gemini/settings.json im Stammverzeichnis des Arbeitsbereichs) direkt:

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

Beachten Sie: Der Schlüssel heißt httpUrl, nicht url. Gemini CLI verwendet httpUrl für Server mit Streamable HTTP wie Onplana und reserviert url für Server mit SSE. Das Bearer-Token in headers.Authorization authentifiziert jede Anfrage.

So prüfen Sie, ob es funktioniert

Öffnen Sie eine neue Gemini-Sitzung und probieren Sie eines davon:

  • „Liste über das onplana-Werkzeug meine Projekte auf.“
  • „Zeig mir überfällige Onplana-Vorgänge, die mir zugewiesen sind.“
  • „Lege in Projekt X einen Onplana-Vorgang namens ‚Postgres nach Aurora migrieren‘ an.“
  • „Durchsuche meine Onplana-Seiten nach Notizen zur API-Migration.“

Führen Sie gemini extensions list aus, um zu bestätigen, dass die Onplana-Erweiterung installiert ist. Nach einer erfolgreichen Installation sollte die Auswahl /mcp die vollständige Liste der Onplana-Werkzeuge zeigen.

Häufige Fragen

Funktioniert das mit Gemini Code Assist in VS Code?

Ja. Gemini CLI und Gemini Code Assist teilen sich dieselbe Konfigurationsdatei (~/.gemini/settings.json für den ganzen Benutzer oder .gemini/settings.json in einem Arbeitsbereich). Eine Installation mit `gemini extensions install` deckt beide ab. Laden Sie danach das VS-Code-Fenster neu (Cmd/Strg+Umschalt+P → "Developer: Reload Window"), damit Code Assist die neue Konfiguration übernimmt.

Was ist mit der Gemini-App unter gemini.google.com?

gemini.google.com unterstützt mit Stand Mai 2026 noch keine eigenen MCP-Server. Google verweist für Verbindungen zu MCP-Servern von Drittanbietern auf Gemini CLI oder Gemini Code Assist. Wir verfolgen das; bekommt die App MCP-Unterstützung, wird die Installation ein Klick über eine Connectors-Oberfläche wie bei Claude.ai.

Was ist mit Gemini Enterprise / Vertex AI Agent Builder?

Gemini Enterprise ist eine andere Einrichtung als Gemini CLI: Ein Administrator fügt Onplana in der Google Cloud Console als Datenspeicher vom Typ Custom MCP Server hinzu, mit einer OAuth-Client-ID und einem Secret. Das ist im Early Access und wird vom Administrator verwaltet, nicht selbst eingerichtet: Onplana stellt Ihrer Organisation den Client auf Anfrage aus. Die Anleitung unter docs.onplana.com/ai-agents/connect-onplana-to-gemini-enterprise/ enthält die Einstellungen, die 20 Aktionen, die Sie zuerst einschalten, und den Link für die Anfrage.

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.

Was ist der Unterschied zwischen der Installation über gemini-extension.json und dem direkten Bearbeiten von settings.json?

Funktional gleich. Die Installation der Erweiterung ist ein Befehl und nutzt ein Manifest im Stammverzeichnis des Repos, sie ist also reproduzierbar. Das Bearbeiten von settings.json von Hand hilft, wenn Sie Onplana neben mehreren MCP-Servern (etwa einem für Onplana, einem für Linear, einem für eine interne API) im selben Objekt `mcpServers` führen wollen. Beides funktioniert, beide teilen dieselbe Konfiguration.

Warum heißt der Schlüssel httpUrl und nicht url?

Gemini CLI unterscheidet MCP-Server über stdio (Schlüssel: command), über SSE (Schlüssel: url) und über Streamable HTTP (Schlüssel: httpUrl). Der MCP-Server von Onplana nutzt Streamable HTTP, den neueren Transportstandard, der Anfrage und Antwort über einfaches HTTPS ohne SSE abwickelt. Der Schlüssel `url` in den Konfigurationen von Claude Desktop, Cursor und ChatGPT entspricht ihm.

Kann ich die Verbindung widerrufen?

Ja, auf zwei Wegen: (1) Onplana → Einstellungen → Agenten → Verbindungen → Widerrufen in der Zeile des Tokens. (2) ONPLANA_PAT in Ihrer Umgebung entfernen UND `gemini extensions uninstall onplana` ausführen. Beides wirkt sofort; der nächste Werkzeugaufruf von Gemini liefert 401.

Auf welche Werkzeuge hat Gemini Zugriff?

346 Werkzeuge, dieselben wie für Claude Desktop, Cursor und ChatGPT: Lesen (list_projects, list_my_tasks, get_task, search_org_knowledge usw.) und Schreiben (create_task, update_task, assign_task, create_milestone usw.) sowie Governance, Änderungssteuerung, Compliance, Dokumente und Workflows. Der Werkzeugkatalog ist derselbe, egal welcher Client verbunden ist. Der Tarif schaltet einige Werkzeuge frei; den vollständigen Katalog finden Sie unter onplana.com/mcp.

Weiterlesen