Frequently Asked Questions (FAQ) - Sanity MCP Server & UBOS

Q: What is the Sanity MCP Server? A: The Sanity MCP Server is a tool available on the UBOS Asset Marketplace that connects your Sanity CMS content to AI agents via the Model Context Protocol (MCP). This allows you to use natural language to create, update, and explore your structured content with AI tools like Claude, Cursor, and VS Code.

Q: What is the Model Context Protocol (MCP)? A: MCP is an open protocol that standardizes how applications provide context to Large Language Models (LLMs). It enables AI models to access and interact with external data sources and tools, such as Sanity CMS.

Q: What are the benefits of using the Sanity MCP Server? A: The Sanity MCP Server transforms content operations by allowing AI to assist with content creation, updates, and exploration. It helps automate tasks, improve content consistency, and unlock new possibilities for personalized content experiences.

Q: What AI tools are compatible with the Sanity MCP Server? A: The Sanity MCP Server is compatible with any application that supports the Model Context Protocol, including Claude Desktop, Cursor IDE, Visual Studio Code, and custom MCP-compatible applications.

Q: What are the prerequisites for using the Sanity MCP Server? A: You need a Sanity Studio with a deployed schema manifest and your API credentials (Project ID, Dataset name, and API token with appropriate permissions).

Q: What types of content operations can I perform with the Sanity MCP Server? A: You can perform a wide range of operations, including creating new documents, updating existing documents, translating content, querying documents, managing releases, and more.

Q: What are the available transport options for the Sanity MCP Server? A: The server supports two transport mechanisms: stdio (default) and SSE (Server-Sent Events). Stdio is suitable for local integrations, while SSE is better for web applications and remote connections.

Q: What security features does the Sanity MCP Server have? A: The server includes origin validation, localhost binding, and CORS support to prevent DNS rebinding attacks and ensure the security of your content and data.

Q: What is UBOS? A: UBOS is a full-stack AI Agent Development Platform focused on bringing AI Agents to every business department. Our platform helps you orchestrate AI Agents, connect them with your enterprise data, build custom AI Agents with your LLM model, and develop Multi-Agent Systems.

Q: What user roles are supported by the Sanity MCP Server? A: The server supports two user roles: ‘developer’ (access to all tools) and ‘editor’ (content-focused tools without project administration).

Q: How do I configure the Sanity MCP Server? A: You configure the server by setting environment variables such as SANITY_API_TOKEN, SANITY_PROJECT_ID, SANITY_DATASET, and MCP_USER_ROLE. See the Configuration section in the documentation for details.

Q: How do I set up the Node.js environment for the Sanity MCP Server? A: If you use a Node version manager like NVM, you may need to create symlinks to ensure the MCP server can access Node.js. See the Node.js Environment Setup section in the documentation for detailed instructions.

Q: What should I do if I’m having trouble getting the Sanity MCP Server to work? A: Double-check your configuration, ensure you have the necessary prerequisites, and consult the troubleshooting section in the documentation.

Q: Is it safe to use the Sanity MCP Server with a production dataset? A: Exercise caution when using the server with a production dataset and a token that has write access, as the AI can perform destructive actions. Consider using a development/staging dataset for testing AI operations.