← Back to Home | 📚 Documentation
Dashboard →

Common issues and how to solve them

Troubleshooting Guide

Connection Issues

❌ "API key is required"

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

❌ "Invalid API key"

Solution:

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

❌ "User not found"

Solution: Make sure you've completed signup and your account is active. Check your dashboard at console.vibebase.app.

❌ Connection timeout

Solution:

  1. Check Cloudflare status at cloudflarestatus.com
  2. Verify the endpoint URL is correct
  3. Try again in a few minutes

Tool Errors

❌ "Table already exists"

Solution: Choose a different table name or delete the existing table first.

❌ "Table not found"

Solution: Check the table name spelling. Use list_tables to see all your tables.

❌ "Invalid column type"

Solution: Use only: TEXT, INTEGER, REAL, or BOOLEAN (case-insensitive).

❌ "Record not found"

Solution: Verify the record ID is correct. IDs are case-sensitive.

Claude Integration

Tools not appearing in Claude

Solution:

  1. Remove and re-add the connector in Claude settings
  2. Restart Claude Desktop (if using desktop)
  3. Verify you're using the correct endpoint: /api/mcp

Claude says "I can't access that tool"

Solution:

  • Make sure connection test passed when adding connector
  • Check your API key is still valid
  • Verify you're on Claude Pro/Team/Enterprise (required for MCP)

Performance Issues

Slow queries

Solution:

  • Use filters to reduce result set
  • Add pagination to large queries
  • Consider batch operations instead of multiple single operations

Rate limit errors

Solution:

  • Slow down your request rate
  • Use batch operations when possible
  • Contact support for higher limits

Security & WAF

Managed challenge or 403 on agent creation

Why: Identity endpoints are protected by rate limits and WAF rules to prevent abuse.

Solution:

  • Retry after a minute if you are creating many agents quickly.
  • If you need higher limits, contact support with your expected usage.

Data Issues

Data not saving

Solution:

  1. Check if the operation returned success
  2. Verify all required fields are provided
  3. Check data types match column definitions

Lost data

Solution:

  • Check if table was accidentally deleted
  • Verify you're querying the correct table
  • Contact support for data recovery assistance

Still Need Help?

If you can't solve your issue: