Hygraph MCP Server

Der Hygraph MCP Server verbindet Ihren KI-Assistenten direkt mit einem Projekt im Headless CMS Hygraph. MCP, das Model Context Protocol, ist ein offener Standard, über den Assistenten wie Claude, Cursor oder VS Code mit Copilot externe Dienste ansprechen. Ein Headless CMS verwaltet Inhalte zentral und liefert sie über eine Schnittstelle an Websites und Apps aus. Hinter dem Server steht Hygraph selbst, das frühere GraphCMS, dessen Plattform von Beginn an auf GraphQL aufbaut. Der Server wird von Hygraph gehostet, Sie müssen also nichts selbst betreiben.

Wofür ist der Hygraph MCP Server nützlich?

Viele Aufgaben in einem CMS sind schnell beschrieben, aber mühsam geklickt. Ein Beispiel: alle Entwürfe mit einem bestimmten Tag finden und ihre Priorität ändern. Oder einem Content-Modell ein neues Feld geben und es anschließend in die Produktionsumgebung übernehmen. Mit dem MCP-Server formulieren Sie solche Aufträge in normaler Sprache, und der Assistent erledigt sie über die Schnittstelle des Projekts. Hygraph nennt laut Anbieter drei typische Gruppen. Entwickler lassen sich etwa TypeScript-Typen für alle Content-Modelle erzeugen oder Beiträge als Markdown exportieren. Content-Teams erledigen Massenaktualisierungen nach Kriterien. Plattform-Teams führen Migrationen und Aufräumarbeiten im Gespräch durch, statt dafür eigene Skripte zu schreiben.

Was der Server kann

Die Werkzeuge decken laut Dokumentation vier Bereiche ab. Im Bereich Content liest, filtert, erstellt, aktualisiert und veröffentlicht der Assistent Einträge und verschiebt Inhalte zwischen Umgebungen. Im Bereich Schema prüft und erstellt er Content-Modelle, ergänzt oder ändert Felder und verwaltet Enumerationen und Komponenten. Dazu kommen die KI-Agenten von Hygraph: Der Assistent kann konfigurierte Agenten auflisten, auf Einträge anwenden und ihren Status abfragen. Das funktioniert nur für Agenten mit der Option Use in Agent runs, und deren Ergebnisse landen als Entwurf. Die AI Guidelines eines Projekts, also Markenstimme, Glossar und Compliance-Vorgaben, kann der Assistent lesen, bevor er Texte schreibt, aber nicht verändern.

Bewusste Grenzen

Auffällig ist, was der Server nicht darf. Einträge und Schema-Elemente lassen sich über MCP grundsätzlich nicht löschen, auch das Zurückziehen veröffentlichter Inhalte ist ausgeschlossen. Hygraph begründet das mit dem Schutz vor unbeabsichtigtem Datenverlust in automatisierten Abläufen. Solche Schritte erledigen Sie weiterhin von Hand in Hygraph Studio. Was der Assistent über den Claude-Connector anlegt oder ändert, landet zunächst als Entwurf und wird erst nach Ihrer Freigabe veröffentlicht. Ein Werkzeug sollten Sie trotzdem im Blick behalten: execute_graphql kann laut Hygraph auch Massenänderungen ausführen, daher lohnt sich vor jeder Freigabe ein Blick auf die Zusammenfassung.

Zwei Wege der Anmeldung

Der Server bietet zwei Endpunkte. Der projektbezogene Endpunkt gilt für genau ein Projekt und eine Umgebung und wird mit einem Permanent Auth Token als Bearer-Header angesprochen. Über den Typ dieses Tokens legen Sie die Rechte fest: General darf Inhalte und Schema bearbeiten, Content nur Inhalte, Management nur das Schema, Read-only nur lesen. Für Staging und Produktion empfiehlt Hygraph getrennte Tokens. Der globale Endpunkt unter mcp.hygraph.com nutzt dagegen Ihr Hygraph-Konto und sieht alle Projekte, auf die Sie Zugriff haben. Ihn verwendet vor allem der offizielle Connector im Claude-Verzeichnis, der weder Node.js noch einen Token braucht.

