sylius-mcp — vorher wissen, was der Server kann.
Das Bundle registriert Shop-Tools für den MCP-Server und veröffentlicht die Server Card nach SEP-1649 unter /.well-known/mcp/server-card.json. Ein Agent lernt daraus Transport und Tool-Fläche, bevor er sich verbindet, und findet die Protected-Resource-Metadaten, ohne erst abgewiesen zu werden.
Eine angekündigte Fähigkeit, hinter der nichts steht, ist teurer als ihr Fehlen.
Ohne Server Card verläuft der Einstieg eines Agenten über Fehlschläge: verbinden, abgewiesen werden, aus der Zurückweisung die Metadaten lernen, erneut verbinden. Das funktioniert, kostet aber Runden und macht jeden ersten Kontakt zu einer Fehlerbehandlung. Die Card nach SEP-1649 stellt Transport, Tool-Fläche und Protected-Resource-Metadaten vorher hin, unter /.well-known/mcp/server-card.json.
Die Tools-Fähigkeit wird nur dann angekündigt, wenn tatsächlich etwas registriert ist. Eine Zusage ohne Deckung ist schlechter als gar keine: der Agent verbindet sich genau auf diese Zusage hin, ruft die Liste ab und bekommt sie leer zurück — und hat keinen Anhaltspunkt, ob das eine Fehlkonfiguration auf der Serverseite ist oder Absicht. Eine nicht angekündigte Fähigkeit ist dagegen eine klare Aussage, auf die er reagieren kann.
Damit hängt die Card an dem, was der Shop wirklich registriert hat, statt an einer separaten Konfiguration, die jemand nachziehen muss.
Quellcode & Doku
Composer-Paket
MIT · Sylius 2.0+ · PHP 8.2+
composer require koh/sylius-mcp
Gebaut, getestet und unter MIT veröffentlicht. Die öffentliche Distribution über Packagist wird vorbereitet (coming soon).
Teil der Familie
MIT
Dieses Paket gehört zu koh/sylius-agent-ready — siebzehn Bundles, die einen Sylius-Shop für KI-Agenten benutzbar machen. Jedes ist einzeln einsetzbar.