ERD Makers MCP

IDE에서 스키마를 읽고 ERD Makers 다이어그램을 갱신하세요.

ERD Makers MCP는 Claude Code, Codex 같은 MCP 클라이언트가 Prisma 또는 SQL 스키마 파일을 분석하고, 변경 내용을 미리 본 뒤 ERD Makers 다이어그램에 적용할 수 있게 해주는 npm 기반 stdio MCP 서버입니다.

지원 흐름

다이어그램별 키

소유자가 발급한 키로 MCP가 접근할 ERD를 정확히 지정합니다.

미리보기 후 적용

스키마 변경 diff와 proposedContent를 확인한 뒤 쓰기 도구를 호출합니다.

연동키 기반 쓰기

키 발급자에게 해당 다이어그램 편집 권한이 남아 있을 때만 적용됩니다.

준비

다이어그램별 API 키를 준비합니다.

API 키는 수정할 ERD와 키 발급자를 함께 식별합니다. 키 원문은 발급 직후 한 번만 표시되므로 MCP 설정에 바로 저장해야 합니다.

1
ERD Makers에 로그인하고 다이어그램을 저장합니다
새 다이어그램은 먼저 저장되어야 MCP 연동 키를 만들 수 있습니다. 소유자 권한이 있는 다이어그램을 사용하세요.
2
아바타 메뉴에서 MCP 설정을 엽니다
우측 상단 아바타 메뉴의 MCP 설정에서 연동할 다이어그램을 선택하고 키 이름을 입력합니다.
3
API 키를 발급하고 즉시 보관합니다
키 원문은 발급 직후 한 번만 표시됩니다. MCP 설정의 ERD_MAKERS_API_KEY 값으로 사용합니다.
4
MCP 클라이언트에 npx 실행 설정을 추가합니다
command는 npx, args는 -y erd-makers-mcp로 두고 ERD_MAKERS_BASE_URL과 ERD_MAKERS_API_KEY를 환경 변수로 넣습니다.

클라이언트 설정

npx 명령을 MCP 클라이언트에 등록합니다.

별도 서버를 계속 켜둘 필요 없이 클라이언트가 필요한 시점에 npm 패키지를 실행합니다. 발급받은 API 키는 환경 변수로 전달합니다.

공통 MCP 설정 예시

Claude Code나 Codex의 MCP 설정에 아래 command, args, env 값을 등록합니다.

{
  "mcpServers": {
    "erd-makers": {
      "command": "npx",
      "args": ["-y", "erd-makers-mcp"],
      "env": {
        "ERD_MAKERS_BASE_URL": "https://erdmakers.kr",
        "ERD_MAKERS_API_KEY": "erd_dk_..."
      }
    }
  }
}

로컬에서 바로 실행해보기

패키지가 공개된 뒤에는 저장소를 내려받지 않고 npx로 바로 실행할 수 있습니다.

ERD_MAKERS_BASE_URL=https://erdmakers.kr ERD_MAKERS_API_KEY=erd_dk_... npx -y erd-makers-mcp

개발 앱에 연결

로컬 Next.js 앱을 대상으로 테스트할 때만 base URL을 localhost로 바꿉니다.

ERD_MAKERS_BASE_URL=http://localhost:3214 ERD_MAKERS_API_KEY=erd_dk_... npm run dev

여러 키를 분리해서 쓰는 경우

기본값은 API 키를 diagramKey로도 사용합니다. 별도 diagramKey 입력을 기본으로 두고 싶을 때만 추가합니다.

ERD_MAKERS_API_KEY=erd_dk_...
ERD_MAKERS_DIAGRAM_KEY=erd_dk_...

도구

먼저 분석하고, 검토한 결과만 적용합니다.

쓰기 작업은 `analyze_schema_changes`가 반환한 baseVersion과 proposedContent를 검토한 뒤 `apply_schema_changes`로 적용하는 흐름을 기준으로 합니다.

resolve_diagram

diagramKey가 가리키는 다이어그램 제목, 버전, 권한, 테이블 수를 확인합니다.

analyze_schema_changes

Prisma 또는 PostgreSQL 스키마 파일을 읽고 ERD에 반영될 변경 diff와 proposedContent를 반환합니다.

apply_schema_changes

검토한 proposedContent를 baseVersion과 함께 적용합니다. 버전이 달라지면 충돌로 거절됩니다.

export_diagram_sql

현재 ERD Makers 다이어그램을 PostgreSQL DDL 초안으로 내보냅니다.

운영 팁

충돌과 키 관리를 명확히 처리합니다.

키 원문을 잃어버린 경우

기존 키는 다시 볼 수 없습니다. MCP 설정에서 해당 키를 회수하고 새 키를 발급하세요.

409 충돌이 발생한 경우

다른 변경이 먼저 반영된 상태입니다. resolve 또는 analyze를 다시 실행해 최신 baseVersion으로 재검토하세요.

401 인증 오류가 발생하는 경우

ERD_MAKERS_API_KEY가 발급 직후 복사한 원문과 일치하는지, ERD_MAKERS_BASE_URL이 실제 앱 주소와 일치하는지 확인하세요.

404로 다이어그램을 찾지 못하는 경우

diagramKey가 복사 중 잘렸거나 회수된 키일 수 있습니다. 아바타 메뉴의 MCP 설정에서 키 상태를 확인하세요.