AI-Werkzeuge

EmDash hat einen eingebauten Model Context Protocol (MCP)-Server, mit dem KI-Assistenten direkt mit den Inhalten Ihrer Site arbeiten können. Sie können Claude, ChatGPT oder andere Werkzeuge bitten, Beiträge zu entwerfen, Seiten zu aktualisieren, Medien zu verwalten, Inhalte zu durchsuchen und mehr — alles über natürliche Konversation.

Der MCP-Server Ihrer Site

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

Zum Deaktivieren setzen Sie mcp: false in Ihrer Astro-Konfiguration:

emdash({
	mcp: false,
});

Einen AI-Client verbinden

Die MCP-Server-URL Ihrer Site ist:

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

Ersetzen Sie example.com durch Ihre Domain. Für die 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 Site-Inhalten arbeiten

Nach der Verbindung können Sie den KI-Assistenten in natürlicher Sprache bitten, jede dieser Operationen auszuführen. Sie müssen die Werkzeugnamen nicht kennen — beschreiben Sie einfach, was Sie wollen.

Content

• Inhalte durchsuchen — “Show me the latest 10 blog posts” oder “Find all draft pages”
• Inhalte lesen — “Get the post called ‘hello-world’ and summarize it”
• Inhalte erstellen — “Write a new blog post about our summer sale” oder “Create a draft page for the About section”
• Inhalte bearbeiten — “Update the pricing page to mention the new plan” oder “Fix the typo in the FAQ post”
• Veröffentlichen und planen — “Publish the summer sale post”, “Schedule the announcement for June 1st at 9am” oder “Cancel the schedule on the launch post”
• Versionen vergleichen — “Show me what changed in the homepage since it was last published”
• Entwürfe verwalten — “Discard the draft changes on the about page” oder “Duplicate the newsletter template”
• Übersetzungen — “What translations exist for the welcome post?” oder “Create a French draft linked to this English post” (wenn i18n aktiviert ist)

Bylines

• Bylines durchsuchen — “List the guest contributors whose names contain ‘Lee’”
• Inhalte zuschreiben — “Add Priya Shah as the primary byline on this post”
• Bylines verwalten — “Create a guest byline for Sam Rivera” oder “Update this contributor’s bio”
• Bylines übersetzen — “Show the locale variants of this byline”

Erstellen, Aktualisieren, Löschen und Übersetzen von Bylines erfordert die Editor-Rolle. Content-Schreibwerkzeuge akzeptieren bestehende Byline-IDs, wenn der Aufrufer Berechtigung zum Erstellen oder Bearbeiten dieses Inhalts hat.

Media

• Medien durchsuchen — “List all uploaded images” oder “Show me PDFs in the media library”
• Details prüfen — “Get the details for this media item”
• Dateien hochladen — “Upload this base64 image as banner.png”
• Signierte Uploads bestätigen — “Confirm the upload with this storage key”
• Metadaten aktualisieren — “Set the alt text on the hero image to ‘Mountain sunset’”
• Dateien entfernen — “Delete the old banner image”

media_upload akzeptiert base64-kodierte Bytes, speichert die Datei, registriert das Medienelement und gibt ID und URL zurück. Es setzt die MIME-Typ- und Upload-Größenlimits der Site durch.

media_create schließt einen ausstehenden Upload ab, der über POST /_emdash/api/media/upload-url erstellt wurde. Laden Sie die Datei mit der zurückgegebenen signierten URL hoch und übergeben Sie dann ihren storageKey an media_create vom selben Benutzerkonto. Die Bestätigung prüft, dass die gespeicherte Datei existiert und der Größe entspricht, die beim Anfordern der Upload-URL angegeben wurde. Dieser Workflow erfordert Author oder eine höhere Rolle; Contributors können media_upload nutzen.

Search

• Inhalte finden — “Search for posts mentioning ‘accessibility’” oder “Find anything about TypeScript across all collections”

Taxonomies

• Durchsuchen — “List all categories” oder “Show me the tags”
• Begriffe erstellen — “Add a ‘tutorials’ tag” oder “Create a ‘Frontend’ subcategory under ‘Engineering’”
• Begriffe umbenennen — “Rename the ‘frontend’ category to ‘Web Frontend’”
• Begriffe verschieben — “Move the ‘tutorials’ tag under the ‘guides’ category” oder “Detach ‘react’ from its parent”
• Begriffe löschen — “Delete the unused ‘archive’ tag”

Menus

• Menüs anzeigen — “Show me the main navigation menu” oder “What’s in the footer menu?”
• Menüs erstellen — “Create a new ‘sidebar’ menu”
• Menüs bearbeiten — “Rename the ‘main’ menu to ‘Primary navigation’”
• Einträge setzen — “Replace the items in the main menu with Home, Blog, About, and Contact”
• Menüs löschen — “Delete the unused ‘mobile’ menu”

Site settings

• Prüfen — “What’s the current site title?” oder “Show me the social links”
• Identität aktualisieren — “Set the site title to ‘Acme Blog’ and tagline to ‘Stories from the team’”
• Logo / Favicon setzen — “Use this image as the site logo” (nach dem Hochladen mit media_upload)
• SEO-Defaults — “Set the default OG image to the new banner” oder “Update the title separator to a vertical bar”
• Social Handles — “Add our GitHub and YouTube links to the social settings”

Schema (nur Admin)

• Prüfen — “What collections exist?” oder “Show me the fields on the posts collection”
• Collections erstellen — “Create a new ‘testimonials’ collection with name and quote fields”
• Schema ändern — “Add a ‘featured’ boolean field to posts”

Revisions

• Historie anzeigen — “Show the revision history for this post”
• Wiederherstellen — “Restore the post to its previous version”

Berechtigungen

Wenn ein MCP-Client die OAuth-Zustimmungsseite öffnet, ist jede angeforderte Berechtigung standardmäßig ausgewählt. Deaktivieren Sie jede Berechtigung, die der Client nicht braucht, bevor Sie den Zugriff genehmigen. Das resultierende Token ist auf die ausgewählt gelassenen Berechtigungen und die von Ihrer EmDash-Rolle erlaubten Berechtigungen beschränkt, sodass weniger Berechtigungen zu geben nie erweitert, was der Client tun kann.

EmDash lehnt einen Werkzeugaufruf ab, wenn entweder der Token-Scope oder die Benutzerrolle 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 „create a blog post“ statt „create a post“, wenn Sie mehrere Collections haben.
• Fragen Sie zuerst nach dem Schema. Wenn Sie unsicher sind, welche Felder eine Collection hat, fragen Sie „What fields does the posts collection have?“, bevor Sie Inhalte erstellen oder bearbeiten.
• Prüfen Sie vor dem Veröffentlichen. Bitten Sie die KI, Inhalte als Entwurf zu erstellen, prüfen Sie sie im Admin-Panel, und bitten Sie die KI dann zu veröffentlichen — oder veröffentlichen Sie selbst.
• Nutzen Sie Compare für die Prüfung. Vor dem Veröffentlichen fragen Sie „Compare the live and draft versions of this post“, um genau zu sehen, was sich ändert.
• Rich-Text-Felder nutzen Portable Text. Die KI kann Inhalte für Rich-Text-Felder schreiben, aber komplexe Formatierung ist am besten im Admin-Editor.

Für Entwickler

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