Frequently Asked Questions (FAQ) - Contentful GraphQL MCP Server

Q: What is the Contentful GraphQL MCP Server? A: It’s an implementation of the Model Context Protocol (MCP) server that provides GraphQL query capabilities for Contentful’s Content Delivery API (CDA), enabling efficient content retrieval and schema exploration for AI Agents.

Q: What are the key benefits of using GraphQL with Contentful? A: GraphQL allows for flexible queries, reduces response size by fetching only needed fields, enables nested references in a single query, offers schema validation, and improves data fetching efficiency and type safety.

Q: What tools are included in the Contentful GraphQL MCP Server? A: The server includes tools for listing content types (graphql_list_content_types), getting content type schema (graphql_get_content_type_schema), generating example queries (graphql_get_example), and executing custom GraphQL queries (graphql_query).

Q: What are GraphQL Prompts in Contentful GraphQL MCP Server? A: The MCP server provides two helpful prompts to guide GraphQL schema exploration: explore-graphql-schema and build-graphql-query.

Q: What is a CDA token and why is it used? A: CDA (Content Delivery API) tokens provide secure, read-only access to your Contentful content, ensuring that AI Agents can only retrieve content and not modify it.

Q: Do I need to clone the repo to use this MCP? A: No, you can directly add the MCP to your claude_desktop_config.json without cloning the repository.

Q: What environment variables are required to configure the MCP server? A: The required environment variables are CONTENTFUL_DELIVERY_ACCESS_TOKEN (or --delivery-token) for the CDA token and SPACE_ID (or --space-id) for your Contentful space ID. ENVIRONMENT_ID is optional and defaults to “master”.

Q: Can I use this MCP with other MCP clients besides Claude Desktop? A: Yes, the StreamableHTTP implementation follows the standard MCP protocol specification, allowing any MCP client to connect without special handling.

Q: How does the StreamableHTTP transport mode differ from the default stdio transport? A: The stdio transport uses standard input/output streams, ideal for integration with MCP clients like Claude Desktop, while StreamableHTTP is for web-based integrations or standalone service deployment.

Q: What kind of error handling does the MCP server implement? A: The server handles authentication failures, invalid GraphQL queries, network connectivity issues, schema introspection errors, and rate limiting from Contentful’s API.

Q: Is this MCP server officially supported by Contentful? A: No, this MCP server is community-maintained and not officially supported by Contentful. For issues and feature requests, use the GitHub issue tracker.

Q: How does the Contentful GraphQL MCP Server integrate with UBOS platform? A: The Contentful GraphQL MCP Server is a valuable asset within the UBOS platform. UBOS is a full-stack AI Agent development platform focused on bringing AI Agents to every business department. By leveraging the Contentful GraphQL MCP Server within UBOS, you can build AI Agents that leverage Contentful content, connect AI Agents to your existing workflows and create custom AI Agent solutions.