Cursor

Cursor를 MCP로 AI-ERD에 연결해 실제 project document를 읽고 수정하게 합니다.

---

AI-ERD MCP 서버 추가

Cursor의 MCP 설정에 AI-ERD server를 추가합니다. 일반적인 형태는 다음과 같습니다.

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

Cursor를 reload하거나 restart합니다. 첫 AI-ERD tool call에서 OAuth flow가 시작됩니다.

Cursor의 설정 UI와 파일 위치는 버전에 따라 바뀔 수 있습니다. 현재 버전의 MCP 설정 안내를 확인하세요.

---

저장소별 역할

저장소의 세션에 역할 하나를 주려면 그 저장소에서 ai-erd init 을 실행하세요. 저장소의 .cursor/mcp.json 에 --role 이 붙은 ai-erd 항목 하나를 씁니다. MCP 설정을 다시 불러오거나 창을 다시 열면 Cursor 가 읽습니다.

npx -y ai-erd@latest init                     # 사람이 터미널에서: 역할과 프로젝트를 물어봄
npx -y ai-erd@latest init --role <역할>        # 에이전트가, 사용자가 고른 역할로

---

사용해 보기

Cursor Chat에서:

List my AI-ERD ERD documents and summarize the tables in each one.

Use ERD document <uuid>. Before editing code, inspect the users and sessions tables from AI-ERD.

Cursor는 AI-ERD tool을 호출해 실제 schema context를 가져온 뒤 코드 작업에 반영합니다.

---

쓰기 요청

스키마를 바꾸는 요청에는 항상 명확한 설명을 포함하세요.

In ERD document <uuid>, add a nullable deleted_at timestamp to all user-owned tables.
Use description "Add soft delete columns".

MCP write는 AI-ERD에서 version snapshot을 생성하므로 나중에 비교하거나 복원할 수 있습니다.

---

팁

• 코드 변경 전에 "read the schema from AI-ERD first"라고 명시하면 Cursor가 추측 대신 tool call을 사용하기 쉽습니다.
• ERD document UUID를 prompt 상단에 고정해 두세요.
• 큰 스키마 변경은 Cursor가 제안한 뒤 AI-ERD에서 diff와 version history를 확인하는 흐름이 안전합니다.

---

문제 해결

AI-ERD tool이 보이지 않음
MCP 설정 JSON과 Cursor 재시작 여부를 확인하세요.

OAuth가 실패함
브라우저에서 AI-ERD 로그인 세션이 유효한지 확인하고 다시 tool call을 실행하세요.

Write가 거부됨
대상 document에서 OWNER 또는 EDITOR 권한이 필요합니다.