Clients und Einrichtung

Hygraph dokumentiert Anleitungen für Claude Code, den Claude-Connector, Claude Desktop, Cursor, VS Code und Windsurf. Claude Code und VS Code sprechen den HTTP-Endpunkt direkt an. Cursor, Windsurf und Claude Desktop binden ihn über das Hilfsprogramm mcp-remote ein, dafür sind Node.js ab Version 20.18.1 und npx nötig. In Cursor gibt es zusätzlich eine Ein-Klick-Installation aus Hygraph Studio. Wichtig dort: Der Auto-Modus für die Modellwahl ist laut Hygraph nicht kompatibel, Sie müssen ein Modell fest auswählen. Codex wird in der Dokumentation nicht erwähnt.

Kosten, Status und Lizenz

Die Dokumentation nennt als Verfügbarkeit alle Hygraph-Projekte und keine eigene Gebühr. Hygraph selbst bietet laut Preisseite einen dauerhaft kostenlosen Hobby-Plan, dazu einen kostenpflichtigen Growth-Plan und Enterprise-Tarife über den Vertrieb. Im Ankündigungsbeitrag beschreibt Hygraph den Server als Early Access, Funktionen können sich also noch ändern. Eine einzelne FAQ-Antwort im selben Beitrag nennt allerdings den Enterprise-Plan als Voraussetzung. Prüfen Sie daher im eigenen Projekt unter Project Settings und Endpoints, ob der MCP-Endpunkt angeboten wird. Der Server ist nicht als Open Source veröffentlicht, ein öffentliches Repository gibt es nicht.

Für wen lohnt sich der Hygraph MCP Server?

Der Server lohnt sich für Teams, die bereits mit Hygraph arbeiten und Routinearbeit an Inhalten und Content-Modellen schneller erledigen wollen. Entwickler sparen sich den Wechsel zwischen Studio, API-Playground und Code, Redaktionen bekommen Massenänderungen ohne Skript. Im Vergleich zu den MCP-Servern anderer Headless CMS wie Contentful, Sanity, Strapi oder Storyblok sticht Hygraph durch die feine Rechtevergabe über Token-Typen und den kompletten Verzicht auf Löschrechte hervor. Wer dagegen regelmäßig Inhalte entfernen oder zurückziehen muss, erledigt das weiterhin im Studio.

Ein Hygraph-Projekt mit mindestens einer Umgebung und ein MCP-fähiger Client wie Claude Code, Claude, Cursor, VS Code oder Windsurf. Für den Projektendpunkt ein Permanent Auth Token, für Cursor, Windsurf und Claude Desktop zusätzlich Node.js ab 20.18.1 und npx.

Mit dem Hygraph MCP Server bearbeitet Ihr KI-Assistent Inhalte und Content-Modelle eines Hygraph-Projekts. Hygraph hostet den Server selbst. Dieser Ratgeber zeigt die Einrichtung in gängigen Clients und wie Sie die Rechte sinnvoll begrenzen.

Schritt 1: Endpunkt und Token vorbereiten

Für Claude Code, Cursor und VS Code brauchen Sie den Projektendpunkt. Sie finden ihn in Hygraph Studio unter Project Settings, Endpoints, MCP Server API. Er hat die Form https://mcp-{REGION}.hygraph.com/{PROJECT_ID}/{ENVIRONMENT}/mcp und gilt für genau eine Umgebung. Legen Sie dazu einen Permanent Auth Token an und wählen Sie den Typ passend zur Aufgabe: General für Inhalte und Schema, Content nur für Inhalte, Management nur für das Schema, Read-only nur zum Lesen. Speichern Sie den Token in einer Umgebungsvariablen, etwa HYGRAPH_TOKEN.

Claude Code

Führen Sie claude mcp add --transport http hygraph <Endpunkt> --header "Authorization: Bearer $HYGRAPH_TOKEN" aus. Claude Code spricht den HTTP-Endpunkt direkt an, mcp-remote ist nicht nötig. Mit --scope user oder --scope project legen Sie fest, wo der Eintrag gilt. Prüfen können Sie die Verbindung mit claude mcp get hygraph.

Claude

Im Claude-Verzeichnis gibt es einen offiziellen Connector. Öffnen Sie Settings und Connectors, suchen Sie Hygraph MCP und klicken Sie auf Connect. Danach melden Sie sich bei Hygraph an und bestätigen mit Accept. Dieser Weg nutzt den globalen Endpunkt und braucht weder Node.js noch einen Token. Auf Team- und Enterprise-Plänen von Claude muss ein Owner den Connector zuerst freigeben.

Cursor

Am einfachsten ist die Ein-Klick-Installation: In Hygraph Studio unter Endpoints und MCP Server API auf Add to Cursor klicken. Manuell tragen Sie in .cursor/mcp.json einen Eintrag mit command npx und den Argumenten -y, mcp-remote@latest, dem Endpunkt sowie --header und dem Authorization-Wert ein. Dafür brauchen Sie Node.js ab 20.18.1. Unter Windows schreiben Sie npx.cmd statt npx. Wichtig: Wählen Sie in Cursor ein festes Modell, der Auto-Modus ist laut Hygraph nicht kompatibel.

VS Code und Windsurf

In VS Code legen Sie in .vscode/mcp.json unter servers einen Eintrag mit type http, der url des Endpunkts und einem headers-Objekt mit Authorization an. Windsurf bindet den Server wie Cursor über mcp-remote ein, die Datei liegt unter ~/.codeium/windsurf/mcp_config.json. Danach Refresh Servers wählen.

Sicher arbeiten

Löschen und Unpublish sind über MCP ohnehin gesperrt. Trotzdem kann der Assistent Inhalte und Schema ändern und veröffentlichen. Nutzen Sie daher den engsten passenden Token-Typ und getrennte Tokens für Staging und Produktion. Das Werkzeug execute_graphql kann auch Massenänderungen ausführen, lesen Sie deshalb vor jeder Freigabe die Zusammenfassung.

claude mcp add --transport http hygraph https://mcp-{REGION}.hygraph.com/{PROJECT_ID}/{ENVIRONMENT}/mcp --header "Authorization: Bearer $HYGRAPH_TOKEN"

Projektendpunkt: Permanent Auth Token als Bearer-Header im Authorization-Header, Rechte über den Token-Typ (General, Content, Management, Read-only). Globaler Endpunkt und Claude-Connector: Anmeldung mit dem eigenen Hygraph-Konto.

Je nach Token-Typ oder Benutzerrechten Lesen, Anlegen, Ändern und Veröffentlichen von Inhalten sowie Verwaltung des Schemas, außerdem Starten von Agenten und Lesen der AI Guidelines. Löschen und Unpublish sind über MCP nie möglich.

Anfragen laufen über den von Hygraph gehosteten Server an das jeweilige Projekt. Inhalte, die im Chat erscheinen, gehen zusätzlich an den KI-Anbieter des Clients. Hygraph empfiehlt, Tokens als Umgebungsvariable zu übergeben statt sie fest in Konfigurationsdateien einzutragen.

Mittel. Der Assistent kann Inhalte und Schema ändern und veröffentlichen, aber nichts löschen. Ein präparierter Text mit versteckten Anweisungen kann ungewollte Änderungen auslösen, das Werkzeug execute_graphql auch Massenänderungen. Hygraph rät zu passenden Token-Typen, getrennten Tokens je Umgebung und zur Prüfung jeder Freigabe.