Windsurf

Windsurf(Codeium AI editor)를 MCP로 AI-ERD에 연결합니다.

---

AI-ERD MCP 서버 추가

Windsurf의 MCP 설정에 AI-ERD HTTP server를 추가합니다.

{
  "mcpServers": {
    "ai-erd": {
      "type": "http",
      "url": "https://ai-erd.com/mcp"
    }
  }
}

Windsurf를 재시작한 뒤 첫 tool call에서 OAuth flow를 승인합니다.

MCP 설정 파일 위치와 UI는 Windsurf 버전에 따라 다를 수 있습니다. 현재 제품 문서를 확인하세요.

---

사용해 보기

List my AI-ERD ERD documents.

Use ERD document <uuid>. Show me the tables related to billing and their foreign keys.

In ERD document <uuid>, create a refund_requests table and link it to orders. Use description "Add refund request workflow".

---

팁

• Windsurf가 코드베이스만 보고 추측하지 않도록 "read from AI-ERD via MCP"라고 명시하세요.
• ERD document UUID를 대화 초반에 알려 주세요.
• 스키마 변경 후 생성된 version snapshot을 AI-ERD에서 확인하세요.

---

문제 해결

Tool이 보이지 않음
MCP 설정 위치, JSON syntax, editor restart 여부를 확인하세요.

인증이 반복됨
AI-ERD 로그인 상태와 브라우저 cookie를 확인하고, 필요하면 connected app token을 revoke한 뒤 다시 연결하세요.

권한 오류
대상 document에 대한 EDITOR 이상 권한이 필요합니다.