garmonia-crm-mcp

내부 API를 통해 CRM '가르모니아 호텔'을 테스트하기 위한 MCP 서버. 비밀번호로 로그인하고(세션 쿠키), 주문, 고객, 브랜드, 캘린더를 위한 도구와 그 외 모든 CRUD에 대한 범용 접근을 제공합니다.

빠른 설치 (한 줄 명령, 클로닝 없이)

Node 18+만 있으면 됩니다. 저장소를 설치하거나 클로닝할 필요 없이 — npx가 GitHub에서 직접 서버를 실행합니다.

1. 자격 증명이 담긴 로컬 파일을 만드세요, 예: ~/garmonia-crm.json:

   {
     "baseUrl": "https://адрес-crm",
     "login": "твой-логин",
     "password": "твой-пароль"
   }

2. 한 줄 명령으로 MCP를 추가하세요 (자신의 파일 경로를 넣으세요):

   claude mcp add garmonia-crm \
     -e CRM_CONFIG="$HOME/garmonia-crm.json" \
     -- npx -y github:AlekseiKastsiuk/garmonia-crm-mcp

3. Claude Code를 재시작하세요.

자격 증명은 로컬 파일에만 있으며 어디로도 전송되지 않습니다 — npx는 GitHub에서 서버 코드만 가져옵니다.

Related MCP server: MCP CRUD Tools

소스에서 설치 (대안)

git clone https://github.com/AlekseiKastsiuk/garmonia-crm-mcp
cd garmonia-crm-mcp
npm install
cp crm-config.example.json crm-config.json
# открой crm-config.json и впиши baseUrl, логин и пароль своей CRM

crm-config.json은 CRM 주소와 로그인/비밀번호이며, git에 커밋하지 마세요 (이미 .gitignore에 있습니다).

Claude Code에 연결

~/.claude.json에 (또는 claude mcp add를 통해) 서버를 추가하세요:

{
  "mcpServers": {
    "garmonia-crm": {
      "command": "node",
      "args": ["/полный/путь/к/garmonia-crm-mcp/server.mjs"]
    }
  }
}

구성 파일이 서버 옆에 없으면 — env에 경로를 지정하세요:

"env": { "CRM_CONFIG": "/полный/путь/к/crm-config.json" }

수정 후 — Claude Code를 재시작하세요.

도구

보안

• 비밀번호와 CRM 주소는 .gitignore에 있는 crm-config.json에 보관됩니다 — 저장소에 들어가지 않습니다.

• crm-config.example.json에는 실제 데이터 없이 플레이스홀더만 있습니다.

• 첫 푸시 전에 확인해야 합니다: git ls-files에 crm-config.json이 포함되지 않아야 하며, git grep -i password는 코드의 필드 이름만 반환해야 합니다.

참고 사항

• 주문은 공개 엔드포인트 POST /api/form-lead로 생성됩니다 — 인증이 필요 없습니다.

• 주문 삭제는 REST가 아니라 Next.js server action입니다 (닫힌 탭의 '삭제' 버튼과 동일). crm_order_delete가 이를 직접 호출합니다. action id는 프론트 빌드에 연결되어 있습니다. CRM 배포 후 삭제가 실패하면 — crm-config.json의 bulkDeleteActionId를 업데이트하세요 (JS 번들에서 bulkDelete로 검색).

• 상품/카테고리는 GET API가 아닌 서버 렌더링으로 리스팅을 제공합니다 — 생성/수정/삭제에는 crm_request (POST/PATCH/DELETE)를 사용하세요.