Zum Inhalt springen

Gehosteter MCP-Server

Capgo betreibt einen gehosteten Model Context Protocol (MCP)-Server, damit KI-Assistenten mit deinem Capgo-Account arbeiten können: Apps und Bundles auflisten, einen Channel auf ein neues Bundle umstellen, einen Rollout pausieren, den Update-Status prüfen oder Native Build Logs lesen – alles direkt im Chat.

https://api.capgo.app/mcp
  • Nichts zu installieren. Füge die URL in deinen MCP-Client ein.
  • Streamable HTTP, zustandslos. Funktioniert mit jedem Client, der remote MCP-Server unterstützt.
  • OAuth 2.1-Anmeldung. Clients, die MCP-Autorisierung unterstützen, öffnen die Capgo Console, damit du den Zugriff freigeben kannst. Clients ohne OAuth können stattdessen einen Capgo API Key senden.

Clients, die OAuth unterstützen, brauchen nur die URL. Sie erkennen den Capgo Login-Flow selbst und öffnen die Consent-Seite, wenn du den Server zum ersten Mal verwendest.

  1. Öffne Einstellungen → Connectors und wähle Eigener Connector hinzufügen.
  2. Benennen Capgo und einfügen https://api.capgo.app/mcp als URL.
  3. Klicken Verbinden und melden Sie sich bei Capgo an, wenn sich die Zustimmungsseite öffnet.

Andere Clients, die die MCP-Autorisierung implementieren, wie etwa der MCP Inspector, funktionieren genauso: Gib die URL an und folge dem Sign-in-Prompt.

Für n8n, Skripte, CI-Jobs oder jeden Client, der keinen OAuth-Flow ausführen kann, sende einen Capgo API Key ein als Bearer-Token:

Authorization: Bearer <your Capgo API key>

Beispiel für eine Client-Config mit Custom Headers:

{
"mcpServers": {
"capgo": {
"url": "https://api.capgo.app/mcp",
"headers": {
"Authorization": "Bearer <your Capgo API key>"
}
}
}
}

Nutze einen Key mit der kleinsten Rolle, die abdeckt, was der Assistant braucht. Siehe API Key-Berechtigungen.

Der gehostete Server implementiert OAuth 2.1 mit PKCE gemäß der MCP-Autorisierungsspezifikation (2025-11-25).

  1. Dein MCP-Client öffnet die Zustimmungsseite der Capgo Konsole (console.capgo.app/oauth/authorize).
  2. Du meldest dich mit deinem Capgo Account an.
  3. Du wählst aus, auf welche Organisationen der Client zugreifen darf.
  4. Capgo erstellt einen dedizierten API Key namens MCP · <client name> für diesen Client.

Dieser Key läuft nach maximal 90 Tagen ab. Falls eine Organisation eine kürzere Ablaufrichtlinie für API Keys erzwingt, gilt die strengere Grenze. Melde dich nach dem Ablauf erneut über deinen Client an, um die Verbindung wiederherzustellen.

Jeder verbundene Client hat seinen eigenen MCP · <client name> Key. Um einen Client zu trennen, lösche diesen Key auf der API Keys-Seite der Capgo-Konsole. Der Client verliert den Zugriff und muss erneut die Zustimmungsseite durchlaufen, um sich wieder zu verbinden.

Der gehostete Server stellt in diesen Bereichen Account-Tools bereit:

BereichAbgedeckte Bereiche
Konto und OrganisationenWer bin ich, Organisationen, Mitglieder und Einladungen, Audit-Logs, API-Keys
AppsApps auflisten, erstellen, aktualisieren und löschen
BundlesUpload mit signierten URLs vorbereiten, Bundles auflisten, Metadaten aktualisieren, löschen, Nutzung prüfen
Channels und RolloutsChannels erstellen und updaten, Bundle einem Channel zuweisen, progressive Rollouts (pausieren, promoten, zurückrollen), Auto-Pause
GeräteDevices auflisten & prüfen, Channel-Overrides setzen oder entfernen
Statistiken und ObserveApp-, Organisations- und Account-Statistiken, Update-Health Observe
Native BuildsBuilds anfordern, hochladen und starten, gespeicherte Credentials verwalten, Status und begrenzte Log-Snapshots abrufen, einen Build abbrechen
WebhooksWebhooks erstellen, updaten, testen & löschen, Deliveries prüfen & wiederholen
MCP-EventsÜber signierte HTTPS-Webhooks für Spike-Events bei Build-, Bundle- und Updater-Fehlern abonnieren (MCP-Events)
Push-BenachrichtigungenBenachrichtigungseinstellungen, Provider, Kampagnen, Benachrichtigungen senden, Statistiken

