Claude Desktop Configuration

This guide shows you how to connect BlokMCP to Claude Desktop - the easiest way to start managing your Storyblok content through conversation.

Overview

Claude Desktop is a free desktop application from Anthropic that supports the Model Context Protocol (MCP). By adding BlokMCP as an MCP server, you give Claude the ability to manage your Storyblok content.

What you'll need:

Claude Desktop installed (download here)
Your BlokMCP API key (from dashboard)
A text editor (Notepad, TextEdit, VS Code, etc.)

Step 1: Locate the Configuration File

The Claude Desktop configuration file location varies by operating system:

macOS

~/Library/Application Support/Claude/claude_desktop_config.json

How to get there:

Open Finder
Click Go in the menu bar → Go to Folder... (or press Cmd + Shift + G)
Paste: ~/Library/Application Support/Claude/
Find or create the file claude_desktop_config.json

Windows

%APPDATA%\Claude\claude_desktop_config.json

How to get there:

Open File Explorer
In the address bar, type %APPDATA%\Claude\
Find or create the file claude_desktop_config.json

Linux

~/.config/Claude/claude_desktop_config.json

How to get there:

Open your file manager
Navigate to your home directory
Show hidden files (usually Ctrl + H)
Navigate to .config/Claude/
Find or create the file claude_desktop_config.json

Note: If the file doesn't exist, create it. If the Claude directory doesn't exist, create that too.

Step 2: Edit the Configuration File

Open claude_desktop_config.json in your text editor.

If the file is empty or doesn't exist:

Copy and paste this entire configuration:

{
  "mcpServers": {
    "storyblok": {
      "url": "https://mcp.blokmcp.com",
      "headers": {
        "X-Api-Key": "sb_mcp_your_api_key_here"
      }
    }
  }
}

Important: Replace sb_mcp_your_api_key_here with your actual API key from the BlokMCP dashboard.

If the file already has MCP servers configured:

Add the BlokMCP configuration to your existing mcpServers object:

{
  "mcpServers": {
    "existing-server": {
      "url": "https://existing-server.com"
    },
    "storyblok": {
      "url": "https://mcp.blokmcp.com",
      "headers": {
        "X-Api-Key": "sb_mcp_your_api_key_here"
      }
    }
  }
}

Again, replace sb_mcp_your_api_key_here with your actual API key.

Step 3: Save and Restart Claude Desktop

Save the configuration file
Quit Claude Desktop completely
- macOS: Cmd + Q or Claude → Quit Claude
- Windows: File → Exit or close all windows
- Linux: File → Quit
Restart Claude Desktop

Step 4: Verify the Connection

After restarting Claude Desktop, verify that BlokMCP is connected:

Look for the hammer/tool icon 🔨 in the text input area
Click the icon to see available tools
You should see BlokMCP tools like:
- fetch_stories
- get_story
- fetch_components
- fetch_assets
- etc.

If you see these tools, congratulations! BlokMCP is successfully connected.

Step 5: Test Your Setup

Try a simple conversation to test the connection:

Show me my Storyblok space information

Or:

List my recent stories

Claude should respond with information from your Storyblok space.

Advanced Configuration

Multiple Storyblok Spaces

If you have multiple Storyblok spaces connected in your BlokMCP dashboard, you can specify which space to use:

{
  "mcpServers": {
    "storyblok": {
      "url": "https://mcp.blokmcp.com",
      "headers": {
        "X-Api-Key": "sb_mcp_your_api_key_here",
        "X-Storyblok-Space-Id": "123456"
      }
    }
  }
}

When to use this:

You have multiple spaces connected in BlokMCP
You want to always use a specific space (not the default)
You want to create separate Claude Desktop profiles for different spaces

How to find your Space ID:

BlokMCP Dashboard → Spaces → Click on your space
Or from your Storyblok URL: https://app.storyblok.com/#!/me/spaces/123456/...

If you don't specify a space ID, BlokMCP will use:

Your default space (if set in the dashboard)
Your only space (if you only have one)
Ask you to specify which space to use

Alternative: Space Alias

You can also use the space alias instead of the numeric ID:

{
  "mcpServers": {
    "storyblok": {
      "url": "https://mcp.blokmcp.com",
      "headers": {
        "X-Api-Key": "sb_mcp_your_api_key_here",
        "X-Storyblok-Space-Alias": "my-production-blog"
      }
    }
  }
}