ComposioHQ/Contentful-Automation

Was macht Contentful-Automation?

Verwalten Sie Ihre Contentful Headless-CMS-Spaces direkt aus Claude Code. Listen Sie Spaces auf, rufen Sie Metadaten ab und aktualisieren Sie Space-Konfigurationen, ohne Ihr Terminal zu verlassen.

Toolkit-Dokumentation: composio.dev/toolkits/contentful

---

Einrichtung

1. Fügen Sie den Composio MCP-Server zu Ihrer Konfiguration hinzu:

   https://rube.app/mcp
   

2. Verbinden Sie Ihr Contentful-Konto, wenn Sie dazu aufgefordert werden. Der Agent stellt einen Authentifizierungslink bereit. Stellen Sie sicher, dass Ihr Zugriffstoken über Space-Verwaltungsberechtigungen verfügt.

---

Kern-Workflows

1. Alle Spaces auflisten

Entdecken Sie alle Contentful-Spaces, auf die Ihr authentifiziertes Konto zugreifen kann. Dies ist typischerweise die erste Operation, da die meisten anderen Aktionen eine space_id erfordern.

Werkzeug: CONTENTFUL_LIST_SPACES

Wichtige Parameter:

• limit (1-1000) – maximale Anzahl der zurückzugebenden Spaces (Standard: 100)
• skip – Anzahl der zu überspringenden Spaces für die Paginierung
• order – Sortierung nach Feld, z. B. sys.createdAt oder -sys.createdAt für absteigend

Beispielaufforderung: „Liste alle meine Contentful-Spaces auf“

---

2. Space-Details abrufen

Rufen Sie detaillierte Metadaten für einen bestimmten Space ab, einschließlich seiner aktuellen sys.version, die für Aktualisierungen erforderlich ist.

Werkzeug: CONTENTFUL_GET_SPACE

Wichtige Parameter:

• space_id (erforderlich) – die ID des abzurufenden Spaces (alphanumerisch, 1-64 Zeichen)

Beispielaufforderung: „Details für Contentful-Space abc123def abrufen“

---

3. Space-Namen aktualisieren

Aktualisieren Sie den Namen eines bestimmten Spaces. Erfordert die aktuelle Versionsnummer für optimistische Sperrung, um Konflikte durch gleichzeitige Änderungen zu vermeiden.

Werkzeug: CONTENTFUL_UPDATE_SPACE

Wichtige Parameter:

• space_id (erforderlich) – ID des zu aktualisierenden Spaces
• name (erforderlich) – neuer Name für den Space (1-255 Zeichen)
• version (erforderlich) – aktuelle Space-Version aus sys.version (muss > 0 sein)

Beispielaufforderung: „Contentful-Space abc123def in 'Production Content Hub' umbenennen“

---

4. Space-Inventar prüfen

Kombinieren Sie die Space-Auflistung und den Detailabruf, um die Contentful-Spaces Ihrer Organisation zu prüfen.

Werkzeuge: CONTENTFUL_LIST_SPACES dann CONTENTFUL_GET_SPACE

Workflow:

1. Listen Sie alle Spaces auf, um IDs und Namen zu erhalten
2. Rufen Sie Details für jeden Space ab, um Versionsinformationen, Erstellungsdaten und Metadaten zu erhalten

Beispielaufforderung: „Alle Contentful-Spaces prüfen – auflisten mit ihren Erstellungsdaten und aktuellen Versionen“

---

Bekannte Fallstricke

• Versionskonflikte bei Aktualisierungen: CONTENTFUL_UPDATE_SPACE erfordert die neueste sys.version aus CONTENTFUL_GET_SPACE. Wenn jemand anderes den Space zwischen Ihrem Lese- und Schreibvorgang geändert hat, schlägt die Aktualisierung mit einem Versionskonflikt fehl. Rufen Sie den Space immer unmittelbar vor der Aktualisierung ab.
• Paginierung bei vielen Spaces: CONTENTFUL_LIST_SPACES verwendet die Parameter limit und skip. Wenn Sie viele Spaces haben, durchlaufen Sie sie, indem Sie skip erhöhen, bis keine weiteren Ergebnisse mehr zurückgegeben werden, um keine Spaces zu übersehen.
• Einschränkungen des Umfangs: Diese Werkzeuge verwalten nur Space-Metadaten (Namen). Sie können keine Einträge, Inhaltstypen oder Assets innerhalb eines Spaces erstellen oder ändern.
• Auth/Berechtigungskonflikte: Aktualisierungen über CONTENTFUL_UPDATE_SPACE schlagen fehl, wenn Ihrem Token die Space-Verwaltungsberechtigungen fehlen, selbst wenn Lesevorgänge über CONTENTFUL_GET_SPACE erfolgreich sind. Überprüfen Sie, ob Ihr Token Schreibberechtigungen hat.
• Space-ID-Format: Die space_id muss dem Muster ^[a-zA-Z0-9-_.]{1,64}$ entsprechen. Ungültige Zeichen werden abgelehnt.

---

Kurzreferenz

Werkzeug-Slug	Beschreibung
CONTENTFUL_LIST_SPACES	Listet alle Spaces auf, auf die Ihr Konto zugreifen kann
CONTENTFUL_GET_SPACE	Ruft detaillierte Metadaten für einen einzelnen Space ab
CONTENTFUL_UPDATE_SPACE	Aktualisiert den Namen eines Spaces (erfordert Version)

---

Bereitgestellt von Composio