Apollo MCP Server

Der Apollo MCP Server macht aus einer GraphQL-API ein Werkzeugset für KI-Assistenten. GraphQL ist eine Abfragesprache für Programmierschnittstellen: Der Client beschreibt genau, welche Felder er braucht, und bekommt nur diese zurück. Der Server von Apollo GraphQL sitzt vor einer solchen API und stellt die Abfragen, die Sie ausdrücklich freigeben, als MCP-Werkzeuge bereit. MCP ist die standardisierte Schnittstelle, über die Assistenten wie Claude Code oder Cursor externe Dienste nutzen. Laut Repository steht das Projekt unter der MIT-Lizenz, hat rund 317 Sterne, ist nicht archiviert und wurde zuletzt am 23. Oktober 2026 aktualisiert. Es stammt vom Hersteller selbst, also vom Unternehmen hinter dem Apollo Router und der Plattform GraphOS.

Was kann der Apollo MCP Server?

Der Kern ist die Umwandlung von Operationen in Werkzeuge. Jede benannte GraphQL-Abfrage oder Mutation aus Ihrem Katalog wird laut Dokumentation zu einem eigenen Werkzeug, dessen Beschreibung aus Ihrer Konfiguration, der Operationsbeschreibung, einem Kommentar oder dem Schema stammt. Die Operationen können Sie als lokale .graphql-Dateien ablegen, die sich im laufenden Betrieb neu laden, als Operations-Sammlung aus GraphOS, als Manifest mit gespeicherten Abfragen oder über die persistierten Abfragen von GraphOS beziehen. Optional schalten Sie Werkzeuge zur Schema-Erkundung ein: introspect schlägt einen Typ nach, search sucht in den Typinformationen, validate prüft eine Abfrage, ohne sie auszuführen, und execute führt eine frei formulierte Operation aus. Ein weiteres Werkzeug, explorer, liefert einen Link, der die Operation im Apollo Explorer öffnet.

Installation und Betrieb

Der Einstieg läuft laut Quickstart über die Apollo-Kommandozeile Rover ab Version 0.37, die mit einem GraphOS-Konto angemeldet sein muss, sowie Node.js ab Version 18 für mcp-remote. Mit rover init --mcp legen Sie ein Projekt an, mit rover dev starten Sie GraphQL-Endpunkt und MCP-Server lokal; der MCP-Endpunkt ist dann unter http://127.0.0.1:8000/mcp erreichbar. Ein Docker-Image lässt sich für den Betrieb in der eigenen Cloud bauen. Alternativ installiert das Repository den Server über cargo install --locked apollo-mcp-server. Als Transporte nennt die Dokumentation stdio für die lokale Entwicklung und Streamable HTTP für einen erreichbaren Endpunkt. In Claude Code binden Sie den lokalen Endpunkt mit claude mcp add apollo-mcp npx mcp-remote http://127.0.0.1:8000/mcp ein.

Anmeldung und Zugriffsschutz

Die Authentifizierung funktioniert laut Dokumentation nur mit Streamable HTTP. Der Server prüft signierte JWT-Zugriffstoken eines OAuth-2.1-fähigen Identitätsdienstes und erzwingt auf Wunsch Berechtigungsbereiche (Scopes), auch pro Werkzeug. Fehlende oder ungültige Tokens führen zu einer Antwort mit Status 401, fehlende Berechtigungen zu Status 403. Wichtig: Die aktuelle Umsetzung reicht OAuth-Tokens der Clients direkt an die dahinterliegende GraphQL-API weiter; die Dokumentation verweist dafür auf eigene Sicherheitshinweise. Eigene Header wie ein API-Schlüssel erreichen die API nur, wenn sie in forward_headers aufgeführt sind.

Wofür ist er besonders nützlich?

Der Server lohnt sich, wenn Sie bereits eine GraphQL-API betreiben und Assistenten gezielt einen Ausschnitt davon geben wollen. Statt einem Modell die ganze API und ihr Schema zu überlassen, definieren Sie wenige, geprüfte Operationen mit sprechenden Namen. Das hält den Kontext klein und begrenzt, was der Assistent tun kann. Gegenüber einem allgemeinen HTTP-Werkzeug oder einem selbstgeschriebenen Wrapper bekommen Sie fertige Bausteine für Hot-Reload, Autorisierung und Schema-Suche. Wer keine GraphQL-API hat, hat hier keinen Nutzen.

Sicherheit und Datenfluss

Die Operationen werden laut Dokumentation vor dem Bereitstellen nicht gegen das Schema geprüft; erst der dahinterliegende Endpunkt validiert sie bei der Ausführung. Prüfen Sie deshalb jede Operation vor dem Einsatz. Mutationen sind standardmäßig als zerstörerisch markiert, Abfragen als nur lesend. Werkzeuge wie execute erlauben freie Operationen; die Einstellung mutation_mode steuert dafür das Verhalten. Was die Operationen zurückgeben, gelangt in den Kontext des KI-Clients und damit zum Modellanbieter.

Kosten

Der Server selbst ist quelloffen unter MIT. Apollo bietet für GraphOS einen kostenlosen Plan sowie weitere kostenpflichtige Pläne und Enterprise-Tarife an; ob der MCP-Server an einen bestimmten Plan gebunden ist, geht aus der Preisseite nicht eindeutig hervor. Details finden Sie auf der offiziellen Preisseite von Apollo.

Für wen lohnt sich der Apollo MCP Server?

Er lohnt sich für Entwicklerinnen und Teams, die eine GraphQL-API mit Apollo betreiben und Assistenten kontrolliert anbinden möchten. Beginnen Sie mit zwei, drei lesenden Abfragen in einer Testumgebung, schalten Sie die Schema-Werkzeuge nur bei Bedarf ein und aktivieren Sie die Authentifizierung, bevor der Endpunkt für andere erreichbar ist.

Eine GraphQL-API, die Rover-Kommandozeile ab Version 0.37 mit GraphOS-Anmeldung (oder Rust für cargo install bzw. Docker), Node.js ab Version 18 für mcp-remote sowie ein MCP-Client.

Mit dem Apollo MCP Server geben Sie einem KI-Assistenten gezielt Zugriff auf ausgewählte Operationen Ihrer GraphQL-API. Dieser Ratgeber führt vom lokalen Start bis zur ersten Abfrage.

Schritt 1: Voraussetzungen

Sie brauchen eine GraphQL-API, die Apollo-Kommandozeile Rover ab Version 0.37 (angemeldet mit einem GraphOS-Konto), Node.js ab Version 18 und einen MCP-Client wie Claude Code oder Cursor.

Schritt 2: Projekt anlegen und starten

Mit rover init --mcp legen Sie ein Projekt an. Danach starten Sie GraphQL-Endpunkt und MCP-Server mit rover dev --supergraph-config supergraph.yaml --mcp .apollo/mcp.local.yaml. Der MCP-Endpunkt läuft dann unter http://127.0.0.1:8000/mcp. Prüfen können Sie ihn mit dem MCP Inspector über npx @modelcontextprotocol/inspector http://127.0.0.1:8000/mcp --transport http.

npx @modelcontextprotocol/inspector http://127.0.0.1:8000/mcp --transport http

Schritt 3: Operationen als Werkzeuge freigeben

Legen Sie je Operation eine .graphql-Datei an und verweisen Sie in der Konfiguration auf die Datei oder den Ordner. Jede benannte Operation wird zu einem Werkzeug. Beginnen Sie mit lesenden Abfragen und prüfen Sie jede Operation selbst, denn der Server validiert sie nicht vorab gegen das Schema.

Schritt 4: In Claude Code einbinden

Der Befehl lautet claude mcp add apollo-mcp npx mcp-remote http://127.0.0.1:8000/mcp. Prüfen Sie danach mit /mcp, ob die Werkzeuge erscheinen.

claude mcp add apollo-mcp npx mcp-remote http://127.0.0.1:8000/mcp

Absichern

Schalten Sie die Schema-Werkzeuge wie execute nur bei Bedarf ein. Bevor der Endpunkt für andere erreichbar wird, aktivieren Sie bei Streamable HTTP die OAuth-Authentifizierung und legen Scopes pro Werkzeug fest.

Lokal ohne Anmeldung; bei Streamable HTTP optional OAuth 2.1 mit signierten JWT-Tokens und Scopes, für GraphOS-Quellen die Variablen APOLLO_KEY und APOLLO_GRAPH_REF.

Zugriff auf die freigegebenen GraphQL-Operationen mit den Rechten, die die dahinterliegende API dem weitergereichten Token oder Header gewährt; mit den Schema-Werkzeugen und execute auch auf freie Abfragen.

Ergebnisse der Operationen gelangen in den Kontext des KI-Clients und damit zum Modellanbieter. Der Server läuft in Ihrer Umgebung; OAuth-Tokens der Clients werden an die GraphQL-API weitergereicht.

Zu weit freigegebene Mutationen oder das Werkzeug execute, nicht vorab gegen das Schema geprüfte Operationen, Weitergabe von Tokens an die API, ein ohne Authentifizierung erreichbarer HTTP-Endpunkt und Prompt Injection über zurückgegebene Daten.