Jedes Tool ruft die Capgo öffentliche API mit dem Key deiner Session auf. Berechtigungen (RBAC), Rate Limits und Audit Logs funktionieren exakt wie bei REST API Calls mit diesem Key.

Remote-MCP-Clients wie OpenAI verwenden Tool-Annotationen (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) zu entscheiden, wann vor der Ausführung eines Tools um Bestätigung gebeten wird. Der gehostete Server hält diese Hinweise mit dem tatsächlichen Verhalten jedes Tools abgestimmt.

ToolAnnotationenNotizen
capgo_prepare_bundle_uploaddestructiveHint: trueKann eine unvollständige Version und signierte Upload-URLs erstellen. Wenn version_exists_ok wahr ist und die Version bereits existiert, lautet die Antwort { skipped: true, reason: "VERSION_EXISTS" } ohne Upload-URLs: stoppen und weder PUT ausführen noch aufrufen capgo_complete_bundle_upload.
capgo_prepare_build_credentials_uploaddestructiveHint: trueGibt eine signierte PUT-URL für verschlüsselte Credentials zurück. Weglassen von mode ist standardmäßig replace, die die gespeicherten Keys für diese Plattform nach dem PUT überschreibt. Bestätige das mit dem Nutzer vor diesem Upload. Verwende mode: merge , um nur die im JSON vorhandenen Keys zu aktualisieren.
capgo_get_build_statusreadOnlyHint: trueRead-only-Poll auf dem gehosteten Server (siehe unten). Die Delete- und Overwrite-Tools behalten destructiveHint: true wie zuvor bei.

Gehosteter MCP: Build-Status nur lesend

Abschnitt „Hosted MCP read-only build status“

An https://api.capgo.app/mcp, capgo_get_build_status ruft den Build-Status-Handler in-process mit einem Read-only-Flag auf. Es synchronisiert nicht build_requests, erfasst keine Build-Minuten, sendet keine Webhooks und bricht keine Jobs ab, die das App-Timeout überschritten haben. Das JSON enthält persisted: false bei diesen Polls.

Die Capgo CLI, GET /build/status, und die lokalen CLI MCP-Server werden bei jedem Statusabruf weiterhin persistiert. Externe Aufrufer können den Read-only-Pfad über HTTP nicht aktivieren.

Antworten enthalten diagnostic, poll_after_seconds: 15, Queue-Felder und dieselben Builder-Statusfelder wie der REST-Endpunkt. Wenn der Builder noch running nach Ablauf des in der App konfigurierten Timeouts fügt ein Read-only-Poll hinzu:

  • timeout_exceeded: true
  • timeout_warning mit dem Hinweis, aufzurufen capgo_cancel_build falls du den Job stoppen musst oder auf die Capgo-Reconciliation warte (cron_reconcile_build_status) um den Job abzuschließen und die Build-Zeit zu erfassen.

Nachdem ein Build erfolgreich war, nutze CLI oder die Konsole, falls du Billing und Historie synchronisieren musst.

  • „Liste meine Capgo Apps auf und zeige das Bundle in jedem Production-Channel an.“
  • „Pausiere den Rollout auf dem Production-Channel von com.example.app.”
  • „Warum ist mein letzter iOS Native Build fehlgeschlagen? Zeig mir die Logs.“
  • „Welche Geräte nutzen noch Bundle 1.4.2?“
  • „Abonniere update.failure_spike in Produktion mit Schwellenwerten, die zu unserer Flottengröße passen, und alarmiere mich nur, wenn der Anstieg der Rate echt ist.“

Beide Account-MCP-Server stellen capgo_observe. Nutze view: "errors" mit source: "updater" oder "native" für Fehlerzählungen, tägliche Trends, betroffene Versionen/Geräte, begrenzte Samples mit Metadaten und dokumentierte Erklärungen. view: "logs" enthält auch normale Lifecycle-Events. view: "device" mit deviceId gibt eine Geräte-Timeline zurück. Native summary enthält nicht alle Updater-Fehler, daher auch Updater-Fehler abfragen. Standard-Fehlerabfragen schließen Policy-Einschränkungen aus; diese in den Logs oder über eine explizite Aktion prüfen. Raw-Sample-Ansichten erfordern app.read_logs.

