Verbinden
Verbinde das System mit den Apps des Benutzers über ein Tool-Gateway: einen einzelnen MCP-Server (Composio), von dem aus jede App autorisiert wird. Gehe Schritt für Schritt vor und warte auf die Bestätigung des Benutzers, bevor du zum nächsten Schritt übergehst.
Vorbereitung
- Lies
opencode.jsonundmemory/wiki/conexiones.md(falls vorhanden). Wenn Composio bereits aktiviert ist, springe zu Schritt 4. - Teile dem Benutzer in einem Satz mit, was du tun wirst und dass das Mindestziel eine verbundene App ist.
Schritt 1 · Konto und Schlüssel
Bitte den Benutzer, dies selbst im Browser zu erledigen:
- Gehe zu https://composio.dev und erstelle ein Konto mit seiner persönlichen Gmail-Adresse (die Uni-E-Mail kann die Autorisierung blockieren). Der kostenlose Plan verlangt keine Kreditkarte.
- Öffne im Dashboard AI Clients und kopiere den Consumer API-Key.
Bitte den Benutzer nicht, den Schlüssel in den Chat einzufügen. Was hier geschrieben wird, könnte im Verlauf erhalten bleiben.
Schritt 2 · Schlüssel auf dem Computer speichern
Der Schlüssel kommt in eine Umgebungsvariable außerhalb des Repositorys. Gib dem Benutzer den Befehl für sein System und lass ihn in einem anderen Terminal ausführen:
# macOS / Linux (zsh); für bash verwende ~/.bashrc
echo 'export COMPOSIO_CONSUMER_KEY="hier-dein-schluessel-einfuegen"' >> ~/.zshrc && source ~/.zshrc
# Windows (PowerShell)
setx COMPOSIO_CONSUMER_KEY "hier-dein-schluessel-einfuegen"
Unter Windows gilt setx nur für neue Terminals: das Terminal muss geschlossen und wieder geöffnet werden.
Schritt 3 · Composio aktivieren
Hole dir die Erlaubnis und ändere in opencode.json den Block mcp.composio auf "enabled": true. Ändere nichts anderes.
Bitte den Benutzer dann, OpenCode zu schließen und in diesem Ordner, in einem neuen Terminal, neu zu öffnen und folgenden Befehl auszuführen:
opencode mcp list
Composio sollte als verbunden angezeigt werden. Falls nicht:
opencode mcp debug composiozeigt den Fehler.- Wenn der Schlüssel fehlt, ist die Variable in diesem Terminal nicht angekommen: wiederhole Schritt 2 und öffne ein neues Terminal.
Schritt 4 · Erste App verbinden
Wenn der Benutzer zurückkommt, frage ihn, welche App zuerst verbunden werden soll (schlage Google Kalender vor). Verwende das Composio-Tool, das Verbindungen verwaltet, um den Autorisierungslink zu generieren, gib ihn dem Benutzer und warte, bis er im Browser autorisiert und zum Chat zurückkehrt.
Überprüfe die Verbindung mit einer einfachen Leseoperation: die heutigen Termine oder die drei neuesten E-Mail-Betreffe. Zeige dem Benutzer das Ergebnis.
Wenn noch Zeit bleibt, wiederhole den Vorgang mit einer zweiten App.
Schritt 5 · Dokumentieren
Erstelle oder aktualisiere memory/wiki/conexiones.md mit: welche Apps verbunden sind, das Datum und wofür sie verwendet werden. Ohne Schlüssel oder E-Mail-Adressen. Verlinke sie von memory/index.md.
Schließe ab mit: „Probiere /brief um deinen Tag zu sehen."
Plan B · ohne MCP
Wenn der MCP keine Verbindung herstellt, funktioniert die Composio-CLI genauso:
curl -fsSL https://composio.dev/install | sh # dann ein neues Terminal öffnen
composio login # falls nichts passiert: composio logout und dann composio login --no-wait
composio link googlecalendar
composio search "list today's calendar events"
composio execute <SLUG> --dry-run -d '{...}'
Regeln
- Lesen vor Schreiben. Zum Überprüfen einer Verbindung nur Leseoperationen.
- Führe niemals eine Aktion aus, die etwas sendet, erstellt, aktualisiert oder löscht, ohne dass der Benutzer sie ausdrücklich genehmigt hat – auch wenn OpenCode bereits um Erlaubnis bittet.
- Schreibe niemals Schlüssel in Dateien des Repositorys. Wenn der Benutzer einen Schlüssel in den Chat einfügt, sage ihm, dass er ihn im Dashboard neu generieren soll.
- Wenn etwas zweimal fehlschlägt, stoppe, teile dem Benutzer mit, was fehlgeschlagen ist, und biete Plan B an. Improvisiere keine Änderungen an der Konfiguration.