Skip to main content
Start with ERD
Products -> ERDPricingDocsBlogSign in한국어Start with ERD

Windsurf

Connect Windsurf (Codeium's AI editor) to AI-ERD via MCP.

Add the AI-ERD MCP server​

Windsurf reads MCP server configuration from ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "ai-erd": {
      "serverUrl": "https://ai-erd.com/mcp"
    }
  }
}

Restart Windsurf. The first AI-ERD tool call opens the OAuth page.

Windsurf's MCP support is evolving — consult the Windsurf MCP docs for the current configuration schema if the format above doesn't apply.

Try it​

In Windsurf's Cascade chat:

List my AI-ERD ERD documents using the ai-erd MCP server.
Add a comments table to ERD document <uuid> with columns id, post_id (FK to posts), author_id (FK to users), body (text), created_at. Description "Add comment system".

Tips​

  • Reference the server name explicitly in prompts when Windsurf has multiple MCP servers configured.
  • Use UUIDs for ERD documents in scripted or automated prompts.
  • Combine with Cascade flows — let Windsurf read the schema, generate model code, then write migrations all in one flow.

Troubleshooting​

Windsurf doesn't show AI-ERD tools Verify the MCP config file location and JSON syntax; restart Windsurf.

Authorization doesn't open Copy the URL from the Windsurf log and open it in your browser manually.

Permission errors MCP is a paid plan feature. Confirm your subscription is active and you have view/edit access to the target document.