GitHub
Copied to clipboard!

Vibe CMS Quick Start Guide

Time Required: 5 minutes For: Experienced developers who want to get up and running fast

🚀 Installation in 3 Steps

1. Get Credentials

From your Vibe CMS dashboard:

  • Copy your Project ID (Settings → Project)
  • Generate an API Token (Settings → API Keys)

2. Configure Claude

Edit project-root/.mcp.json (macOS/Linux) or project-root\.mcp.json (Windows):

{
  "mcpServers": {
    "vibe-cms-prod": {
      "command": "npx",
      "args": ["-y", "vibe-cms-mcp-server"],
      "env": {
        "VIBE_PROJECT_ID": "proj_your-project-id",
        "VIBE_API_TOKEN": "vibe_your-api-token"
      }
    }
  }
}

3. Restart Claude

Reload window in Claude Code.

✓ Verify Installation

Ask Claude:

"Show me all collections in my Vibe CMS project"

🎯 Common Tasks

Create a Collection

"Create a blog posts collection with title (text), content (markdown),
author (text), and featured_image (single_file) fields"

Add Content

"Create a new blog post in English with title 'Getting Started',
content 'Welcome to our blog...', and author 'John Doe'"

Upload Files

"Upload an image from [URL] to the /blog-images folder"

List Content

"Show me all blog posts"

Update Content

"Update the blog post with id [id] to change the title to 'New Title'"

🐛 Quick Troubleshooting

MCP server not found?

  • Check JSON syntax at jsonlint.com
  • Verify file location for your OS
  • Reload window in Claude Code

Authentication failed?

  • Verify Project ID and API Token
  • Check token hasn't expired
  • Ensure token has correct permissions

NPX command not found?

  • Install Node.js from nodejs.org
  • Verify: npx --version

📚 Learn More

Need help? Email: support@vibecms.com | Discord: https://discord.gg/vibecms