ClassQuill

ClassQuill MCP サーバー

あらゆる MCP 対応 AI ツール（Claude、Codex、Cursor、Windsurf、Composio など）に、 セッション、生徒、講師、保護者、請求書、支払い、レッスンプラン、予約、収益、レポートなど、 ClassQuill の家庭教師ビジネスデータへの読み取りアクセスを提供します。

ClassQuill 公開 API （/v1）を介する、薄い読み取り専用プロキシです。各ツールは公開 API エンドポイントに 1 対 1 で対応しているため、ツール一覧が実際の API とずれることはありません。認証情報がマシンの外に出ることはありません（ホスト型モードでは、リクエストの外に出ることはありません）。

ClassQuill は EquateIt が提供する家庭教師ビジネス管理プラットフォームです。npm パッケージは equateit-mcp として公開されています。

使用方法は 2 通りあります

1. ホスト型（推奨 — インストール不要）

リモート MCP クライアントをホスト型サーバーに接続します。

https://mcp.classquill.com/mcp

• Claude / Claude.ai — カスタムコネクターとして追加し、サインインします（OAuth）。
• Codex — codex mcp add classquill --url https://mcp.classquill.com/mcp
• 任意のクライアント — API キーを Bearer トークンとして渡します：Authorization: Bearer ei_live_…

2. ローカル（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 設定）：

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

API キーの取得

ClassQuill アプリの Settings → Developers で作成します（組織管理者向け）。キーは ei_live_… の形式で、このサーバーでは読み取り専用です。

ツール

/v1 の GET ルートごとに、読み取り専用ツールを 1 つ提供します。セッション、生徒、講師、保護者、請求書、 支払い、lesson-plans、宿題、質問、科目、ファイル、結果、空き状況、 対応範囲、レポートなどが含まれます。一覧は公開 OpenAPI 仕様から 生成される（npm run gen:tools）ため、常にライブ API と一致します。

オプションと環境変数

フラグ	環境変数	デフォルト	用途
--key	EQUATEIT_API_KEY	—	ei_live_… キー（stdio モード）。
--http	—	オフ	stdio の代わりに HTTP（Streamable HTTP）サーバーとして実行します。
--port / -p	MCP_PORT	3000	HTTP ポート。
—	EQUATEIT_API_BASE_URL	https://api.classquill.com	API のベース URL（末尾に /v1 を付けません）。

HTTP モードでは、各リクエストで独自の認証情報を Authorization: Bearer … として渡します。 ei_live_… API キーまたは OAuth アクセストークンを使用できます。

開発

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

HTTP サーバーのセルフホストは、単一のコンテナーで実行できます。Dockerfile を参照してください。

ライセンス

MIT — LICENSE を参照してください。