FindClass MCP 어댑터

이 어댑터는 로컬 stdio 전용입니다. 인증된 백엔드 워크플로 API에 20개의 제한된 도구를 전달합니다.

거래 및 이행 도구는 권한으로 필터링된 주문/환불/정산/슬롯 조회, 주문 일정 변경, 이행 기록, 튜터 슬롯 생성/종료를 다룹니다. 결제 콜백은 결코 MCP 도구가 아닙니다. 환불 검토는 기존의 전용 환불 권한과 새로운 TOTP가 필요하므로 관리자 UI에 남아 있습니다. 정산 쓰기는 재무 워크플로에 남아 있습니다.

기록 검색 및 상세 조회는 콘텐츠, 외부 애플리케이션, 주문, 환불, 정산, 튜터 슬롯을 다룹니다. 모든 결과는 MCP 토큰을 소유한 계정의 실시간 권한으로 필터링됩니다.

쿠폰 발급은 최대 100명의 선택된 사용자를 동결하고 사용자당 쿠폰 하나를 발급합니다. 더 크거나 다중 쿠폰 발급은 관리자 UI에 남아 있습니다.

{
  "mcpServers": {
    "findclass": {
      "command": "/absolute/path/to/.venv/bin/python",
      "args": ["/absolute/path/to/findclass-mcp/server.py"],
      "env": {
        "FINDCLASS_BASE_URL": "https://your-findclass-backend",
        "FINDCLASS_MCP_TOKEN": "set-in-the-client-secret-store"
      }
    }
  }
}

해시 잠금에서 설치합니다:

uv venv --python 3.14 .venv
uv pip install --python .venv/bin/python --require-hashes -r requirements.lock
.venv/bin/python -m unittest -v test_server.py

또는 ./install-mcp-adapter.sh를 실행하세요. 이 스크립트는 토큰을 기록하지 않고 동일한 해시 잠금된 어댑터를 설치합니다.

토큰은 한 번만 공개되며, 이 저장소나 일반 클라이언트 로그에 기록해서는 안 됩니다.