Boxzooka MCP 서버

Boxzooka bxz-api(Product, Inbound, Order, Inventory, Shipment, Return)를 MCP 서버로 래핑합니다. Materials Inventory 커넥터와 동일한 패턴입니다: 공유 서버 하나, 공유 자격 증명 한 쌍, 팀 전체가 동일한 URL에 연결합니다.

33개의 도구, 전체 읽기 + 쓰기 지원. EDI는 포함되지 않습니다 — XML 기반이며 Boxzooka는 이를 위해 IT 팀과 별도의 설정 논의가 필요합니다; 실제로 필요하면 말씀해 주시면 추가하겠습니다.

파일

• boxzooka_mcp.py — 서버

• requirements.txt — Python 의존성

• Dockerfile — 원격 호스팅용 컨테이너 빌드

Related MCP server: MoySklad MCP Server

1. 배포 (Materials Inventory와 별도 서비스)

이것은 Materials Inventory 커넥터와 별도의 배포입니다 — 각 서버는 자체 Railway/Render/Fly 서비스가 필요합니다.

1. 이 세 파일을 새 저장소(또는 기존 저장소의 폴더)에 푸시합니다.

2. Railway → New Project → Deploy from GitHub repo → 선택합니다.

3. Variables에 다음을 추가합니다:

   • BOXZOOKA_API_TOKEN = 샌드박스 토큰 (c44f966f5c7fc4cdb7d7f461ab4414c6)

   • BOXZOOKA_CUSTOMER_ID = 242

   • BOXZOOKA_API_BASE_URL = 프로덕션(실시간 창고 데이터)용 https://api.boxzooka.com. 생략하면 샌드박스 (https://sandbox.boxzooka.com)로 기본 설정되며, 이는 정적 테스트 데이터로 실시간 출하를 반영하지 않습니다 — 실제 수치를 보려면 프로덕션 URL을 설정하세요. 참고: 프로덕션은 샌드박스와 다른 토큰/고객 ID가 필요할 수 있습니다; 전환 후 호출이 401을 반환하면 Boxzooka에서 실사용 자격 증명을 받으세요.

4. Railway가 공개 URL을 제공합니다(예: https://boxzooka-production-xxxx.up.railway.app).

5. 팀에 제공할 커넥터 URL은 해당 URL 에 /mcp를 더한 것입니다: https://boxzooka-production-xxxx.up.railway.app/mcp

2. 팀 연결

Materials Inventory와 동일합니다: 각 팀원이 자신의 Claude 앱에서 위 URL을 가리키는 사용자 지정 커넥터로 추가합니다. 사용자별 설정은 필요 없습니다.

3. 보안 및 샌드박스 참고 사항

• 이 토큰/고객 쌍은 현재 Boxzooka의 샌드박스 환경을 가리킵니다(문서에 따르면: "테스트 및 디버그 목적"). 이를 통해 보는 데이터는 테스트 데이터이며 실제 창고가 아닙니다 — 여기의 주문과 재고는 Boxzooka 물리적 창고에서 실제로 일어나는 일을 반영하지 않습니다. 실사용 준비가 되면 Boxzooka에 연락하여 프로덕션 자격 증명을 받고 BOXZOOKA_API_TOKEN / BOXZOOKA_CUSTOMER_ID / BOXZOOKA_API_BASE_URL로 설정하세요.

• Materials Inventory와 동일한 액세스 수준 참고 사항: 이 커넥터는 주문 생성, 주문 취소, 반품 조정 등을 수행할 수 있습니다 — 전체 읽기/쓰기. 팀 외부에 URL을 공유하지 마세요.

4. 지원 범위

• Product: 생성, SKU로 조회, 업데이트, 전체 목록, 목록(페이지네이션)

• Inbound: 생성, PO 번호로 조회, 날짜 범위로 검색, 수령일별 조회(실시간), 업데이트, 수령일별 페이지네이션

• Order: 생성, 취소, 검색(order_id/order_key/external_id 기준), 업데이트, 날짜별 WMS 주문 로드

• Inventory: 전체 재고 목록, SKU로 조회, 오늘의 조정, 날짜별 조정, 날짜별 입고, 각각의 페이지네이션 변형

• Shipment: 주문 키로 조회, 날짜 범위로 조회, 날짜별 페이지네이션

• Return: 검색, 날짜별 검색, 생성, 업데이트, 취소

미지원: EDI(XML 기반, Boxzooka IT와 별도 논의 필요).