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 Sign-in. Clients mit MCP-Autorisierung öffnen die Capgo Console, damit du den Zugriff bestätigen kannst. Clients ohne OAuth können stattdessen einen Capgo API Key senden.

Clients, die OAuth unterstützen, benötigen nur die URL. Sie erkennen den Capgo Login-Flow automatisch und öffnen beim ersten Server-Aufruf die Consent-Page.

  1. Öffne Einstellungen → Connectors und wähle Custom Connector hinzufügen.
  2. Name eingeben Capgo und einfügen https://api.capgo.app/mcp als URL.
  3. Klicken Verbinden und melde dich bei Capgo an, sobald die Bestätigungsseite erscheint.

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

Für n8n, Skripte, CI-Jobs oder andere Clients, die keinen OAuth-Flow ausführen können, sende einen Capgo API Key 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>"
}
}
}
}

Verwende einen Key mit den minimal erforderlichen Berechtigungen für den Assistant. 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 die Consent-Seite erneut durchlaufen, um sich wieder zu verbinden.

Der gehostete Server stellt etwa 50 Tools bereit:

BereichInhaltliche Übersicht
Accounts und OrganisationenWer bin ich, Organisationen, Mitglieder und Einladungen, Audit Logs, API Keys
AppsApps auflisten, erstellen, aktualisieren und löschen
BundlesBundles 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 BuildsBuild-Status, Build-Logs, Build abbrechen
WebhooksWebhooks erstellen, updaten, testen & löschen, Deliveries prüfen & wiederholen
Push-BenachrichtigungenBenachrichtigungseinstellungen, Provider, Kampagnen, Versand, 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.

Tools, die Daten löschen oder überschreiben, sind als destruktiv markiert, sodass MCP-Clients vor der Ausführung eine Bestätigung von dir verlangen.

  • „Liste meine Capgo Apps auf und zeige das Bundle für jeden Production-Channel.“
  • „Pausiere den Rollout auf dem Production-Channel von com.example.app.”
  • „Warum ist mein letzter iOS Native Build fehlgeschlagen? Zeig mir die Logs.“
  • „Welche Devices nutzen noch Bundle 1.4.2?“

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

Gehostetes MCPLokales 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, Channels, Organisationen, Statistiken
Bundle aus deinem Build-Ordner hochladenNeinJa
Native Build anfordernNein (nur Status, Logs und Abbruch)Ja
doctor, probe, Kompatibilitätsprüfungen für dein ProjektNeinJa

Nutze den gehosteten Server für tägliche Account-Aufgaben in jeder Chat-App. Nutze den lokalen CLI MCP-Server wenn der Assistent auf deine Projektdateien zugreifen muss.