Codex
OpenAI의 Codex를 MCP로 Ainecto에 연결합니다.
Ainecto MCP 서버 추가
Codex는 ~/.codex/config.toml에서 MCP 서버 설정을 읽습니다.
[mcp_servers.ainecto]
url = "https://ainecto.com/mcp"
Codex를 재시작하세요. Ainecto에 대한 첫 tool call이 OAuth flow를 시작하며, 로그인 후 승인하면 됩니다.
Codex의 MCP 지원은 계속 바뀔 수 있습니다. 필요하면 Codex docs에서 현재 설정 형식을 확인하세요.
사용해 보기
Codex 세션에서:
List my Ainecto 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는 적절한 Ainecto MCP tool을 호출하고 description이 붙은 snapshot을 생성합니다.
팁
- ERD document를 명확히 지정하세요. UUID 또는 모호하지 않은 title을 넘겨 Codex가 추측하지 않게 합니다.
- description을 항상 포함하세요. 모든 write tool은 description이 필요하며, 좋은 설명은 version history를 읽기 쉽게 만듭니다.
- version history를 확인하세요. MCP write는 모두 복원 가능한 snapshot을 만듭니다.
문제 해결
Codex에 Ainecto tool이 보이지 않음
config 파일 위치와 TOML syntax를 다시 확인하세요. 설정 후 Codex 재시작이 필요합니다.
OAuth flow가 열리지 않음
터미널의 URL을 복사해 브라우저에서 직접 여세요.
Permission denied
Ainecto 계정이 대상 document를 편집할 수 있는지 확인하세요. MCP write tool은 웹 앱과 같은 역할 모델을 따릅니다. 개념 → 권한을 참고하세요.