Skip to main content
Integrate camelAI directly into Windsurf’s Cascade to access powerful data analysis capabilities without leaving your development environment. Query your databases, generate insights, and get SQL results all within your AI-powered code editor.
For the latest official guidance from Windsurf, refer to their Cascade MCP integration documentation: Cascade MCP integration.

​
Step 1: Create MCP Configuration

Create or edit the MCP configuration file at ~/.codeium/windsurf/mcp_config.json: 
mkdir -p ~/.codeium/windsurf
touch ~/.codeium/windsurf/mcp_config.json

​
Step 2: Configure the Server

Add the following configuration to your mcp_config.json file: 
{
  "mcpServers": {
    "camelai": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://app.camelai.com/mcp",
        "--header",
        "Authorization: Bearer ${API_KEY}"
      ],
      "env": {
        "API_KEY": "your_api_key_here"
      }
    }
  }
}
Replace your_api_key_here with your actual API key from app.camelai.com/api-keys.

​
Step 3: Refresh Plugins

After saving your configuration, press the refresh button in the Plugins section or restart Windsurf to load the new MCP server connection.

​
Managing Tools

Windsurf has a limit of 100 total tools available to Cascade at any given time. You can manage which camelAI tools are enabled:

​
Via Settings

Alternatively, go to Windsurf Settings > Cascade > Plugins and click the Manage plugins button to configure tool availability.

​
Using camelAI in Windsurf

Once configured, camelAI tools will be automatically available in Windsurf’s Cascade.

​
Tool Execution

Windsurf’s Cascade will automatically use camelAI tools when relevant to your queries. The AI will determine which tools to use based on the context of your conversation and requests.
Enterprise users may need to manually enable MCP integration via settings before using MCP servers.

​
Troubleshooting

​
Common Issues

Symptoms: camelAI tools don’t appear in Windsurf’s available toolsSolutions:
  • Verify your API key is correct
  • Check that mcp_config.json is in the correct location (~/.codeium/windsurf/)
  • Press the refresh button in the Plugins section
  • Restart Windsurf after configuration changes
  • Ensure you have internet connectivity
Symptoms: Tools appear but fail with authentication errorsSolutions:
  • Generate a new API key at app.camelai.com/api-keys
  • Verify the API key is correctly set in the env section
  • Check that your API key has the necessary permissions
Symptoms: Some camelAI tools are not availableSolutions:
  • Windsurf limits total tools to 100 across all MCP servers
  • Disable unused tools from other MCP plugins
  • Prioritize the most important camelAI tools for your workflow
Symptoms: Server fails to start with mcp-remote errorsSolutions:
  • Ensure Node.js and npm are installed
  • Run npm install -g mcp-remote to install the package globally
  • Check your network connection and firewall settings

​
Next Steps

Connect Data Sources

Set up your database connections in the camelAI web app

Learn More About MCP

Understand the full capabilities of camelAI’s MCP server
Having issues with the integration? Reach out to our support team or check our troubleshooting guide above.
⌘I