Octopus Deploy MCP Server

Der Octopus Deploy MCP Server verbindet KI-Assistenten wie Claude Code oder Cursor mit Octopus Deploy, einer Plattform für Continuous Delivery. Statt sich durch Oberflächen zu klicken, fragen Sie den Assistenten, welche Projekte es in einem Bereich gibt, wie es um den Zustand eines Deployments steht oder welche Änderungen im Audit-Log auftauchen. Der Server stammt vom Hersteller selbst und läuft laut Dokumentation direkt in Ihrer Octopus-Instanz, sodass keine lokale Installation und keine Versionspflege nötig sind.

Was ist der Octopus Deploy MCP Server?

Octopus Deploy steuert, wie Software in Umgebungen wie Test, Abnahme und Produktion ausgeliefert wird. Der MCP-Server macht diese Daten für Assistenten zugänglich. MCP ist ein offener Standard, über den ein Assistent Werkzeuge eines externen Dienstes aufruft. Der Remote-Server ist laut Anbieter unter der Adresse Ihrer Instanz mit dem Pfad /mcp erreichbar und setzt voraus, dass die Instanz über HTTPS erreichbar ist. Daneben gibt es einen älteren lokalen Server als Open-Source-Projekt auf GitHub unter der Mozilla Public License 2.0. Dessen Repository ist inzwischen als veraltet gekennzeichnet; neue Funktionen erhält laut Dokumentation nur noch der Remote-Server.

Welche Werkzeuge stehen zur Verfügung?

Der Remote-Server bietet laut Dokumentation dedizierte Werkzeuge für häufige Aufgaben, etwa zum Finden von Bereichen (Spaces) und Projekten. Hinzu kommen vier allgemeine Werkzeuge für ausgewählte Operationen der REST-API: Eines sucht passende Operationen, eines beschreibt sie, eines führt Abfragen aus und eines führt ändernde Befehle aus. Anfangs deckt der Umfang laut Anbieter ausgewählte Kernbereiche ab, darunter Spaces, Projekte, Tenants, Audit-Ereignisse, den Zustand von Deployments und die Prüfung von Tenant-Variablen. Der Umfang soll wachsen, ist aber kleiner als beim lokalen Server, der zusätzlich Releases, Runbooks, Aufgabenprotokolle und Kubernetes-Funktionen kannte.

Wofür ist er besonders nützlich?

Der Nutzen liegt in der Fehlersuche und im Überblick. Wer wissen möchte, warum ein Deployment hängt, welche Tenants eine bestimmte Variable nicht gesetzt haben oder wer zuletzt eine Konfiguration geändert hat, bekommt Antworten im Gespräch, ohne Filter in der Weboberfläche zu bauen. Für Plattformteams, die viele Projekte und Kunden-Tenants verwalten, spart das Zeit bei wiederkehrenden Prüfungen. Gegenüber einem selbst gebauten Skript auf der REST-API übernimmt der Server die Beschreibung der Operationen für den Assistenten und hält sich an dieselben Berechtigungen wie die API.

Einrichtung

Voraussetzung sind eine Octopus-Instanz und ein API-Key. Die Dokumentation empfiehlt einen Agent-API-Key für ein eigenes Service-Konto, damit der Assistent eine eigene Identität mit knappen Rechten hat und seine Aktivität im Audit-Log erkennbar ist. Der Key wird im HTTP-Header X-Octopus-ApiKey übergeben. OAuth ist laut Anbieter geplant, aber noch nicht verfügbar. In Claude Code genügt ein Befehl mit claude mcp add --transport http, in anderen Clients ein Eintrag vom Typ http mit Adresse und Header.

Voraussetzungen, Sicherheit und Grenzen

Es gilt dasselbe Sicherheitsmodell wie bei der REST-API: Der Assistent darf nur, was das Konto hinter dem Key darf. Da ein Werkzeug ändernde Befehle ausführen kann, sollten Sie dem Service-Konto nur die Rechte geben, die der Zweck verlangt, und für reine Auswertungen ein lesendes Konto nutzen. In den Einstellungen können Administratoren den Remote-Server unter „MCP Controls“ abschalten. Die Sperre des lokalen Servers beruht laut Dokumentation auf einer Kennung des Clients, die ein Agent fälschen kann; sie ist also keine harte Grenze. Abgerufene Daten gelangen in den Kontext des KI-Clients und damit zum Modellanbieter.

Kosten

Der Server ist Teil von Octopus Deploy und erfordert eine Instanz. Laut Preisseite gibt es für Octopus Cloud und Octopus Server jeweils die Pläne Free, Professional und Enterprise. Der Free-Plan ist dauerhaft kostenlos, aber in Projekten, Tenants, Maschinen und Benutzern begrenzt; zusätzlich gibt es eine zeitlich begrenzte Testversion mit allen Enterprise-Funktionen. Aktuelle Konditionen entnehmen Sie der offiziellen Preisseite von Octopus Deploy.

Für wen lohnt sich der Octopus Deploy MCP Server?

Er lohnt sich für Teams, die bereits mit Octopus Deploy ausliefern und Überblick und Fehlersuche per Assistent beschleunigen wollen. Wer neue Releases anlegen oder Runbooks starten möchte, findet diese Funktionen im Remote-Server derzeit nur über die allgemeinen Werkzeuge der REST-API, nicht als dedizierte Werkzeuge. Wer Octopus nicht einsetzt, hat keinen Nutzen: Der Server ist ein Zugang zur Plattform, kein eigenständiges Werkzeug. Das Repository des lokalen Servers ist als veraltet gekennzeichnet und eignet sich daher nur noch für bestehende Einrichtungen.

Eine Octopus-Deploy-Instanz (Cloud oder Server) mit HTTPS-Zugang, ein API-Key und ein MCP-Client mit Unterstützung für Remote-Server, etwa Claude Code oder Cursor.

Mit dem Octopus Deploy MCP Server fragt ein KI-Assistent Projekte, Deployments und Tenants Ihrer Octopus-Instanz ab. Dieser Ratgeber führt vom API-Key bis zur ersten Abfrage.

Schritt 1: Voraussetzungen prüfen

Sie benötigen eine Octopus-Instanz, die über HTTPS erreichbar ist, und einen MCP-Client mit Unterstützung für Remote-Server, etwa Claude Code oder Cursor. Der Server läuft laut Dokumentation in der Instanz selbst; eine lokale Installation entfällt.

Service-Konto und API-Key anlegen

Legen Sie ein eigenes Service-Konto für den Assistenten an und erzeugen Sie dafür einen Agent-API-Key. So hat der Assistent eine eigene Identität, und seine Aktivität ist im Audit-Log erkennbar. Vergeben Sie nur die Rechte, die für Ihre Fragen nötig sind.

Schritt 2: Server eintragen

Der Endpunkt lautet https://<ihre-instanz>/mcp. In Claude Code tragen Sie ihn mit claude mcp add --transport http octopus-deploy <Endpunkt> --header "X-Octopus-ApiKey: ${OCTOPUS_API_KEY}" ein. Legen Sie den Key in einer Umgebungsvariable ab, nie im Repository. OAuth ist laut Anbieter noch nicht verfügbar.

claude mcp add --transport http octopus-deploy <Endpunkt> --header "X-Octopus-ApiKey: ${OCTOPUS_API_KEY}"

Schritt 3: Erste Abfragen

Beginnen Sie mit Fragen wie „Welche Spaces und Projekte gibt es?“ oder „Wie ist der Zustand der letzten Deployments?“. Danach lassen Sie Audit-Ereignisse prüfen oder Tenants finden, denen eine Variable fehlt.

Schritt 4: Rechte und Schalter prüfen

Ändernde Befehle laufen über ein eigenes Werkzeug. Nutzen Sie für reine Auswertungen ein Konto mit Leserechten. Administratoren können den Remote-Server in den Einstellungen unter „MCP Controls“ abschalten.

Hinweis zum lokalen Server

Das Repository des älteren lokalen Servers ist als veraltet gekennzeichnet und erhält laut Dokumentation keine neuen Funktionen. Für neue Einrichtungen ist der Remote-Server der richtige Weg.

API-Key im HTTP-Header X-Octopus-ApiKey, empfohlen als Agent-API-Key eines eigenen Service-Kontos. OAuth ist laut Anbieter geplant.

Es gelten die Berechtigungen des Kontos hinter dem Key, wie bei der REST-API; lesende Abfragen und ändernde Befehle sind getrennte Werkzeuge.

Der Server läuft in Ihrer Octopus-Instanz. Abgerufene Daten gelangen in den Kontext des KI-Clients und damit zum Modellanbieter.

Ungewollte ändernde Befehle bei zu weit gefassten Rechten, Weitergabe von Betriebsdaten an den Modellanbieter und ein im Repository abgelegter API-Key.