KI-Tools

EmDash hat einen integrierten Model Context Protocol (MCP)-Server, der KI-Assistenten direkt mit dem Inhalt Ihrer Website arbeiten lässt. Sie können Claude, ChatGPT oder andere Tools bitten, Beiträge zu verfassen, Seiten zu aktualisieren, Medien zu verwalten, Ihre Inhalte zu durchsuchen und mehr — alles durch natürliche Konversation.

Der MCP-Server Ihrer Website

Der MCP-Server ist standardmäßig aktiviert. EmDash mountet /_emdash/api/mcp, sofern Sie ihn nicht deaktivieren. Der Endpunkt akzeptiert OAuth- oder persönliche Zugangs-Bearer-Tokens; eine Admin-Browsersitzung allein authentifiziert keine MCP-Anfrage. OAuth lässt die Person, die den Client verbindet, Scopes auswählen, bevor EmDash das Token ausstellt.

Um ihn zu deaktivieren, setzen Sie mcp: false in Ihrer Astro-Konfiguration:

emdash({
	mcp: false,
});

Einen KI-Client verbinden

Die MCP-Server-URL Ihrer Website ist:

https://example.com/_emdash/api/mcp

Ersetzen Sie example.com durch Ihre Domain. Für lokale Entwicklung verwenden Sie http://localhost:4321/_emdash/api/mcp.

codex mcp add emdash-site --url https://example.com/_emdash/api/mcp
codex mcp login emdash-site

Mit Website-Inhalten arbeiten

Sobald verbunden, können Sie den KI-Assistenten bitten, jede dieser Operationen in natürlicher Sprache durchzuführen. Sie müssen die Tool-Namen nicht kennen — beschreiben Sie einfach, was Sie möchten.

Inhalte

• Inhalte durchsuchen — “Zeige mir die letzten 10 Blog-Beiträge” oder “Finde alle Entwurfsseiten”
• Inhalte lesen — “Hole den Beitrag namens ‘hello-world’ und fasse ihn zusammen”
• Inhalte erstellen — “Schreibe einen neuen Blog-Beitrag über unseren Sommer-Sale” oder “Erstelle einen Seitenentwurf für den Über-Bereich”
• Inhalte bearbeiten — “Aktualisiere die Preisseite mit dem neuen Plan” oder “Behebe den Tippfehler im FAQ-Beitrag”
• Veröffentlichen und planen — “Veröffentliche den Sommer-Sale-Beitrag”, “Plane die Ankündigung für den 1. Juni um 9 Uhr” oder “Storniere den Zeitplan für den Launch-Beitrag”
• Versionen vergleichen — “Zeige mir, was sich auf der Startseite seit der letzten Veröffentlichung geändert hat”
• Entwürfe verwalten — “Verwerfe die Entwurfsänderungen auf der Über-Seite” oder “Dupliziere die Newsletter-Vorlage”
• Übersetzungen — “Welche Übersetzungen gibt es für den Willkommensbeitrag?” oder “Erstelle einen französischen Entwurf, der mit diesem englischen Beitrag verknüpft ist” (wenn i18n aktiviert ist)

Autorennamen

• Autorennamen durchsuchen — “Liste die Gastautoren auf, deren Namen ‘Lee’ enthalten”
• Inhalte zuordnen — “Füge Priya Shah als primären Autorennamen zu diesem Beitrag hinzu”
• Autorennamen verwalten — “Erstelle einen Gast-Autorennamen für Sam Rivera” oder “Aktualisiere die Bio dieses Autors”
• Autorennamen übersetzen — “Zeige die Lokalisierungsvarianten dieses Autorennamens”

Das Erstellen, Aktualisieren, Löschen und Übersetzen von Autorennamen erfordert die Editor-Rolle. Inhalts-Schreib-Tools akzeptieren vorhandene Autorennamen-IDs, wenn der Aufrufer die Berechtigung zum Erstellen oder Bearbeiten dieser Inhalte hat.

Medien

• Medien durchsuchen — “Liste alle hochgeladenen Bilder auf” oder “Zeige mir PDFs in der Medienbibliothek”
• Details prüfen — “Hole die Details zu diesem Medienelement”
• Dateien hochladen — “Lade dieses Base64-Bild als banner.png hoch” oder “Importiere das Bild von dieser öffentlichen URL”
• Vorhandene Storage-Objekte registrieren — “Registriere media/2026/banner.png als Medienelement”
• Metadaten aktualisieren — “Setze den Alt-Text des Hero-Bildes auf ‘Bergsonnenuntergang’”
• Dateien entfernen — “Lösche das alte Banner-Bild”

media_upload akzeptiert entweder Base64-codierte Bytes oder eine öffentliche HTTP(S)-URL. Es speichert die Datei, registriert das Medienelement und gibt ID und URL zurück. media_create registriert nur Metadaten für eine Datei, die bereits im Storage liegt. URL-Importe lehnen private Netzwerkziele ab und prüfen Weiterleitungen erneut; beide Pfade erzwingen die MIME-Typ- und Upload-Größenlimits der Website.

Beitragende können media_upload verwenden. Das Registrieren eines vorhandenen Storage-Objekts mit media_create erfordert die Autor-Rolle oder höher.

Suche

• Inhalte finden — “Suche nach Beiträgen, die ‘Barrierefreiheit’ erwähnen” oder “Finde alles über TypeScript in allen Collections”

Taxonomien

• Durchsuchen — “Liste alle Kategorien auf” oder “Zeige mir die Tags”
• Begriffe erstellen — “Füge einen ‘Tutorials’-Tag hinzu” oder “Erstelle eine ‘Frontend’-Unterkategorie unter ‘Engineering’”
• Begriffe umbenennen — “Benenne die ‘frontend’-Kategorie in ‘Web Frontend’ um”
• Begriffe verschieben — “Verschiebe den ‘tutorials’-Tag unter die ‘guides’-Kategorie” oder “Löse ‘react’ von seinem übergeordneten Element”
• Begriffe löschen — “Lösche den ungenutzten ‘archiv’-Tag”

Menüs

• Menüs anzeigen — “Zeige mir das Hauptnavigationsmenü” oder “Was steht im Footer-Menü?”
• Menüs erstellen — “Erstelle ein neues ‘sidebar’-Menü”
• Menüs bearbeiten — “Benenne das ‘main’-Menü in ‘Primäre Navigation’ um”
• Einträge festlegen — “Ersetze die Einträge im Hauptmenü durch Start, Blog, Über und Kontakt”
• Menüs löschen — “Lösche das ungenutzte ‘mobile’-Menü”

Website-Einstellungen

• Inspizieren — “Wie lautet der aktuelle Website-Titel?” oder “Zeige mir die Social Links”
• Identität aktualisieren — “Setze den Website-Titel auf ‘Acme Blog’ und den Slogan auf ‘Geschichten aus dem Team’”
• Logo / Favicon setzen — “Verwende dieses Bild als Website-Logo” (nachdem Sie es mit media_upload hochgeladen haben)
• SEO-Standardwerte — “Setze das Standard-OG-Bild auf das neue Banner” oder “Aktualisiere den Titeltrenner auf einen vertikalen Strich”
• Social-Handles — “Füge unsere GitHub- und YouTube-Links zu den Social-Einstellungen hinzu”

Schema (nur Admin)

• Inspizieren — “Welche Collections gibt es?” oder “Zeige mir die Felder der Posts-Collection”
• Collections erstellen — “Erstelle eine neue ‘testimonials’-Collection mit Name- und Zitat-Feldern”
• Schema ändern — “Füge ein ‘featured’-Boolean-Feld zu Posts hinzu”

Revisionen

• Verlauf anzeigen — “Zeige den Revisionsverlauf für diesen Beitrag”
• Wiederherstellen — “Stelle den Beitrag auf seine vorherige Version wieder her”

Berechtigungen

Wenn ein MCP-Client die OAuth-Einwilligungsseite öffnet, ist jede angeforderte Berechtigung standardmäßig ausgewählt. Deaktivieren Sie alle Berechtigungen, die der Client nicht benötigt, bevor Sie den Zugriff genehmigen. Das resultierende Token ist auf die Berechtigungen beschränkt, die Sie ausgewählt lassen, und die von Ihrer EmDash-Rolle erlaubten Berechtigungen, sodass das Gewähren weniger Berechtigungen nie erweitert, was der Client tun kann.

EmDash lehnt einen Tool-Aufruf ab, wenn entweder der Token-Scope oder die Rolle des Benutzers unzureichend ist. Ein Client kann diesen Fehler erklären, aber EmDash bleibt die Autorität, die ihn durchsetzt.

Tipps

• Seien Sie spezifisch bei Collections. Sagen Sie “erstelle einen Blog-Beitrag” statt “erstelle einen Beitrag”, wenn Sie mehrere Collections haben.
• Fragen Sie zuerst nach dem Schema. Wenn Sie unsicher sind, welche Felder eine Collection hat, fragen Sie “Welche Felder hat die Posts-Collection?”, bevor Sie Inhalte erstellen oder bearbeiten.
• Überprüfen Sie vor dem Veröffentlichen. Bitten Sie die KI, Inhalte als Entwurf zu erstellen, überprüfen Sie sie im Admin-Panel, dann bitten Sie die KI zu veröffentlichen — oder veröffentlichen Sie selbst.
• Verwenden Sie Vergleich zur Überprüfung. Fragen Sie vor dem Veröffentlichen “Vergleiche die Live- und Entwurfsversionen dieses Beitrags”, um genau zu sehen, was sich ändern wird.
• Rich-Text-Felder verwenden Portable Text. Die KI kann Inhalte für Rich-Text-Felder schreiben, aber komplexe Formatierung gelingt am besten im Admin-Editor.

Für Entwickler

Der MCP-Server-Endpunkt, Authentifizierungsmethoden, OAuth-Discovery, Tool-Parameter und Fehlerbehandlung sind in der MCP-Server-Referenz dokumentiert.