Codex
OpenAI의 Codex를 MCP로 AI-ERD에 연결합니다.
AI-ERD MCP 서버 추가
Codex CLI 로 AI-ERD 를 등록합니다.
codex mcp add ai-erd --url https://ai-erd.com/mcp
또는 ~/.codex/config.toml 에 직접 추가합니다.
[mcp_servers.ai-erd]
url = "https://ai-erd.com/mcp"
Codex를 재시작하세요. AI-ERD에 대한 첫 tool call이 OAuth flow를 시작하며, 로그인 후 승인하면 됩니다.
Codex의 MCP 지원은 계속 바뀔 수 있습니다. 필요하면 Codex docs에서 현재 설정 형식을 확인하세요.
저장소별 역할
Codex 는 전역 MCP 설정 하나만 쓰므로 ai-erd init 이 건드리지 않습니다. 대신 init 이
$CODEX_HOME/<역할>.config.toml 로 저장할 프로필을 출력하고, 세션을 codex -p <역할> 로
시작하면 그 역할로 동작합니다. CLI → 저장소 설정 을 참고하세요.
npx -y ai-erd@latest init # 사람이 터미널에서: 역할과 프로젝트를 물어봄
npx -y ai-erd@latest init --role <역할> # 에이전트가, 사용자가 고른 역할로
사용해 보기
Codex 세션에서:
List my AI-ERD ERD documents.
In ERD document <uuid>, add a posts table with columns: id (bigint pk auto), title (varchar 255 not null), body (text), author_id (bigint fk users.id), created_at (timestamp default now).
Codex는 적절한 AI-ERD MCP tool을 호출하고 description이 붙은 snapshot을 생성합니다.
팁
- ERD document를 명확히 지정하세요. UUID 또는 모호하지 않은 title을 넘겨 Codex가 추측하지 않게 합니다.
- description을 항상 포함하세요. 모든 write tool은 description이 필요하며, 좋은 설명은 version history를 읽기 쉽게 만듭니다.
- version history를 확인하세요. MCP write는 모두 복원 가능한 snapshot을 만듭니다.
문제 해결
Codex에 AI-ERD tool이 보이지 않음
config 파일 위치와 TOML syntax를 다시 확인하세요. 설정 후 Codex 재시작이 필요합니다.
OAuth flow가 열리지 않음
터미널의 URL을 복사해 브라우저에서 직접 여세요.
Permission denied
AI-ERD 계정이 대상 document를 편집할 수 있는지 확인하세요. MCP write tool은 웹 앱과 같은 역할 모델을 따릅니다. 개념 → 권한을 참고하세요.