Contentful MCP mit Microsoft Copilot verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Contentful klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Contentful + Microsoft Copilot

Lass deine KI mit deinen Contentful-Inhalten arbeiten: Einträge und Assets durchsuchen, Content Types, Locales und Tags lesen sowie Einträge anlegen, ändern, veröffentlichen oder zurückziehen. Delivery-Token zum Lesen, Management-Token zum Schreiben.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

CONTENTFUL_SPACE_ID, CONTENTFUL_ENVIRONMENT, CONTENTFUL_DELIVERY_URL, CONTENTFUL_DELIVERY_TOKEN

Schritt 1 — Zugangsdaten holen

1. Öffne in Contentful (https://app.contentful.com) deinen Space und dann Settings → API keys → Add API key. Gib dem Key einen Namen (zum Beispiel „AnythingMCP“), hake die Environments an, die er lesen darf (mindestens master), und speichere.
2. Kopiere die Space ID in CONTENTFUL_SPACE_ID und den Content Delivery API access token in CONTENTFUL_DELIVERY_TOKEN.
3. Setze CONTENTFUL_ENVIRONMENT auf die Environment-ID, meist master. Weitere Environments findest du unter Settings → Environments.
4. Setze CONTENTFUL_DELIVERY_URL auf https://cdn.contentful.com, für einen Space in der EU-Datenregion auf https://cdn.eu.contentful.com, jeweils ohne abschließenden Schrägstrich. Soll die KI auch Entwürfe lesen, nimm https://preview.contentful.com (oder https://preview.eu.contentful.com) zusammen mit dem Content Preview API access token desselben Keys.
5. Zum Schreiben erstellst du ein persönliches Zugriffstoken: Avatar-Menü → Account settings → CMA tokens → Create personal access token. Wähle ein Ablaufdatum und kopiere das Token sofort, denn Contentful zeigt es nur einmal an. Trage es ohne das Wort Bearer in CONTENTFUL_MANAGEMENT_TOKEN ein und setze CONTENTFUL_MANAGEMENT_URL auf https://api.contentful.com (oder https://api.eu.contentful.com). Das Token handelt in deinem Namen, in jedem Space, den du bearbeiten darfst.
6. Muss deine Organisation persönliche Zugriffstokens freigeben, öffnet ein Admin der Organisation die Organization settings, sucht das Token in den Zugriffseinstellungen für persönliche Zugriffstokens und gewährt ihm Zugriff. Bis dahin antworten die Schreib-Tools mit 401 OrganizationAccessGrantRequired; das Lesen mit dem Delivery-Token ist davon nicht betroffen.
7. Installiere den Connector und beginne mit contentful_get_space: Das Tool liefert den Namen des Space und seine Locales und zeigt so schnell, ob Space ID und Delivery-Token zusammenpassen.

Zwei Tokens, mit Absicht: Das Delivery-Token liest veröffentlichte Inhalte und sonst nichts (mit dem Preview-Token auch Entwürfe). Ein Connector, der nur die vier Pflichtwerte kennt, kann also alles nachschlagen, ändert aber nichts. Schreiben, unveröffentlichte Entwürfe, Spaces und Environments laufen über die Content Management API mit dem persönlichen Zugriffstoken. Lässt du CONTENTFUL_MANAGEMENT_URL und CONTENTFUL_MANAGEMENT_TOKEN leer, melden die Management-Tools einfach, dass sie fehlen.

Veröffentlichen ändert deine Live-Site: contentful_publish_entry und contentful_unpublish_entry ändern, was Besucher auf deiner Website oder in deiner App sehen. Die KI nennt deshalb den Eintrag und die Auswirkung und wartet auf dein Ja. contentful_delete_entry ist bei der Installation ausgeschaltet, denn ein gelöschter Eintrag lässt sich nicht wiederherstellen.

So funktionieren Änderungen: contentful_list_content_types liefert die IDs der Content Types und Felder, contentful_list_locales die Locale-Codes. Feldwerte stehen unter der Feld-ID und darunter unter der Locale, zum Beispiel {"title": {"en-US": "Hello"}}. Vor jeder Änderung liest die KI den Eintrag mit contentful_get_entry_for_editing, um seine aktuelle sys.version zu bekommen; hat zwischendurch jemand anderes gespeichert, antwortet Contentful mit 409 VersionMismatch, und die KI liest neu. contentful_update_entry ersetzt alle Felder, was fehlt, wird gelöscht; für ein oder zwei Felder nimmt die KI contentful_patch_entry. Live ist eine Änderung erst, wenn die neue Version veröffentlicht ist.

Suchen: contentful_list_entries nimmt einen content_type, eine Volltextsuche query und weitere Filter wie fields.slug=hello oder fields.date[gte]=2026-01-01. Zum Filtern oder Sortieren nach einem Feld braucht es content_type. Verlinkte Einträge und Assets kommen in includes zurück, und Asset-URLs beginnen mit //, die KI ergänzt also https:.

Paginierung: Listen liefern total, skip und limit (bis 1.000); die nächste Seite beginnt bei skip + limit.

Häufige Fehler: 401 AccessTokenInvalid heißt, dass das Token falsch oder abgelaufen ist oder ein Delivery-Token auf dem Preview-Host verwendet wird (oder umgekehrt). 404 NotFound ist eine falsche ID oder ein Space oder Environment, das das Token nicht abdeckt: Contentful antwortet hier mit 404, nicht mit 403. 400 „A Content Type ID is required“ bedeutet einen Feldfilter ohne content_type. 422 ValidationFailed nennt das Feld, das leer ist oder eine Validierung verletzt. 429 RateLimitExceeded: Die Management API erlaubt etwa 7 Anfragen pro Sekunde, also kurz warten und erneut versuchen.

Der Connector lädt keine Assets hoch, legt keine Content Types an und bearbeitet sie nicht, verwaltet keine Environments, Webhooks, Rollen und Apps und nutzt nicht die GraphQL API.

Schritt 2 — Adapter installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Schritt 3 — Connector in Microsoft Copilot hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die Contentful-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

Verfügbare Tools

Beispiel-Prompts

• „Finde die Blogartikel, die wir in den letzten 30 Tagen veröffentlicht haben, und liste jeweils Titel, Slug und Autor auf.“
• „Welche Einträge haben gespeicherte Änderungen, die noch nicht veröffentlicht sind?“
• „Liste die Bilder auf, die wir diesen Monat hochgeladen haben, mit Dateigröße und Abmessungen.“
• „Ändere die Überschrift der Landingpage zum Frühjahrs-Sale in ‚Frühjahrs-Sale: 20 % auf alles‘ und veröffentliche sie, sobald ich zustimme.“

FAQ

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden