본문으로 건너뛰기
ERD 시작하기
제품 -> ERD가격문서블로그로그인EnglishERD 시작하기

MCP 연동

**Model Context Protocol(MCP)**은 AI 코딩 도구가 구조화된 tool로 외부 서비스를 호출하게 해 주는 공개 표준입니다. AI-ERD는 workspace, document, ERD, diagram, Markdown API를 MCP tool로 노출하므로(Tool Reference 참고) AI 어시스턴트가 추측 대신 실제 project data를 기준으로 작업할 수 있습니다.

하나의 MCP 연동으로 여러 AI 클라이언트에서 사용할 수 있습니다. 도구별 plugin을 따로 만들 필요가 없습니다.

MCP를 쓰는 이유​

MCP가 없으면 AI 코딩 어시스턴트는 실제 스키마를 모릅니다. 매번 DDL을 붙여 넣거나, 컬럼명과 타입을 추측하게 두어야 합니다.

AI-ERD와 MCP를 함께 쓰면 어시스턴트가 다음을 수행할 수 있습니다.

  • workspace 또는 project의 ERD, diagram, Markdown, OpenAPI document 목록 조회
  • ERD table, column, index, relationship, enum, group 읽기
  • 새 테이블, 컬럼, ref, enum, group 생성
  • 기존 구조 수정(컬럼 추가/이름 변경/삭제, FK 변경 등)
  • Markdown document 생성/append
  • 모든 document 변경에 대한 version history 스냅샷 생성

모든 write는 설명이 붙고 사용자 계정에 귀속되며, 사람이 편집한 것과 같은 audit log에 기록됩니다.

Endpoint​

POST https://ai-erd.com/mcp
  • Protocol: HTTP 위의 JSON-RPC 2.0(Streamable HTTP transport)
  • Auth: OAuth 2.0 with PKCE(MCP 클라이언트가 flow 처리)
  • Session: Mcp-Session-Id header(initialize 시 자동 발급)
  • Discovery: GET https://ai-erd.com/.well-known/oauth-authorization-server 와 GET https://ai-erd.com/.well-known/oauth-protected-resource/mcp

보통 이 endpoint를 직접 호출하지는 않습니다. Claude Code, Cursor 같은 MCP 클라이언트가 대신 프로토콜을 처리합니다.

인증​

AI-ERD는 MCP 클라이언트를 위한 OAuth 2.0 authorization server로 동작합니다.

  1. MCP 클라이언트가 사용자를 AI-ERD authorization page로 redirect합니다.
  2. 사용자는 로그인하거나 기존 세션을 사용하고 consent를 승인합니다.
  3. AI-ERD가 클라이언트에 access token을 발급합니다.
  4. 클라이언트는 모든 MCP call에서 Authorization: Bearer {token} header를 사용합니다.

토큰은 사용자 계정을 대표합니다. MCP를 통한 모든 동작은 사용자 권한을 따르며, 각 project와 document 권한도 동일하게 적용됩니다.

MCP 는 Free 를 포함한 모든 요금제에서 동작합니다. 요금제에 따라 달라지는 것은 월 AI 크레딧과 문서·워크스페이스 한도입니다 — 요금제 를 보세요.

지원 클라이언트​

AI-ERD는 다음 클라이언트를 기준으로 테스트 또는 설계되었습니다.

MCP를 지원하는 다른 도구도 같은 프로토콜로 연결할 수 있습니다. 차이는 클라이언트별 설정 형식뿐입니다.

연결 후 해볼 수 있는 일​

AI 클라이언트에서 다음처럼 요청해 보세요.

List all my AI-ERD ERD documents.
Show me the columns of the users table in ERD document <uuid>.
Add a soft_delete_at timestamp column to all tables in ERD document <uuid>.
Use a description "Add soft delete support".
Create a new table called notifications in ERD document <uuid>:
- id (bigint, PK, auto-increment)
- user_id (bigint, FK to users.id)
- message (text, not null)
- read_at (timestamp, nullable)
- created_at (timestamp, default now)

Then create a foreign key from notifications.user_id to users.id with on_delete=cascade.

어시스턴트가 이를 mcp__ai-erd__list_documents, mcp__ai-erd__erd_get_table, mcp__ai-erd__erd_apply_changes 같은 tool call로 변환합니다. AI-ERD가 변경을 적용하고 version snapshot을 자동 생성합니다.

다음 단계​