Skip to main content

Claude Desktop Integration

Learn how to integrate Buildable with Claude Desktop using MCP.

Prerequisites​

  • Claude Desktop application installed
  • Active Buildable account
  • Node.js for running the MCP server

Configuration​

Step 1: Locate Claude Desktop Config​

Find your Claude Desktop configuration file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Step 2: Add Buildable MCP Server​

Edit the configuration file to include the Buildable MCP server:

{
  "mcpServers": {
    "buildable": {
      "command": "npx",
      "args": ["@buildable/mcp-server"],
      "env": {
        "BUILDABLE_API_KEY": "your-api-key-here",
        "BUILDABLE_PROJECT_ID": "your-project-id"
      }
    }
  }
}

Step 3: Restart Claude Desktop​

After saving the configuration, restart Claude Desktop to load the MCP integration.

Features​

Task Management​

Ask Claude about your Buildable tasks:

  • "Show me my current tasks"
  • "What's the status of task #123?"
  • "Mark task as completed"

Code Assistance​

Get help with your development work:

  • "Generate code for the authentication task"
  • "Review this code for the user dashboard"
  • "Suggest improvements for task #456"

Project Context​

Claude has access to your project context through MCP:

  • Current task priorities
  • Project structure and dependencies
  • Development best practices for your stack

Usage Examples​

Getting Task Information​

You: "What tasks do I have assigned?"
Claude: "You have 3 tasks assigned:
1. Implement user authentication (In Progress)
2. Create dashboard layout (Todo)
3. Set up CI/CD pipeline (Todo)"

Code Generation​

You: "Generate a React component for the user profile based on task #123"
Claude: "Based on your user profile task, here's a React component..."

Task Updates​

You: "I've completed the authentication implementation"
Claude: "Great! I've updated task #123 to completed status. Would you like me to create a preview deployment?"

Best Practices​

  1. Be specific: Reference task numbers or names for better context
  2. Regular updates: Keep Claude informed about your progress
  3. Use natural language: Claude understands conversational requests
  4. Review suggestions: Always review generated code before implementation

Troubleshooting​

Configuration Issues​

  • Verify the config file path is correct
  • Check JSON syntax is valid
  • Ensure API credentials are properly set

Connection Problems​

  • Restart Claude Desktop
  • Check your internet connection
  • Verify the MCP server is accessible

Getting Help​

  • Review the MCP Setup Guide
  • Check Claude Desktop documentation
  • Contact Buildable support for technical issues