Neos MCP
MCP-Server für Neos 9, der alle über neos/openapi-registrierten APIs als MCP-Tools bereitstellt und dank Neos.OAuth direkt an Claude und ChatGPT angebunden werden kann.
- Name
- Neos.Mcp (medienreaktor/neos-mcp)
- Lizenz
- MIT
- Preis
- kostenlos
- Link
- Paket ansehen
Neos direkt mit AI-Assistenten verbinden
Mit dem Model Context Protocol (MCP) können AI-Assistenten wie Claude oder ChatGPT direkt mit anderen Systemen arbeiten. Neos MCP bringt diesen Standard zu Neos 9: Jede Operation der Neos API steht als MCP-Tool zur Verfügung.
So können Redakteure und Entwickler Inhalte im Chat recherchieren, prüfen und bearbeiten. Sie können Seiten auflisten, SEO-Felder bereinigen, Texte in Workspaces anpassen und Änderungen gezielt veröffentlichen. Immer mit den Rechten des angemeldeten Benutzers, genau wie im Neos-Backend.
Jede Operation der Neos API als MCP-Tool
Arbeiten in Workspaces, veröffentlicht wird nur auf Wunsch
Sichere Anmeldung per OAuth 2 mit Neos OAuth
Claude, ChatGPT und weitere MCP-Clients anbinden
Rechte wie im Backend: Tools je nach Scopes und Privilegien
Aktuelles MCP-Protokoll mit stateless Streamable HTTP
Seiten, Inhalte und Assets im Chat bearbeiten
Änderungen prüfen, bevor sie live gehen
Open Source unter MIT-Lizenz
Die Neos API als Werkzeugkasten
Neos MCP stellt unter /mcp einen MCP-Server bereit, der jede Operation der Neos API als Tool anbietet: Sites, Seiten und Inhalte, Workspaces, Node-Typen, Assets, Benutzer und mehr.
Ein Tool-Aufruf wird intern zu einem echten API-Request. Authentifizierung, Validierung und Fehlermeldungen funktionieren dadurch exakt wie über die REST API. Es gibt also keinen zweiten, parallel gepflegten Zugang zu euren Inhalten.
Sicher angemeldet mit Neos OAuth
AI-Clients melden sich über Neos OAuth an, entweder per Client ID Metadata Document oder per dynamischer Client-Registrierung. Beides ist standardmäßig deaktiviert und wird bewusst freigeschaltet. Die Tokens sind fest an den MCP-Server gebunden (RFC 8707) und lassen sich nicht für andere Zwecke verwenden.
Jedes Tool läuft mit dem Konto des angemeldeten Benutzers. Angezeigt werden nur die Tools, die dessen Scopes und Rechte erlauben. Die AI kann also nie mehr als der Mensch, für den sie arbeitet.
Leitplanken für die AI
Der Server liefert dem AI-Assistenten klare Arbeitsanweisungen mit: Änderungen entstehen im persönlichen Workspace des Benutzers oder in einem gemeinsamen Workspace, niemals direkt auf der Live-Website. Veröffentlicht wird erst, wenn der Benutzer es ausdrücklich verlangt.
Vor dem Löschen von Seiten, Workspaces oder Benutzern fragt die AI nach. Und weil alles in Workspaces passiert, könnt ihr jede Änderung vorher prüfen, im Chat oder ganz klassisch im Neos-Backend.
Schnell eingerichtet und erweiterbar
Neos MCP wird neben Neos API und Neos OAuth installiert. Danach reicht ein Befehl, um den Server zum Beispiel in Claude Code hinzuzufügen: claude mcp add --transport http neos https://example.com/mcp
Unter der Haube steckt unsere Library neos-openapi-mcp, die beliebige APIs auf Basis von neos/openapi als MCP-Tools bereitstellt. So lassen sich auch eigene APIs eurer Neos-Installation für AI-Assistenten öffnen.
Fragen & Antworten
Das Model Context Protocol (MCP) ist ein offener Standard, über den AI-Assistenten auf externe Systeme zugreifen können. Ein MCP-Server beschreibt, welche Werkzeuge er anbietet, und der Assistent nutzt sie, um Aufgaben direkt im angebundenen System zu erledigen. In diesem Fall also in Neos.
Der Server weist die AI an, nur in Workspaces zu arbeiten, ausschließlich auf ausdrückliche Anweisung zu veröffentlichen und vor dem Löschen nachzufragen. Die harte Grenze setzen aber die Rechte: Die AI handelt immer als der angemeldete Benutzer und kann nichts tun, was dieser nicht auch im Neos-Backend dürfte.
Für besonders sensible Projekte könnt ihr der AI deshalb ein eigenes Konto mit eingeschränkten Rechten geben.
Neos 9 mit PHP 8.4 sowie unsere Pakete Neos API und Neos OAuth, die als Abhängigkeiten automatisch mitinstalliert werden. Auf der Client-Seite einen AI-Assistenten, der die aktuelle MCP-Version mit Streamable HTTP unterstützt.
Ja. Neos MCP steht wie Neos API und Neos OAuth unter der MIT-Lizenz. Ihr könnt es kostenlos herunterladen, verwenden und an eure Anforderungen anpassen.