ClassQuill

Servidor MCP ClassQuill

Dê a qualquer ferramenta de IA compatível com MCP — Claude, Codex, Cursor, Windsurf, Composio e mais — acesso de leitura aos dados do seu negócio de tutoria ClassQuill: sessões, alunos, tutores, pais, faturas, pagamentos, planos de aula, reservas, ganhos e relatórios.

É um proxy fino e somente leitura sobre a API pública do ClassQuill (/v1). Cada ferramenta mapeia 1:1 para um endpoint da API pública, então a lista de ferramentas nunca pode divergir da API real. Suas credenciais nunca saem da sua máquina (ou, no modo hospedado, da sua solicitação).

ClassQuill é a plataforma de gerenciamento de negócios de tutoria da EquateIt. O pacote npm é publicado como equateit-mcp.

Duas maneiras de usar

1. Hospedado (recomendado — nada para instalar)

Aponte qualquer cliente MCP remoto para o servidor hospedado:

https://mcp.classquill.com/mcp

• Claude / Claude.ai — adicione-o como um conector personalizado e faça login (OAuth).
• Codex — codex mcp add classquill --url https://mcp.classquill.com/mcp
• Qualquer cliente — passe sua chave de API como token Bearer: Authorization: Bearer ei_live_…

2. Local (execute você mesmo via 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 (configuração mcpServers):

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

Obtendo uma chave de API

Crie uma no aplicativo ClassQuill em Configurações → Desenvolvedores (administradores da organização). As chaves têm o formato ei_live_… e são somente leitura para este servidor.

Ferramentas

Uma ferramenta somente leitura por rota GET /v1 — sessões, alunos, tutores, pais, faturas, pagamentos, planos de aula, lição de casa, perguntas, disciplinas, arquivos, resultados, disponibilidades, cobertura, relatórios e mais. A lista é gerada a partir da especificação OpenAPI pública (npm run gen:tools) para que sempre corresponda à API ativa.

Opções e ambiente

Opção	Variável de ambiente	Padrão	Propósito
--key	EQUATEIT_API_KEY	—	Sua chave ei_live_… (modo stdio).
--http	—	off	Executar como servidor HTTP (Streamable HTTP) em vez de stdio.
--port / -p	MCP_PORT	3000	Porta HTTP.
—	EQUATEIT_API_BASE_URL	https://api.classquill.com	Base da API (sem /v1 no final).

No modo HTTP, cada solicitação fornece sua própria credencial como Authorization: Bearer … — uma chave de API ei_live_… ou um token de acesso OAuth.

Desenvolver

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

Hospedar o servidor HTTP por conta própria é um único contêiner — veja Dockerfile.

Licença

MIT — veja LICENSE.