stackgate.ai
Alle integrationer

Contentful

Læs Contentful spaces, content types, entries og assets via Content Management API.

Manual setup 7 værktøjer

Eksempelspørgsmål

Prøv at spørge din AI-klient

  • Which Contentful entries in Blog are still in draft?

  • Did the homepage hero entry ever get published after last week's review?

  • Write a draft outline for a new changelog entry about the feature Amalie shipped - do not create it.

  • List content types in the marketing space and how many entries each has.

  • Find the asset we used for the June campaign banner.

Overblik

Forbind Contentful, så AI-klienter kan gennemse spaces, content types, entries og assets via Content Management API.

Integrationen er read-first: kun list-, get- og søgeværktøjer. Publicering af entries eller upload af assets er ikke inkluderet.

Forudsætninger

  • Et Contentful-space, du kan administrere
  • Rettighed til at oprette et Content Management API (CMA) personal access token
  • En stackgate.ai-konto

Sådan får du credentials

  1. Log ind på Contentful.
  2. Åbn Settings → CMA tokens (eller Settings → API keys → Content management tokens).
  3. Opret et personal access token og kopiér det med det samme. Content Delivery API-tokens kan ikke liste spaces.
  4. Kopiér evt. et standard space ID fra space-indstillinger eller space-vælgeren.
  5. I stackgate.ai: Mine integrationer → Contentful.
  6. Indsæt tokenet, angiv evt. standard-space og environment (master er standard), og gem. stackgate.ai verificerer tokenet mod Contentfuls /spaces-endpoint.
  7. Spaces med EU-dataresidens skal bruge https://api.eu.contentful.com som API base URL.
  8. Brug evt. Edit tool access for kun at tillade et udvalg af læseværktøjer.

Se Contentful authentication og Content Management API.

Brug med AI-klienter

  • Dedikeret endpoint: POST /mcp/contentful med Sanctum bearer token
  • Private gateway: én config til alle integrationer - brug contentful__*-navngivne værktøjer

Eksempel-prompter:

  • "List mine Contentful spaces."
  • "Vis content types i space space123."
  • "Søg i Contentful-entries efter pricing."
  • "Hent metadata for Hero image-asset."

Fejlfinding

  • 422 integration not configured - udfyld personal access token-formularen under My Integrations.
  • 401 Unauthorized - generér et nyt CMA personal access token og opdater My Integrations. Delivery API-tokens virker ikke.
  • 403 Forbidden - tokenet kan ikke administrere det ønskede space eller environment.
  • 404 Not found - tjek space ID, environment ID (master medmindre du bruger et navngivet environment) og entry- eller asset-ID.
  • 429 Too many requests - Contentful tillader ca. 10 CMA-kald pr. sekund pr. space. Prøv igen efter kort pause.
  • EU-residens - sæt API base URL til https://api.eu.contentful.com, hvis spacet ligger i EU-regionen.

Tilgængelige værktøjer

  • list_spaces

    List Contentful-spaces, tokenet har adgang til.

  • list_content_types

    List content types i et Contentful-space og environment.

  • list_entries

    List Contentful-entries, evt. filtreret på content type.

  • search_entries

    Fritekst-søgning i Contentful-entries.

  • get_entry

    Hent en Contentful-entry efter ID, inkl. felter og sys-metadata.

  • list_assets

    List Contentful-assets (medier) i et space.

  • get_asset

    Hent Contentful-asset-metadata efter ID, inkl. fil-URL.

MCP-endpoint: https://stackgate.ai/mcp/contentful (HTTP) eller via private gateway.

Opret konto Dokumentation