ClassQuill

Servidor MCP de ClassQuill

Dale a cualquier herramienta de IA compatible con MCP — Claude, Codex, Cursor, Windsurf, Composio y más — acceso de lectura a los datos de tu negocio de tutoría de ClassQuill: sesiones, estudiantes, tutores, padres, facturas, pagos, planes de lecciones, reservas, ganancias e informes.

Es un proxy ligero y de solo lectura sobre la API pública de ClassQuill (/v1). Cada herramienta se asigna 1:1 a un endpoint de la API pública, por lo que la lista de herramientas nunca puede desviarse de la API real. Tus credenciales nunca salen de tu máquina (o, en modo alojado, de tu solicitud).

ClassQuill es la plataforma de gestión de negocios de tutoría de EquateIt. El paquete npm se publica como equateit-mcp.

Dos formas de usarlo

1. Alojado (recomendado — nada que instalar)

Apunte cualquier cliente MCP remoto al servidor alojado:

https://mcp.classquill.com/mcp

• Claude / Claude.ai — agrégalo como conector personalizado e inicia sesión (OAuth).
• Codex — codex mcp add classquill --url https://mcp.classquill.com/mcp
• Cualquier cliente — pasa tu clave de API como token Bearer: Authorization: Bearer ei_live_…

2. Local (ejecútalo tú mismo con npx)

npx -y equateit-mcp        # stdio, reads EQUATEIT_API_KEY

Claude Code:

claude mcp add classquill -e EQUATEIT_API_KEY=ei_live_xxxx -- npx -y equateit-mcp

Cursor / Claude Desktop / Windsurf (mcpServers configuración):

{
  "mcpServers": {
    "classquill": {
      "command": "npx",
      "args": ["-y", "equateit-mcp"],
      "env": { "EQUATEIT_API_KEY": "ei_live_xxxx" }
    }
  }
}

Obtención de una clave de API

Crea una en la aplicación de ClassQuill en Configuración → Desarrolladores (administradores de la organización). Las claves se ven como ei_live_… y son de solo lectura para este servidor.

Herramientas

Una herramienta de solo lectura por cada ruta GET de /v1 — sesiones, estudiantes, tutores, padres, facturas, pagos, planes de lecciones, tareas, preguntas, materias, archivos, resultados, disponibilidades, cobertura, informes y más. La lista se genera a partir de la especificación OpenAPI pública (npm run gen:tools) para que siempre coincida con la API en vivo.

Opciones y entorno

Bandera	Variable de entorno	Predeterminado	Propósito
--key	EQUATEIT_API_KEY	—	Tu clave ei_live_… (modo stdio).
--http	—	off	Ejecutar como servidor HTTP (Streamable HTTP) en lugar de stdio.
--port / -p	MCP_PORT	3000	Puerto HTTP.
—	EQUATEIT_API_BASE_URL	https://api.classquill.com	Base de API (sin /v1 al final).

En modo HTTP, cada solicitud proporciona su propia credencial como Authorization: Bearer … — una clave de API ei_live_… o un token de acceso OAuth.

Desarrollo

npm install
npm run build     # → dist/
npm test          # unit tests (url builder + auth scheme)

Autoalojar el servidor HTTP es un solo contenedor — consulta Dockerfile.

Licencia

MIT — consulta LICENSE.