TokenZero — MCP-сервер для Claude Code: установка
TokenZero проверяет код на потери токенов, сравнивает цены моделей и помогает менять запросы для кэширования. Подходит для аудита проекта и pull request.
Apache-2.0 обновлён 2026-10-28
claude mcp add --transport http mcp https://api.tokenzero.sh/mcpЧто делает TokenZero
TokenZero подключает к агенту инструменты для аудита расходов на LLM. audit_repo_token_waste локально ищет большие промпты без директив кэширования, вызовы моделей внутри циклов, неподходящие дорогие модели и устаревшие или неоценённые идентификаторы. calculate_model_arbitrage сравнивает варианты моделей, а optimize_prompt_payload подготавливает переданное тело запроса для сервиса.
Аудит читает код, а не историю трафика, поэтому его суммы остаются оценками по табличным ценам. Анализатор работает на вашей машине; есть режим для diff и порог ошибки для CI. MCP-сервер запускается через npx, а CLI умеет подключать проект к шлюзу и добавлять адреса провайдеров в .env с согласия пользователя.
optimize_prompt_payload отправляет переданное тело на https://tokenzero.sh, если не задан TOKENZERO_URL. Секреты в этот инструмент передавать нельзя. Ключи провайдеров через шлюз не сохраняются.
Какие задачи решает
- найти в коде промпты без кэширования
- сравнить цены альтернативных моделей
- проверить стоимость изменений в pull request
- обнаружить вызовы LLM внутри циклов
- подготовить тело запроса для кэширования
Примеры запросов агенту
- Проверь репозиторий на потери токенов с помощью
audit_repo_token_waste. - Сравни подходящие модели для этого запроса через
calculate_model_arbitrage. - Подготовь переданное тело запроса к кэшированию через
optimize_prompt_payload, не включая секреты.
Как установить TokenZero
1Командой платформы: удалённый сервер
claude mcp add --transport http mcp https://api.tokenzero.sh/mcp2Командой платформы
claude mcp add --env TOKENZERO_URL=<TOKENZERO_URL> --env TOKENZERO_KEY=<TOKENZERO_KEY> --transport stdio tokenzero -- npx -y @tokenzero/mcpВместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
codex mcp add tokenzero --url https://api.tokenzero.sh/mcp2Командой платформы
codex mcp add tokenzero --env TOKENZERO_URL=<TOKENZERO_URL> --env TOKENZERO_KEY=<TOKENZERO_KEY> -- npx -y @tokenzero/mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"tokenzero": {
"url": "https://api.tokenzero.sh/mcp"
}
}
}{
"mcpServers": {
"tokenzero": {
"command": "npx",
"args": [
"-y",
"@tokenzero/mcp"
],
"env": {
"TOKENZERO_URL": "<TOKENZERO_URL>",
"TOKENZERO_KEY": "<TOKENZERO_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"tokenzero": {
"type": "http",
"url": "https://api.tokenzero.sh/mcp"
}
}
}{
"servers": {
"tokenzero": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@tokenzero/mcp"
],
"env": {
"TOKENZERO_URL": "<TOKENZERO_URL>",
"TOKENZERO_KEY": "<TOKENZERO_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
1Командой платформы: удалённый сервер
gemini mcp add -t http tokenzero https://api.tokenzero.sh/mcp2Командой платформы
gemini mcp add -e TOKENZERO_URL=<TOKENZERO_URL> -e TOKENZERO_KEY=<TOKENZERO_KEY> tokenzero npx -y @tokenzero/mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о TokenZero
Как установить TokenZero в Claude Code?
Выполните claude mcp add --transport http tokenzero https://api.tokenzero.sh/mcp.
Что делает TokenZero?
MCP-сервер локально проверяет проект на перерасход токенов, оценивает варианты моделей и помогает подготовить запросы для кэширования. Его CLI также умеет запускать аудит и проверять экономию через подписанные записи шлюза.
Отправляет ли TokenZero исходный код или секреты на сервер?
Аудит и расчёт вариантов моделей выполняются локально. Тело, переданное optimize_prompt_payload, отправляется на https://tokenzero.sh, поэтому секреты туда помещать нельзя.