How to Use the Prismic MCP in Claude

Q: How do I connect Prismic to my Claude Desktop app?

Open your claudedesktopconfig.json file and add the Prismic server under the mcpServers key. Pass your repository name and access token as environment variables, then restart the app to see the tools appear.

Q: Can Claude Desktop run complex queries on my Prismic repository?

Yes. The agent uses queryprismicdocuments to run raw predicates, which means you can filter by content type, tags, or publication date. Claude Desktop handles the pagination automatically to prevent your chat window from getting overloaded.

Q: How does this MCP Server handle localized Prismic content in Claude Desktop?

The server exposes the searchfilteredlocale tool directly to the agent. When you ask Claude Desktop for French articles, it checks the configured locales with listi18nlanguages and filters the results instantly.

Q: What is the fastest way to check my Prismic custom types in Claude Desktop?

Just ask the agent to list them. It will invoke listcustomtypes and display the exact JSON schemas for your custom types right in your chat interface.

Fetch, filter, and structure your Prismic CMS content directly inside Claude Desktop without leaving your chat window.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect Prismic MCP to Claude Desktop

Create your Vinkius account to connect Prismic to Claude Desktop — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup Prismic with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Pull live Prismic content into Claude Desktop

Stop copying and pasting JSON payloads from your Prismic CMS dashboard into your Claude Desktop chat window. This MCP Server lets your desktop agent run raw queries using `query_prismic_documents` to pull exactly what you need. It drops the raw document structure straight into your active Claude Desktop chat so you can draft updates or analyze schemas instantly. If you need to isolate a single piece of content, the `get_document_by_id` tool fetches the exact Prismic record directly into your Claude Desktop workspace. You don't have to keep a browser tab open to verify Prismic fields or check if an editor published the latest draft while talking to Claude Desktop.

Map localization and custom types in Claude Desktop

Managing multi-language setups is usually a headache, but this Claude Desktop integration simplifies the process. Your desktop agent uses `list_i18n_languages` to see which Prismic locales are active and then runs `search_filtered_locale` to pull localized marketing copy or blog posts straight into your chat. When you need to check how your Prismic content models are structured, the `list_custom_types` tool shows the exact JSON schema of your Prismic custom types. It gives Claude Desktop the exact blueprint of your content before you write a single line of frontend code.

Inspect repository metadata from the desktop app

Keep your local development environment in sync with the production Prismic CMS using your Claude Desktop interface. By calling `get_repo_metadata` through the chat, your desktop agent checks the current master ref to make sure your workspace isn't working with stale cached content. You can also organize your Prismic assets and content by having the desktop agent call `list_global_tags` or `list_documents_by_tag` to group related items. It makes cleaning up orphan pages or auditing tags inside Claude Desktop a fast, automated process.

Setup guide

Set up Prismic MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Prismic MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Prismic MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under prismic-mcp.

json

{
  "mcpServers": {
    "prismic-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Prismic. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Prismic now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Prismic MCP in Claude Desktop

Open your `claude_desktop_config.json` file and add the Prismic server under the `mcpServers` key. Pass your repository name and access token as environment variables, then restart the app to see the tools appear.

Yes. The agent uses `query_prismic_documents` to run raw predicates, which means you can filter by content type, tags, or publication date. Claude Desktop handles the pagination automatically to prevent your chat window from getting overloaded.

The server exposes the `search_filtered_locale` tool directly to the agent. When you ask Claude Desktop for French articles, it checks the configured locales with `list_i18n_languages` and filters the results instantly.

Just ask the agent to list them. It will invoke `list_custom_types` and display the exact JSON schemas for your custom types right in your chat interface.

Your API tokens and Prismic document payloads never leave your local machine. The server runs as a local subprocess in a secure sandbox, communicating directly with the Prismic API over HTTPS without third-party middleman servers.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript