Adaptador MCP de FindClass

El adaptador es solo stdio local. Reenvía las 20 herramientas acotadas a la API de flujo de trabajo del backend autenticada.

Las herramientas de comercio y cumplimiento cubren lecturas de pedidos/reembolsos/liquidaciones/slots filtradas por permisos, reprogramación de pedidos, registro de cumplimiento y creación/cierre de tutor-slot. Los callbacks de pago nunca son herramientas MCP. La revisión de reembolsos permanece en la UI de administración porque requiere el permiso dedicado de reembolso existente y un TOTP nuevo; las escrituras de liquidación permanecen en el flujo de trabajo de finanzas. La búsqueda de registros y la consulta de detalles cubren contenido, aplicaciones externas, pedidos, reembolsos, liquidaciones y slots de tutor; cada resultado se filtra por los permisos actuales de la cuenta propietaria del token MCP. Las concesiones de cupones congelan como máximo 100 usuarios seleccionados y emiten un cupón por usuario; las concesiones más grandes o de múltiples cupones permanecen en la UI de administración.

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

Instala desde el bloqueo hash:

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

O ejecuta ./install-mcp-adapter.sh; instala el mismo adaptador bloqueado por hash sin escribir un token.

El token es de revelación única y no debe escribirse en este repositorio ni en los logs normales del cliente.