Skip to main content

Cursor AI Integration

Connect Buildable to Cursor AI for intelligent code assistance directly in your editor. Get contextual help with your project tasks, code suggestions, and real-time updates.

Prerequisites​

  • Cursor AI installed (download here)
  • Active Buildable project with an API key
  • Node.js 18+ (for MCP client)

One-Click Setup​

The easiest way to integrate with Cursor is through our one-click installation:

Step 1: Generate API Key​

  1. Go to your project's Integrations page in Buildable
  2. Click "Generate New API Key"
  3. Copy the generated key (you'll need it for setup)

Step 2: One-Click Install​

Click the "Add to Cursor AI" button in your project's integrations page. This will:

  • Automatically install the Buildable MCP client
  • Configure all necessary environment variables
  • Add the integration to your Cursor settings

Step 3: Verify Installation​

  1. Open Cursor AI
  2. Open a chat session
  3. Type @buildable to see if the integration is active
  4. Try asking: "What tasks are pending in my project?"

Manual Setup​

If the one-click setup doesn't work, you can install manually:

Step 1: Install MCP Client​

npx -y @bldbl/mcp

Step 2: Configure Environment Variables​

Add these to your system environment or Cursor settings:

BUILDABLE_API_KEY=your_full_api_key_here
BUILDABLE_PROJECT_ID=your_project_id
BUILDABLE_API_URL=https://bldbl.dev/api
BUILDABLE_AI_ASSISTANT_ID=cursor-ide

Step 3: Update Cursor Configuration​

Add to your Cursor settings.json:

{
  "mcp": {
    "buildable": {
      "command": "npx",
      "args": ["-y", "@bldbl/mcp"],
      "env": {
        "BUILDABLE_API_KEY": "your_api_key",
        "BUILDABLE_PROJECT_ID": "your_project_id",
        "BUILDABLE_API_URL": "https://bldbl.dev/api",
        "BUILDABLE_AI_ASSISTANT_ID": "cursor-ide"
      }
    }
  }
}

Available Commands​

Once connected, you can use these commands in Cursor AI:

Project Information​

  • @buildable What is this project about?
  • @buildable Show me the project requirements
  • @buildable What's the technical architecture?

Task Management​

  • @buildable What tasks should I work on next?
  • @buildable Mark task [ID] as completed
  • @buildable Show me all pending tasks
  • @buildable Create a new task for [description]

Code Assistance​

  • @buildable Help me implement task [ID]
  • @buildable Review this code for task [ID]
  • @buildable What files should I modify for this task?

Discussions​

  • @buildable Start a discussion about [topic]
  • @buildable What are the latest project discussions?
  • @buildable Respond to discussion [ID]

Features​

Real-time Context​

  • Access to your complete project plan
  • Current task status and dependencies
  • Project discussions and decisions
  • Technical specifications and requirements

Intelligent Assistance​

  • Task-specific code suggestions
  • Architecture-aware recommendations
  • Progress tracking and updates
  • Automated task creation from conversations

Secure Access​

  • Project-scoped API keys
  • Read/write permissions control
  • Audit logging of all interactions
  • Rate limiting and usage monitoring

Troubleshooting​

Common Issues​

MCP client not found

# Reinstall the client
npm uninstall -g @bldbl/mcp
npx -y @bldbl/mcp

API key authentication failed

  • Verify your API key is correct and not expired
  • Check that the project ID matches your Buildable project
  • Ensure the API URL is set to https://bldbl.dev/api

Commands not working

  • Restart Cursor AI after configuration changes
  • Check that environment variables are properly set
  • Verify MCP client is properly installed

Connection timeout

  • Check your internet connection
  • Verify the API URL is accessible
  • Try regenerating your API key

Need Help?​

What's Next?​