Shortcut über MCP mit Gemini verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Shortcut klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Shortcut + Gemini

Lass deine KI in Shortcut arbeiten: Stories mit den Suchoperatoren von Shortcut suchen, Stories mit Aufgaben, Kommentaren und Verlauf lesen, dazu Epics, Iterationen, Objectives, Teams, Workflows und Labels, und nach deiner Bestätigung Stories anlegen, ändern und kommentieren. Persönliches API-Token.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

SHORTCUT_API_TOKEN

Schritt 1 — Zugangsdaten holen

1. Klick in Shortcut auf deinen Avatar und öffne Settings → Your Account → API Tokens (https://app.shortcut.com/settings/account/api-tokens).
2. Gib einen Namen wie AnythingMCP ein und klick auf Generate Token. Shortcut zeigt das Token nur einmal an.
3. Füge es in SHORTCUT_API_TOKEN ein und installiere den Connector. Es wird als Header Shortcut-Token gesendet, und zwar nur an Shortcut.
4. Prüfe die Einrichtung mit shortcut_get_current_member: Es zeigt, wer du bist, deinen Mention-Namen und den Workspace.

Das Token handelt als du: in dem Workspace, in dem es erstellt wurde, mit deinen Rechten. Stories und Kommentare, die die KI schreibt, erscheinen unter deinem Namen. Wenn du in mehreren Shortcut-Workspaces arbeitest, leg pro Workspace ein Token an.

Schreiben nur nach deinem Ja: shortcut_create_story, shortcut_update_story und shortcut_add_story_comment ändern den Workspace sofort und benachrichtigen die Follower. Die KI zeigt dir vorher die Story, die Felder oder den Kommentartext und wartet auf ein klares Ja. shortcut_delete_story ist bei der Installation ausgeschaltet: Eine gelöschte Story lässt sich nicht wiederherstellen, und sie mit shortcut_update_story zu archivieren ist die sicherere Wahl.

Suchen wie in Shortcut: shortcut_search_stories und shortcut_search_epics verstehen die Suchoperatoren von Shortcut. Du fragst in normalen Worten, und die KI baut die Abfrage:

• owner:jane, requester:jane, team:"Mobile", epic:"Checkout redesign", iteration:"Sprint 12", label:"customer", state:"In Progress", type:bug, estimate:3.
• is:started, is:done, is:blocked, is:overdue, has:owner, has:deadline, has:comment.
• Datumsangaben: created:2026-10-01..2026-10-15, updated:today, completed:yesterday, due:*..2026-10-31.
• Ein Ausrufezeichen vor einem Operator schließt ihn aus, zum Beispiel owner:jane is:started !is:archived type:bug.

Was er liest: Stories mit Beschreibung, Aufgaben, Kommentaren, Links und ihrem vollständigen Änderungsverlauf (wer was wann verschoben hat), Epics mit ihren Kommentaren, Iterationen, Objectives, Teams, Workflows mit ihren Status, Labels, Projekte und Mitglieder. Um eine Story zu verschieben, setzt die KI ihren Workflow-Status, den sie vorher nachschlägt.

Seiten und Limits: Suchen liefern standardmäßig 25 Ergebnisse und bis zu 250 pro Seite. Nur die ersten 1000 Treffer lassen sich durchblättern, deshalb grenzt die KI die Abfrage lieber ein. 200 Anfragen pro Minute und Token.

Häufige Fehler: 401: Das Token ist falsch oder wurde gelöscht; erzeuge ein neues. 404: Die ID existiert in diesem Workspace nicht. 400 oder 422: Ein Wert wird nicht akzeptiert, zum Beispiel ein Workflow-Status aus einem anderen Workflow; Shortcut nennt ihn in der Meldung.

Nicht enthalten: Epics, Iterationen, Labels oder Kommentare löschen, Docs, Dateien und Anhänge, benutzerdefinierte Felder bearbeiten, Story-Vorlagen, Webhooks, Aufgaben und Story-Verknüpfungen.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Gemini hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Shortcut-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Was liegt gerade auf meinem Tisch? Liste meine begonnenen Stories, die noch nicht fertig sind, mit Epic und Iteration.“
• „Welche Bugs wurden in Sprint 12 erledigt, und welche sind noch offen?“
• „Zeig mir den Verlauf von Story 4521: Wer hat sie nach Ready for Review verschoben, und wann?“
• „Leg eine Bug-Story ‚Checkout schlägt bei abgelaufener Karte fehl‘ für das Team Payments an, Status Unstarted, Owner Jane. Zeig sie mir, bevor du sie anlegst.“
• „Kommentiere Story 4521, dass der Fix auf Staging ist, und verschieb sie nach Ready for Review. Frag mich vorher.“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden