IDAX MCP 게이트웨이

Claude Code 연결 가이드

IDAX 의 문제정의 · 에이전트 스튜디오 · 에이전트 허브 · 해커톤 기능을 Claude Code 에서 도구로 씁니다. 로그인한 본인의 권한 범위 안에서만 동작합니다.

서버 주소 https://dev-mcp.idax.ildong.com/api/mcp

준비물

등록 명령 실행
터미널(PowerShell · bash)에 한 번 붙여 넣고 실행합니다. 모든 폴더에서 쓸 수 있게 사용자 범위로 등록됩니다.
claude mcp add --transport http -s user --client-id 8e9BveC3zedUe1ojNUWd5WcgdlI3zDMhSKyIJfW6 --callback-port 8199 idax-mcp https://dev-mcp.idax.ildong.com/api/mcp
예전에 secret 으로 등록해 둔 idax-mcp 이 있으면 먼저 지운 뒤 다시 등록합니다.
claude mcp remove idax-mcp -s user
Claude Code 새로 시작
등록은 새로 시작한 세션부터 반영됩니다. 켜 둔 Claude Code 를 모두 닫고 다시 엽니다.
/mcp 에서 Authenticate
입력창에 /mcp 를 입력하고 목록에서 idax-mcp 을 고른 뒤 Authenticate 를 누릅니다.
EPS 로그인
브라우저가 열리면 사내 계정으로 로그인합니다. 완료 화면이 뜨면 브라우저를 닫고 Claude Code 로 돌아갑니다.
연결 확인
/mcp 목록에서 idax-mcp 이 connected 로 보이면 연결된 것입니다. 채팅에 아래처럼 물어 본인 정보가 나오는지 봅니다.
IDAX 에서 내 프로필 보여줘

등록한 뒤 로그인 명령으로 브라우저를 엽니다. EPS 로그인을 마치면 바로 쓸 수 있습니다.

codex mcp add idax-mcp --url https://dev-mcp.idax.ildong.com/api/mcp --oauth-client-id 8e9BveC3zedUe1ojNUWd5WcgdlI3zDMhSKyIJfW6

codex mcp login idax-mcp

Grok Build 는 Claude Code 의 사용자 설정을 함께 읽습니다. 위 1번 명령으로 Claude Code 에 등록해 두면 같은 설정으로 붙습니다. Grok Build 에서 로그인을 요청하면 브라우저에서 EPS 로그인을 합니다.

grok.com · ChatGPT 웹처럼 클라우드에서 도는 커넥터는 연결할 수 없습니다. 로그인 결과가 이 PC 가 아니라 외부 서버로 가기 때문에 허용하지 않습니다.

증상	원인과 조치
로그인 뒤 8199 포트 사용 중 오류	다른 Claude Code 창이 인증을 기다리며 포트를 잡고 있습니다. 그 창을 닫거나 인증을 마친 뒤 다시 시도합니다.
등록했는데 /mcp 에 안 보임, 지웠는데 계속 보임	세션이 시작할 때 읽은 목록을 계속 씁니다. Claude Code 를 모두 닫고 새로 엽니다.
채팅 안에서 인증하라는 도구로 로그인 실패	채팅 안의 인증 도구로는 로그인 결과를 받지 못합니다. 반드시 `/mcp` 메뉴의 Authenticate 로 로그인합니다.
한동안 쓰다가 다시 인증하라고 나옴	로그인이 만료된 것입니다. `/mcp` 에서 Authenticate 를 한 번 더 누릅니다.
아래 목록의 도구가 일부만 보임	본인 권한으로 쓸 수 있는 것만 보입니다. 권한이 필요하면 해당 앱 담당자에게 요청합니다.

데이터를 바꾸는 도구는 변경 표시가 있고, 실행 전에 Claude Code 가 확인을 묻습니다. 에이전트 스튜디오에서 만든 도구도 권한에 따라 함께 올라옵니다.