이카운트 실시간 조회 MCP 서버 — 배포 가이드

이 프로그램을 인터넷에 올리면(배포하면), 클로드 채팅창에서 "오딘 나비수인 재고 몇 개야?", "세광 미소가구 전화번호 알려줘" 라고 물어볼 수 있게 됩니다.

컴퓨터 코딩 몰라도 아래 순서대로 클릭만 하면 됩니다. 막히는 부분 있으면 그 화면 캡처해서 저한테 보여주세요.

1단계. GitHub에 코드 올리기 (코드 보관함 만들기)

1. https://github.com 접속 → 계정 없으면 회원가입 (무료)

2. 오른쪽 위 + 버튼 → New repository 클릭

3. Repository name: ecount-mcp 입력 → Create repository 클릭

4. 만들어진 빈 저장소 화면에서 uploading an existing file 링크 클릭

5. 제가 드린 zip 파일의 압축을 풀어서, 안에 있는 파일들을 전부 그 화면에 드래그 앤 드롭으로 끌어다 놓기 (server.js, ecount.js, package.json, .env.example 등)

6. 아래 Commit changes 초록 버튼 클릭

⚠️ .env 파일(실제 비밀번호 넣은 파일)은 절대 GitHub에 올리지 마세요. 비밀번호는 3단계에서 Render 사이트에만 입력합니다.

Related MCP server: DART-MCP

2단계. Render에서 서버 실행하기 (무료)

1. https://render.com 접속 → Get Started → GitHub 계정으로 가입/로그인

2. 대시보드에서 New + → Web Service 클릭

3. 방금 만든 ecount-mcp 저장소 선택 → Connect

4. 설정 화면에서:

   • Name: ecount-mcp (아무 이름이나 가능)

   • Region: Singapore (한국과 제일 가까움)

   • Build Command: npm install

   • Start Command: npm start

   • Instance Type: Free

5. 아래로 스크롤 → Environment Variables 섹션에서 Add Environment Variable 을 눌러서 아래 항목들을 하나씩 입력 (.env.example 파일 참고, 실제 비밀번호/인증키로):

   Key	Value
   ODIN_COM_CODE	53258
   ODIN_USER_ID	(이카운트 아이디)
   ODIN_API_CERT_KEY	(오딘 인증키)
   ODIN_ZONE	CB
   SEGWANG_COM_CODE	69073
   SEGWANG_USER_ID	(이카운트 아이디)
   SEGWANG_API_CERT_KEY	(세광 인증키)
   SEGWANG_ZONE	(모르면 비워두기)
   ECOUNT_USE_PRODUCTION	false

6. Create Web Service 클릭 → 3~5분 기다리면 배포 완료

7. 화면 상단에 https://ecount-mcp-xxxx.onrender.com 같은 주소가 생김 → 이 주소를 복사해두기

무료 요금제는 15분간 요청이 없으면 서버가 잠들어서, 첫 질문 응답이 20~30초 걸릴 수 있습니다. (두 번째 질문부터는 빠릅니다)

3단계. 클로드에 연결하기

1. 클로드(claude.ai) 접속 → 왼쪽 아래 프로필 → 설정(Settings) → 커넥터(Connectors)

2. 커스텀 커넥터 추가 또는 Add custom connector 클릭

3. 이름: 이카운트

4. URL: 2단계에서 복사한 주소 뒤에 /mcp 붙여서 입력 예) https://ecount-mcp-xxxx.onrender.com/mcp

5. 저장 → 새 대화창에서 커넥터 켜기(토글 ON)

4단계. 테스트

새 대화에서:

• "오딘 나비수인 재고 조회해줘"

• "세광 미소가구 전화번호 알려줘"

에러가 나면 화면을 캡처해서 저한테 보내주세요. 이카운트 API 문서의 정확한 필드명은 아직 검증 전이라, 실제 응답을 보고 코드를 맞춰 고쳐야 할 가능성이 높습니다 (특히 거래처 조회 부분).

이카운트 호출 제한·IP 차단 방지 (ecountLimits.js)

이카운트 오픈 API는 호출 횟수 제한이 있고, 로그인 실패가 10회 쌓이면 그 IP가 ERP 로그인까지 차단됩니다(매뉴얼 2-5 / 2-6). 모든 호출은 ecountLimits.js를 거쳐 나가며 아래 규칙이 강제됩니다.

• 로그인 전에 회사코드·사용자ID·인증키를 먼저 검증해, 틀린 값으로 이카운트를 두드리지 않습니다.

• 로그인이 3회 연속 실패하면 자동으로 중단하고(이카운트 차단 기준 10회보다 앞서서) 서버 로그와 ALERT_WEBHOOK_URL로 알립니다. 원인을 고친 뒤 ecount_api_status 도구의 reset_login_lock으로 해제합니다.

• ecount_api_status 도구로 현재 제한 현황·캐시 시각·자동 중단 여부를 확인할 수 있습니다.

• 시험: npm test (이카운트에 접속하지 않는 오프라인 시험 12건).