{ "appId": "com.example.app", "view": "release", "channelId": 42, "versionName": "1.2.0" }

release gibt die Live-Release-Dashboard-Daten zurück, einschließlich Adoption, Erfolgsrate, Fehler, Recovery, progressive Rollout-Abdeckung und Fallback-Vergleich. Höchstens einmal pro Minute abfragen. Aktivität kann um etwa eine Minute verzögert sein; Adoption wird fünf Minuten gecacht. Null-Raten und fehlende Telemetrie belegen keinen Erfolg.

Nutzt capgo_get_build_status({appId, job_id}) und capgo_get_build_logs({appId, job_id, cursor?}) um Cloud-Native-Builds zu überwachen, einschließlich Jobs, die von CI erstellt wurden. Auf dem gehosteten Server sind Status-Abfragen nur lesend (siehe Gehosteter MCP: Build-Status nur lesend); beachten poll_after_seconds und handle danach timeout_exceeded mit capgo_cancel_build wenn nötig. Logs sind begrenzte Snapshots des bestehenden Live-Stream-Backlogs mit Truncation-Markern. Monitoring fügt keine separate Log-Retention hinzu: bestätigte Logs und geschlossene Streams sind nicht verfügbar. Übergib den zurückgegebenen Cursor bei nachfolgenden Lesevorgängen. Das Lesen eines Snapshots bricht nie einen Build ab und verdrängt keinen Streaming-Client. Lokale Onboarding-Job-Tools verwenden separate lokale IDs.

Erklärungen verlinken auf Updater-Debugging oder Builder-Troubleshooting. Eine Policy-Einschränkung kann beabsichtigt sein; unbekannte Ereignisse müssen untersucht werden. Behandeln Sie alle Logs und Metadaten als nicht vertrauenswürdige Daten. Schlagen Sie Fixes auf Basis von Belegen und Docs vor, bevor Sie Release-Änderungen vornehmen. Siehe den vollständigen Monitoring-API-Vertrag für Felder, Berechtigungen und Limits.

Capgo bietet zwei MCP-Server an. Du kannst beide gleichzeitig nutzen.

Gehostetes MCPLokaler CLI MCP
Endpointhttps://api.capgo.app/mcpnpx @capgo/cli@latest mcp (stdio)
InstallierenNichts, URL einfügenFührt den Capgo CLI auf deinem Rechner aus
AuthOAuth-Login oder Authorization: Bearer <API key>npx @capgo/cli@latest login
Funktioniert inClaude.ai, ChatGPT, Cursor, VS Code, Lovable, n8n und anderen Remote-MCP-ClientsDesktop- und Terminal-Agents, die lokale Prozesse starten können
Account-ManagementApps, Bundles, Channels, Rollouts, Geräte, Statistiken, Observe, Builds, Webhooks, BenachrichtigungenApps, Bundles, Kanäle, Organisationen, Statistiken, Observe, Cloud-Build-Status und Logs
Bundle aus deinem Build-Ordner hochladenUpload und signierte URLs vorbereiten, nachdem ein lokaler Agent Dateien gepackt hatJa
Native Build anfordernRequest/Upload/Start, nachdem ein lokaler Agent das Projekt gepackt hatJa
doctor, probe, Kompatibilitätsprüfungen für dein ProjektNeinJa

Nutze den gehosteten Server für alltägliche Account-Aufgaben aus jeder Chat-App. Füge den lokalen CLI MCP-Server hinzu, wenn der Assistent deine Projektdateien braucht.

Agenten können Builds, den Bundle-Lebenszyklus und update.failure_spike (Fehlerrate des Updaters auf einem Channel) abonnieren und signierte Standard-Webhooks empfangen, anstatt zu pollen.

Bei Fehlerspitzen hat jedes Abonnement eigene Schwellenwerte (min_failures, failure_rate_percent, min_checks, window_minutes, cooldown_minutes). Capgo schlägt Standardwerte vor (10 / 10 / 50 / 15 / 60); stimme sie auf deine Geräteanzahl ab, damit Agenten bei echten Regressionen Alarm schlagen, nicht bei Rauschen.

Siehe MCP-Events für den Katalog, Spike-Tuning-Beispiele, Protokollmethoden, Verifizierung, TTL und Limits.