MCP-Konnektor

Deployen, direkt aus Claude und ChatGPT

Verbinden Sie Agile Deploy mit Ihrem KI-Assistenten und sagen Sie zum Beispiel: „Warum ist das letzte Deployment von shop fehlgeschlagen?“, „Deploy den Branch feature/preise als Vorschau“ oder „Geh bei shop auf die Version von gestern zurück“. Sie melden sich ganz normal bei Agile Deploy an und entscheiden, was der Assistent darf.

Ihre Konnektor-Adresse

https://deploy.agiledeveloper.de/mcp

Diese URL tragen Sie überall ein. Die Anmeldung läuft über OAuth; kein Passwort und kein Schlüssel wird in den Assistenten kopiert.

Claude (claude.ai und Desktop)

Öffnen Sie Einstellungen › Konnektoren.
Wählen Sie Benutzerdefinierten Konnektor hinzufügen, Name „Agile Deploy“, URL: https://deploy.agiledeveloper.de/mcp
Klicken Sie auf Verbinden. Agile Deploy öffnet sich: anmelden, Rechte prüfen, Erlauben.
Im Chat den Konnektor über das Werkzeug-Menü einschalten und loslegen.

In Team- und Enterprise-Organisationen fügt meist die Verwaltung den Konnektor einmal für alle hinzu.

ChatGPT

Öffnen Sie Einstellungen › Apps und Konnektoren › Erweiterte Einstellungen und schalten Sie den Entwicklermodus ein.
Wählen Sie Konnektor erstellen, Name „Agile Deploy“, URL https://deploy.agiledeveloper.de/mcp, Authentifizierung OAuth.
Bei Agile Deploy anmelden und Erlauben. Danach steht Agile Deploy im Chat unter den Werkzeugen zur Auswahl.

Für die Suche in ChatGPT gibt es die Werkzeuge search und fetch. Ob und in welchem Umfang der Entwicklermodus in Ihrem Tarif verfügbar ist, legt OpenAI fest; die Menünamen können sich ändern.

Claude Code

Im Terminal:

claude mcp add --transport http agile-deploy https://deploy.agiledeveloper.de/mcp

In Claude Code /mcp eingeben.
agile-deploy wählen und Authentifizieren. Der Browser öffnet die Anmeldung von Agile Deploy.

Für Skripte ohne Browser geht auch ein API-Schlüssel aus Einstellungen › Entwickler als Header:

claude mcp add --transport http agile-deploy https://deploy.agiledeveloper.de/mcp --header "Authorization: Bearer agile_dp_…"

Was der Assistent kann

Mit dem Recht lesen sieht der Assistent Projekte, Deployments, Build-Logs, Domains und Nutzung. Mit schreiben darf er zusätzlich deployen, zurückrollen, Domains verwalten und Projekte anlegen.

projekte_auflistenAlle Projekte des Teams mit Adresse und Standlesen

projekt_anzeigenEinstellungen, Domains, Datenbanken, letzte Deploymentslesen

deployments_auflistenDeployments eines Projekts, nach Umgebung oder Branchlesen

deployment_anzeigenStatus, Adressen, Commit und Ende des Build-Logslesen

deployenNeues Deployment eines Branchs startenschreiben

erneut_deployenDenselben Commit neu bauenschreiben

produktion_setzenRollback: früheres Deployment sofort live schaltenschreiben

domains_auflistenEigene Domains mit Status und DNS-Einträgenlesen

domain_hinzufuegenEigene Domain hinzufügen (liefert TXT und A/AAAA bzw. CNAME)schreiben

domain_pruefenDNS einer Domain sofort prüfenlesen

domain_entfernenDomain vom Projekt entfernenschreiben

datenbanken_auflistenPostgreSQL und MongoDB des Projekts, ohne Zugangsdatenlesen

git_verbindungen_auflistenVerbundene Git-Konten (Agile Git, GitHub)lesen

repos_auflistenRepositories einer Git-Verbindunglesen

projekt_anlegenProjekt aus einem Repository anlegen und erstes Deployment startenschreiben

nutzung_anzeigenTarif, Kontingente, Kosten, Guthabenlesen

search, fetchSuche über Projekte und Deployments (Format für ChatGPT)lesen

Kosten und Sicherheit

Kosten: Builds und Hosting zählen wie in der App gegen die Kontingente Ihres Tarifs. Stand mit nutzung_anzeigen.
Keine Zahlungen: Tarif wechseln und Guthaben kaufen geht nur in der App.
Keine Geheimnisse: Umgebungsvariablen und Datenbank-Zugänge sieht der Assistent nicht.
Rollback und Produktion ändern, was Ihre Besucher sehen. Der Assistent tut das nur auf Ihren ausdrücklichen Wunsch.

Fehlerbehebung

Anmeldefenster öffnet sich nicht: Pop-up-Blocker prüfen oder die Verbindung im Assistenten neu starten.
„Diesem Zugang fehlt das Recht …“: Verbindung trennen und neu verbinden, dabei „schreiben“ erlauben.
Build läuft noch: Builds dauern meist ein bis drei Minuten. Den Assistenten nach dem Stand fragen (deployment_anzeigen).
Verbindung abgelaufen: Unbenutzte Verbindungen enden nach 60 Tagen. Einfach neu verbinden.

Trennen und widerrufen

Unter Einstellungen › Entwickler sehen Sie jede verbundene Anwendung mit ihren Rechten und trennen sie mit einem Klick. Der Zugriff endet sofort.

Für Entwickler: OAuth-Metadaten unter /.well-known/oauth-authorization-server, Ressource unter /.well-known/oauth-protected-resource, REST-API unter /docs.