three.ws Tutor — MCP-сервер для Claude Code: счёт занятия
Читает постатейный счёт учебной сессии Pay-As-You-Learn и закрывает её с аттестованным инвойсом. Обе операции бесплатны для ученика.
claude mcp add --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --transport stdio tutor-mcp -- npx -y @three-ws/tutor-mcpЧто делает three.ws Tutor
Сервер отдаёт по stdio два инструмента. load_session по opaque-идентификатору sessionId возвращает построчный счёт: вопрос, уровень, потраченные токены, стоимость каждой позиции и текущий итог. close_session переводит сессию из открытой в закрытую, прикладывает SHA-256 аттестацию и блокирует дальнейшее начисление.
Закрытие идемпотентно: повторный вызов на той же сессии отдаёт тот же итог. А чтение — нет, потому что таблица растёт по мере оплаты новых вопросов. Оплата идёт за каждый отвеченный вопрос, но сами эти инструменты денег не двигают: ученик не платит за просмотр долга или за завершение занятия.
Ключ API и подписант не нужны — сессия адресуется идентификатором. Нужен Node.js версии 20 или новее и сеть до https://three.ws либо до вашего развёртывания в THREE_WS_BASE. Если хранимой истории по sessionId нет, вернётся пустая открытая сессия с questionCount: 0, а не ошибка.
Какие задачи решает
- посмотреть построчный счёт сессии и текущий итог
- узнать стоимость каждого отвеченного вопроса отдельно
- закрыть сессию и получить аттестованный инвойс
- заблокировать дальнейшее начисление после завершения занятия
- проверить, что по сессии ещё ничего не списано
Примеры запросов агенту
- Покажи счёт сессии
learn-abc123по позициям и итоговую сумму - Закрой сессию
learn-abc123и верни аттестованный инвойс - Загрузи таблицу по
sessionId, который прислал ученик
Как установить three.ws Tutor
Командой платформы
claude mcp add --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> --transport stdio tutor-mcp -- npx -y @three-ws/tutor-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add tutor-mcp --env THREE_WS_BASE=<THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> -- npx -y @three-ws/tutor-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"tutor-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/tutor-mcp"
],
"env": {
"THREE_WS_BASE": "<THREE_WS_BASE>",
"THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"tutor-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/tutor-mcp"
],
"env": {
"THREE_WS_BASE": "<THREE_WS_BASE>",
"THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e THREE_WS_BASE=<THREE_WS_BASE> -e THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS> tutor-mcp npx -y @three-ws/tutor-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о three.ws Tutor
Как установить three.ws Tutor в Claude Code?
Одной командой: claude mcp add tutor-mcp -- npx -y @three-ws/tutor-mcp. Если нужен свой адрес развёртывания или таймаут, добавьте их через --env THREE_WS_BASE=<THREE_WS_BASE> и --env THREE_WS_TIMEOUT_MS=<THREE_WS_TIMEOUT_MS>, а перед командой укажите --transport stdio.
Что делает three.ws Tutor?
Читает постатейный счёт учебной сессии и закрывает её, возвращая счёт с SHA-256 аттестацией.
Какие есть инструменты и что нужно для работы?
Их два: load_session для чтения и close_session для закрытия. Нужны Node.js 20 или новее и доступ к THREE_WS_BASE, по умолчанию — https://three.ws.
