Multi-Space Setup

Learn how to configure and work with multiple Storyblok spaces in BlokMCP.

Overview

BlokMCP supports managing multiple spaces:

Development, staging, and production environments
Multiple client projects
Regional content variations
Different brands or products

How Space Selection Works

Default Space

When you configure BlokMCP with a Storyblok token, the system:

Validates your API key
Loads your associated spaces
Uses your default space for operations

Specifying Space

For multi-space setups, specify which space to use:

# Using space ID in request header
X-Storyblok-Space-Id: 123456

# Or let Claude help
"Use space ID 123456 for this operation"

Configuration

Dashboard Setup

Log into https://blokmcp.com
Navigate to "Spaces" section
Add your Storyblok management token
Select which space(s) to enable
Set default space for API operations

Multiple Tokens

For different access levels:

Development token (limited permissions)
Production token (full permissions)
Client-specific tokens (per project)

Common Scenarios

Dev/Staging/Prod Workflow

Development work:
"Using dev space, create new component 'testimonial'"

Staging review:
"In staging space, publish all stories for review"

Production deployment:
"Copy approved stories from staging to production space"

Multi-Client Management

For Client A (space 111):
"Update all product pages"

For Client B (space 222):
"Publish blog posts from this week"

Regional Content

US space (space 333):
"Update pricing in USD"

EU space (space 444):
"Update pricing in EUR with VAT"

Best Practices

Clear naming - Use descriptive space names
Consistent structure - Mirror folder structures across spaces
Separate credentials - Use different tokens per environment
Document mappings - Track which space is which
Test in dev - Always test in development space first

Switching Between Spaces

In Conversation

"Show me all spaces I have access to"

"Switch to production space for the next operations"

"Which space am I currently using?"

Security Considerations

Principle of least privilege - Only grant necessary access
Token rotation - Regularly rotate management tokens
Audit logs - Review which operations happen in each space
Backup strategy - Backup production space regularly

Need help with multi-space setup? Ask Claude to help configure your spaces!