클로버 MCP(모델 컨텍스트 프로토콜) 서버

OAuth 인증을 사용하여 Clover API와 상호작용하기 위한 최소 MCP 서버입니다.

개요

이 MCP 서버를 사용하면 생성 AI 모델과 다른 클라이언트가 모델 컨텍스트 프로토콜을 사용하여 Clover 판매자 데이터에 액세스할 수 있습니다. 이 통합을 통해 모델은 다음을 수행할 수 있습니다.

• 판매자 정보 검색
• 재고 항목 목록
• 목록 주문
• 개별 항목 및 주문에 액세스

빠른 시작

Claude AI와 함께 사용(권장)

1. Claude MCP 설정(일반적으로 ~/.config/anthropic/claude.mcp.json )에 다음을 추가합니다.

지엑스피1

2. Claude와 함께 사용하세요:

3. Claude와의 대화에서 OAuth 흐름을 시작하세요.

명령줄을 통해 사용

MCP 서버를 직접 실행할 수 있습니다.

클로버 OAuth 설정

이 MCP 서버를 사용하기 전에 Clover 앱을 설정해야 합니다.

1. developer.clover.com 에서 Clover 개발자 계정을 만드세요
2. Clover 개발자 대시보드에 새 앱 등록
3. 앱을 다음과 같이 구성하세요.
   • 사이트 URL: http://localhost:4000/oauth-callback
   • 기본 OAuth 응답: Code
4. 클라이언트 ID와 클라이언트 비밀번호를 기록해 두세요.
5. 이러한 자격 증명을 환경 또는 .env 파일에 추가하세요.

MCP 도구

다음 도구는 MCP 프로토콜을 통해 사용할 수 있습니다.

• get_oauth_status : OAuth 자격 증명을 사용할 수 있는지 확인합니다.
• initiate_oauth_flow : 액세스 토큰을 얻기 위한 OAuth 흐름을 시작합니다.
• get_merchant_info : 판매자에 대한 정보를 가져옵니다.
• list_inventory : 선택적 필터를 사용하여 재고 항목을 나열합니다.
• list_orders : 선택적 필터를 사용하여 주문 목록 작성

Claude를 사용한 예시 사용

연결 후 Claude와 함께 사용할 수 있는 몇 가지 프롬프트 예는 다음과 같습니다.

1. 클로버에 연결 :
   I'd like to connect to my Clover account.
2. 판매자 정보 얻기 :
   What information do you have about my Clover merchant account?
3. 재고 품목 목록 :
   Show me the first 10 items in my inventory.
4. 목록 주문 :
   Can you list my most recent orders?

개발

로컬 설치

1. 이 저장소를 복제하세요
2. 종속성 설치:
   npm install
3. OAuth 자격 증명을 설정하세요.
   cp .env.example .env # Edit .env with your Clover OAuth credentials
4. TypeScript 코드를 작성합니다.
   npm run build
5. MCP 서버를 시작합니다.
   ./run.sh

업데이트 게시

npm에 새 버전을 게시하려면:

문제 해결

OAuth 문제가 발생하는 경우:

1. Clover 앱이 제대로 등록되었는지 확인하세요
2. 앱 설정에서 사이트 URL이 http://localhost:4000/oauth-callback 으로 설정되어 있는지 확인하세요.
3. 클라이언트 ID와 클라이언트 비밀번호가 올바른지 확인하세요.
4. 개발자 대시보드에서 "기본 OAuth 응답"이 "코드"로 설정되어 있는지 확인하세요.
5. initiate_oauth_flow 로 OAuth 흐름을 다시 시작해 보세요.

특허

MIT