Signup & Setup

This guide walks you through creating your BlokMCP account and connecting your first Storyblok space.

Step 1: Create Your BlokMCP Account

1. Visit blokmcp.com
2. Click Get Started or Sign Up
3. Sign up using:
   • Email & Password (recommended)
   • GitHub (OAuth)
   • Google (OAuth)
4. Check your email for a confirmation link (if using email signup)
5. Click the confirmation link to activate your account

Step 2: Access the Dashboard

After signing up and confirming your email:

1. Log in at blokmcp.com/dashboard
2. You'll see your organization dashboard (automatically created during signup)

The dashboard shows:

• Overview - Usage statistics and quick links
• Spaces - Your connected Storyblok spaces
• API Keys - MCP client authentication
• Billing - Subscription management
• Settings - Account and organization settings

Step 3: Connect Your First Storyblok Space

From the dashboard:

1. Navigate to Spaces in the sidebar
2. Click Add Storyblok Space
3. Fill in the space connection form:

Space Connection Details

Where to Find Your Space ID

1. Log in to Storyblok
2. Go to your space settings
3. Look in the URL: https://app.storyblok.com/#!/me/spaces/123456/dashboard
   • The number 123456 is your space ID

About Tokens

Management Token (Required):

• Allows BlokMCP to create, update, delete, and publish content
• Created in: Space Settings → Access Tokens → Management Tokens
• Should have appropriate permissions for what you want Claude to do

Public Token (Optional):

• Used for reading published content
• Created in: Space Settings → Access Tokens → Public Tokens
• Only needed if you want Claude to read preview/draft content

Security Note: Your tokens are encrypted at rest using industry-standard authenticated encryption. BlokMCP never stores tokens in plain text.

4. Click Add Space

You should see a success message and your space will appear in the spaces list.

Step 4: Create an API Key for Your MCP Client

Now you need an API key to authenticate your MCP client (Claude Desktop, Cursor, etc.):

1. Navigate to API Keys in the dashboard sidebar
2. Click Create API Key
3. Fill in the details:

4. Click Create Key
5. Important: Copy the API key immediately - you won't be able to see it again!

The key format is: sb_mcp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Security Tip: Create separate API keys for different clients or team members. This makes it easier to track usage and revoke access if needed.

Step 5: Test Your Setup

Before configuring your MCP client, verify your setup in the dashboard:

1. Go to Spaces
2. Click on your space name
3. Verify the connection details are correct
4. Check that your default space is marked (if you have multiple spaces)

What's Next?

Now that your BlokMCP account is set up and your space is connected, configure your MCP client:

Choose Your Client

• Claude Desktop Configuration → (Recommended for most users)
• Cursor IDE Configuration → (For developers)

Troubleshooting

"Invalid Space ID" Error

• Double-check the space ID from your Storyblok URL
• Make sure it's numeric only (no letters or special characters)

"Invalid Token" Error

• Verify the management token is correct (copy/paste to avoid typos)
• Check that the token hasn't been deleted or revoked in Storyblok
• Ensure the token has sufficient permissions

Can't Find My Space ID

1. Log in to Storyblok
2. Open your space
3. Look at the browser URL bar
4. Find the number after /spaces/ in the URL

Token Permissions Issues

If Claude can't perform certain operations:

1. Go to Storyblok → Space Settings → Access Tokens → Management Tokens
2. Find your BlokMCP token
3. Edit the permissions to include the operations you need
4. Update the token in your BlokMCP dashboard (Spaces → Edit Space)

Related Resources

• Multi-Space Setup - Managing multiple Storyblok spaces
• API Keys Management - Advanced API key configuration
• Security Best Practices - Token rotation and security