helppilot-mcp

Servidor MCP local que permite a Claude Desktop comunicarse con tu inquilino de HelpPilot en pilot.helpvisor.gr.

Este es un cliente ligero. Toda la lógica de negocio, habilidades y credenciales permanecen en el lado del servidor; este binario simplemente reenvía las llamadas a herramientas y los prompts a través de HTTPS, protegidos por tu JWT de licencia de HelpPilot.

Instalación

La forma más sencilla es descargar el ejecutable de archivo único precompilado para tu sistema operativo desde la página de Releases. No se requiere Python.

O instálalo desde el código fuente:

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

Related MCP server: my-mcp-server

Configuración

Crea un archivo de configuración con tu JWT de licencia de HelpPilot:

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>"
}

Obtén el JWT iniciando sesión en pilot.helpvisor.gr y haciendo clic en Claude Desktop → setup & download. La página de configuración genera una configuración lista para copiar y pegar, además de un fragmento para Claude Desktop.

Conectar a Claude Desktop

Edita claude_desktop_config.json (Settings → Developer → Edit Config en Claude Desktop):

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

Ajusta la ruta a donde hayas colocado el ejecutable. Reinicia Claude Desktop. Las herramientas de HelpPilot (SoftOne, Drive, conciliación bancaria, historial) aparecerán en el menú MCP, y las habilidades de flujo de trabajo estarán disponibles como prompts.

Compilación

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

Salida: dist/helppilot-mcp(.exe).

Pruebas

pip install pytest httpx
pytest tests/

Licencia

Propietaria — © Helpvisor.