ComposioHQ/connect

Verbinden

Verbinde Codex mit jeder App mithilfe der Composio CLI. Höre auf, Text darüber zu generieren, was du tun könntest – tue es tatsächlich von der Shell aus.

Wann Diese Fähigkeit Verwenden

Verwende diese Fähigkeit, wenn Codex Folgendes tun soll:

• Diese E-Mail senden anstatt sie zu entwerfen
• Dieses Issue erstellen anstatt es zu beschreiben
• Diese Nachricht posten anstatt sie vorzuschlagen
• Diese Datenbank aktualisieren anstatt zu erklären wie

Was sich Ändert

Ohne Connect	Mit Connect
"Hier ist ein E-Mail-Entwurf..."	Sendet die E-Mail
"Du solltest ein Issue erstellen..."	Erstellt das Issue
"Poste das in Slack..."	Postet es
"Füge das zu Notion hinzu..."	Fügt es hinzu

Unterstützte Apps

Über 1000 Integrationen darunter:

• E-Mail: Gmail, Outlook, SendGrid
• Chat: Slack, Discord, Teams, Telegram
• Entwicklung: GitHub, GitLab, Jira, Linear
• Dokumente: Notion, Google Docs, Confluence
• Daten: Sheets, Airtable, PostgreSQL
• CRM: HubSpot, Salesforce, Pipedrive
• Speicher: Drive, Dropbox, S3
• Soziales: Twitter, LinkedIn, Reddit

Einrichtung

1. Installiere die Composio CLI

curl -fsSL https://composio.dev/install | bash

2. Anmelden

composio login
composio whoami

Dies öffnet einen Browser zur Authentifizierung und ermöglicht dir die Auswahl deiner Standard-Organisation und deines Projekts. Verwende -y, um Eingabeaufforderungen in automatisierten Abläufen zu überspringen.

3. Verknüpfe die benötigten Toolkits

composio link github
composio link gmail
composio link slack

Jeder Befehl führt einmalig durch OAuth, danach bleibt die Verbindung bestehen.

Fertig. Codex kann jetzt jede verbundene App von der Shell aus steuern.

Kern-Workflow

1. Kennst du den Tool-Slug? → composio execute
2. Kennst du den Slug nicht? → composio search
3. Brauchst du Klärung zu Eingaben? → composio execute --get-schema oder --dry-run
4. Toolkit nicht verbunden? → composio link <toolkit> und erneut versuchen
5. Mehrere Schritte nötig? → composio run für Workflows, composio proxy für rohe API-Aufrufe

Beispiele

Ein Tool entdecken

composio search "create a github issue"
composio search "send an email" --toolkits gmail

Eingaben vor dem Aufruf prüfen

composio tools info GITHUB_CREATE_ISSUE
composio execute GITHUB_CREATE_ISSUE --get-schema
composio execute GITHUB_CREATE_ISSUE --dry-run -d '{"owner":"acme","repo":"app","title":"Bug"}'

Eine E-Mail senden

composio execute GMAIL_SEND_EMAIL -d '{
  "recipient_email": "[email protected]",
  "subject": "Verschickt!",
  "body": "v2.0 ist live, sag Bescheid bei Problemen"
}'

Ein GitHub Issue erstellen

composio execute GITHUB_CREATE_ISSUE -d '{
  "owner": "my-org",
  "repo": "repo",
  "title": "Mobile Timeout-Fehler",
  "labels": ["bug"]
}'

In Slack posten

composio execute SLACK_SEND_MESSAGE -d '{
  "channel": "engineering",
  "text": "Deployment abgeschlossen - v2.4.0 live"
}'

Aufrufe parallel ausführen

composio execute --parallel \
  GMAIL_FETCH_EMAILS -d '{"max_results": 2}' \
  GITHUB_GET_THE_AUTHENTICATED_USER -d '{}'

Aktionen mit composio run verketten

composio run '
  const issues = await search("github issues labeled bug this week");
  const summary = issues.map(i => `- ${i.title}`).join("\n");
  await execute("SLACK_SEND_MESSAGE", {
    channel: "bugs",
    text: `Diese Woche Fehler:\n${summary}`
  });
'

Wiederverwendbare Workflows aus einer Datei laden:

composio run --file ./workflow.ts -- --repo composiohq/composio

Roher API-Zugriff (proxy)

Wenn kein dediziertes Tool existiert, rufe die authentifizierte API direkt auf:

composio proxy https://gmail.googleapis.com/gmail/v1/users/me/profile \
  --toolkit gmail

composio proxy https://gmail.googleapis.com/gmail/v1/users/me/drafts \
  --toolkit gmail -X POST -H 'content-type: application/json' \
  -d '{"message":{"raw":"..."}}'

Wie es Funktioniert

1. Du forderst Codex auf, etwas zu tun
2. Codex wählt einen Slug via composio search oder vorhandenem Wissen
3. CLI prüft die Verbindung, fordert composio link bei fehlender Verbindung
4. Aktion wird ausgeführt gegen die echte API und gibt JSON an die Standardausgabe zurück

Konfiguration

Globale Flags:

• --log-level <all|trace|debug|info|warning|error|fatal|none>
• --help für Befehlsdokumentation

Umgebungsvariablen:

• COMPOSIO_API_KEY - Authentifizierungsnachweis (für nicht-interaktive Nutzung setzen)
• COMPOSIO_BASE_URL - Benutzerdefinierter API-Endpunkt
• COMPOSIO_SESSION_DIR - Überschreibt den Speicherort für Artefakte
• COMPOSIO_DISABLE_TELEMETRY=true - Telemetrie deaktivieren

Typsicheres SDK (Optional)

Generiere typisierten Client-Code, wenn du Tools aus einer App und nicht von der Shell aus aufrufen möchtest:

composio generate ts    # TypeScript-Typen
composio generate py    # Python-Typen

Flags: -o <verzeichnis>, --toolkits <liste>, --compact, --transpiled, --type-tools.

Fehlerbehebung

• Nicht angemeldet → führe composio login aus
• Verbindung für <toolkit> erforderlich → führe composio link <toolkit> aus
• Unbekannter Slug → composio search "<was du willst>" oder composio tools list <toolkit>
• Falsche Eingaben → composio execute <SLUG> --get-schema dann --dry-run
• Aktion fehlgeschlagen → Berechtigungen in der Ziel-App prüfen

Vollständige Referenz: docs.composio.dev/docs/cli

---