helppilot-mcp

Claude Desktop이 pilot.helpvisor.gr의 HelpPilot 테넌트와 통신할 수 있게 해주는 로컬 MCP 서버입니다.

이것은 씬 클라이언트(thin client)입니다. 모든 비즈니스 로직, 기술 및 자격 증명은 서버 측에 유지되며, 이 바이너리는 HelpPilot 라이선스 JWT에 의해 보호되는 HTTPS를 통해 도구 호출 및 프롬프트를 전달하기만 합니다.

설치

가장 쉬운 방법은 Releases 페이지에서 운영체제에 맞는 사전 빌드된 단일 파일 실행 파일을 다운로드하는 것입니다. Python은 필요하지 않습니다.

또는 소스에서 설치하세요:

pip install git+https://github.com/helpvisor/helppilot-mcp.git

Related MCP server: my-mcp-server

구성

HelpPilot 라이선스 JWT가 포함된 구성 파일을 만듭니다:

Windows — %APPDATA%\helppilot\config.json macOS / Linux — ~/.config/helppilot/config.json

{
  "api_url": "https://pilot.helpvisor.gr",
  "license_jwt": "<paste from the 'Claude Desktop' page at pilot.helpvisor.gr>"
}

pilot.helpvisor.gr에 로그인하고 Claude Desktop → setup & download를 클릭하여 JWT를 받으세요. 설정 페이지에서 복사 가능한 구성과 Claude Desktop용 스니펫이 생성됩니다.

Claude Desktop에 연결

claude_desktop_config.json을 편집하세요 (Claude Desktop의 설정 → 개발자 → 구성 편집):

{
  "mcpServers": {
    "helppilot": {
      "command": "C:\\HelpPilot\\helppilot-mcp.exe"
    }
  }
}

실행 파일을 둔 위치에 맞게 경로를 조정하세요. Claude Desktop을 다시 시작하세요. HelpPilot 도구(SoftOne, Drive, 은행 조정, 기록)가 MCP 메뉴에 나타나며, 워크플로우 기술을 프롬프트로 사용할 수 있습니다.

빌드

pip install pyinstaller mcp httpx
pyinstaller mcp_client/helppilot-mcp.spec --noconfirm

출력: dist/helppilot-mcp(.exe).

테스트

pip install pytest httpx
pytest tests/

라이선스

독점 — © Helpvisor.