Claude Code

Claude Code(Anthropic의 terminal coding agent)를 MCP로 Ainecto에 연결합니다.

---

Ainecto MCP 서버 추가

claude mcp add 명령으로 Ainecto를 등록합니다.

claude mcp add ainecto https://ainecto.com/mcp \
    --transport http

첫 tool call 시 Claude Code가 OAuth 요구사항을 감지하고 authorization 절차를 안내합니다.

1. 브라우저 창이 Ainecto authorization page로 열립니다.
2. 로그인하거나 기존 세션을 사용합니다.
3. consent screen을 승인합니다.
4. Claude Code가 token을 받아 local session에 저장합니다.

연결 확인:

claude mcp list

---

사용해 보기

Claude Code 세션에서:

List my Ainecto ERD documents.

Claude Code가 mcp__ainecto__list_documents를 type=erd로 호출하고 결과를 출력합니다.

Open ERD document <uuid> and show me the users table.

Claude Code는 mcp__ainecto__erd_list_tables와 mcp__ainecto__erd_get_table을 호출해 스키마를 보여줍니다.

---

설정 파일

수동 설정을 선호한다면 MCP config에 같은 서버를 추가할 수 있습니다.

{
  "mcpServers": {
    "ainecto": {
      "type": "http",
      "url": "https://ainecto.com/mcp"
    }
  }
}

현재 설정 파일 위치와 schema는 Claude Code MCP docs를 확인하세요.

---

Scope와 권한

Ainecto가 발급한 token은 사용자 계정 범위로 동작합니다. Claude Code는 사용자가 볼 수 있거나 편집할 수 있는 document만 접근합니다.

• OWNER / EDITOR — 읽기 + 쓰기 가능
• VIEWER — 읽기 전용(write tool call은 permission error)

토큰은 Ainecto 계정 설정 → Connected apps에서 언제든 revoke할 수 있습니다.

---

문제 해결

인증 중 브라우저가 열리지 않음
터미널에 표시된 authorization URL을 복사해 직접 여세요.

"plan does not include MCP"
MCP는 유료 요금제가 필요합니다. 계정 설정에서 업그레이드하거나 요금제를 참고하세요.

Tool call이 401을 반환함
토큰이 만료되었습니다. 아무 tool call이나 다시 실행하면 Claude Code가 refresh를 시도합니다. 필요하면 서버를 제거 후 다시 추가하세요.