Connect VibeBase to Claude Desktop or Claude Web in 5 minutes

Add VibeBase to Claude

VibeBase works with Claude through MCP (Model Context Protocol). This guide will help you connect VibeBase to Claude Desktop or Claude Web.

Step 1: Get Your API Key

If you haven't already:

1. Go to your VibeBase Dashboard
2. Copy your API key (starts with vb_)
3. Keep it handy - you'll need it in Step 2

Step 2: Add to Claude

Option A: Claude Web

1. Go to Claude Settings → Connectors
2. Click "Add Connector"
3. Fill in the form:

4. Click "Save"
5. Click "Test Connection" to verify it works
6. If successful, you'll see "Connected successfully" ✅

Option B: Claude Desktop

1. Open Claude Desktop app
2. Go to Settings → Connectors
3. Click "Add Connector"
4. Enter the same information as Claude Web (above)
5. Click "Save" and "Test Connection"

Step 3: Test It!

In a new Claude conversation, try:

Show me all my VibeBase tables

Claude should respond using VibeBase tools! If you don't have any tables yet, try:

Create a contacts table with name, email, and phone columns

What You Can Do Now

With VibeBase connected, Claude can:

• 🗂️ Create tables - "Create a tasks table with title and completed columns"
• 📝 Add records - "Add a task: Buy groceries"
• 🔍 Query data - "Show me all incomplete tasks"
• ✏️ Update records - "Mark the first task as completed"
• 🗑️ Delete records - "Delete all completed tasks"
• 📊 Track usage - "What's my current VibeBase usage?"

Check out our Examples page for more ideas!

Configuration Reference

Quick copy-paste reference for setup:

Connector Name:    VibeBase
Server URL:        https://api.vibebase.app/api/mcp
Transport:         HTTP
Auth Type:         Header-based
Header Name:       x-api-key
Header Value:      vb_[your-api-key-from-dashboard]

Troubleshooting

❌ "API key is required"

Solution: Make sure you added the x-api-key header (lowercase, with hyphen) in the connector settings.

❌ "Invalid API key"

Solution:

• Verify your API key starts with vb_
• Check there are no extra spaces when pasting
• Copy the key again from your dashboard

❌ "Connection failed" or "Timeout"

Solution:

• Check the endpoint URL is correct (ends with /api/mcp)
• Verify your internet connection
• Try again in a few minutes

❌ Tools not appearing in Claude

Solution:

1. Remove and re-add the connector in Claude settings
2. Restart Claude Desktop (if using desktop app)
3. Make sure connection test passed
4. Verify you're on Claude Pro/Team/Enterprise

For more help, see our Troubleshooting Guide or email support@vibebase.app.

Next Steps

• 📚 Explore all 10 MCP tools
• 💡 Check out example use cases
• 📖 Review machine discovery at /api and /.well-known/agent.json
• 🚀 Start building with Claude + VibeBase!