Connect Claude to Your CMS: A 5-Minute Guide to the Cosmic MCP Server
A step-by-step guide to connecting AI directly to your content infrastructure using Model Context Protocol for real read and write capabilities.

Stock photo for illustration only, not from the actual event
- Connect Claude directly to your CMS to read and write actual content
- Cosmic MCP Server exposes 18 bucket-scoped tools for complete integration
- Strict separation of read and write keys ensures production safety
- Start immediately on the Free tier or use a dedicated staging bucket on Builder
If you already run Claude every day, the next obvious question is whether it can touch your content. Not just summarize it, or draft copy in a chat window that you then paste elsewhere, but actually read your content model, query it, and write back to it.
Cosmic answers that challenge with an MCP server. This guide gets you connected in about five minutes, then covers the part most people skip: what Claude is allowed to do once it is connected. Model Context Protocol provides a standard way for an AI client to discover and call tools directly, eliminating the need to describe your CMS in prose.
The Cosmic MCP server exposes 18 bucket-scoped tools covering objects, object types, media, and AI generation. Bucket-scoped means the server operates against a single Bucket using your provided keys and cannot reach across your other Buckets.

Stock photo for illustration only, not from the actual event
Inside your Cosmic dashboard, open your Bucket, navigate to Settings, and select API Access. Copy three essential items: your Bucket slug, your read key, and your write key. These keys are deliberately separated, representing the single most useful control in the entire setup.
Separating read and write credentials is a critical security pattern when integrating AI agents into content management systems. It guarantees that read-only tokens physically cannot execute write commands, mitigating risks during initial testing and workflow automation.
The hosted endpoint offers the fastest path without requiring local installation. Point your client to https://mcp.cosmicjs.com/v1/buckets/{your-bucket-slug} and authenticate using your keys within the Authorization header. For Claude Desktop, edit your configuration file and handle the bearer token carefully by combining your read and write keys separated by a colon.
Once connected, you can verify the setup by prompting the system to list object types and object counts within your Bucket. From there, you can execute practical workflows like finding published blog posts missing SEO descriptions or generating draft content from outlines.
Regarding pricing, you can start on the Free plan which includes 1 Bucket, 2 team members, and 1,000 Objects. For workflows requiring a separate staging environment, the Builder plan starts at $49 per month and supports 2 Buckets, 3 team members, and 5,000 Objects.
Source: Dev.to
Found something wrong in this article? Report an issue with this article
Comments
Leave a Comment