agentic-ledger — MCP-сервер для Claude Code
Прокси между агентом и LLM: перехватывает запросы, считает стоимость и помечает зацикленные прогоны. Пригодится, когда непонятно, куда ушли токены.
claude mcp add agentic-ledger -- uvx agentic-ledgerЧто делает agentic-ledger
Agentic Ledger встаёт прозрачным прокси между вашим агентом и провайдером. Каждый запрос и ответ получает action_id, сохраняется, а наверх уходит неизменённый ответ. Агент о прослойке не знает.
Данные ложатся в SQLite или Postgres, рядом поднимается живая панель и API. Запуск фоновый: agenticledger start печатает адрес панели и освобождает терминал, agenticledger status показывает состояние, agenticledger logs — что происходит, agenticledger stop останавливает. Есть вариант через Docker, тогда Python на машине не нужен.
Прокси слушает http://localhost:8000. Для Claude конфиг пишет одна команда agenticledger connect claude-code — с бэкапом и слиянием. Для остальных фреймворков правки две: base_url на прокси и заголовок с идентификатором сессии, чтобы вызовы сгруппировались в один прогон. Ключ, модель и сообщения остаются как были. Postgres и OpenTelemetry подключаются отдельными extras, а в Docker-образе база только SQLite — для Postgres ставьте пакет через pip.
Какие задачи решает
- посчитать, сколько токенов и денег съел прогон агента
- разобрать по шагам, что именно делал агент и в каком порядке
- заметить прогон, который зациклился и жжёт бюджет
- свести вызовы разных провайдеров в одну картину
- сверить свои цифры с выставленным счётом провайдера
Примеры запросов агенту
- Запусти agentic-ledger и покажи адрес панели
- Сколько стоил прогон
run-1и какие шаги в него вошли? - Есть ли среди последних прогонов зацикленные?
Как установить agentic-ledger
Командой платформы
claude mcp add agentic-ledger -- uvx agentic-ledgeruvx запускает команду с именем пакета; если в README она другая — uvx --from agentic-ledger <команда>
Командой платформы
codex mcp add agentic-ledger -- uvx agentic-ledgeruvx запускает команду с именем пакета; если в README она другая — uvx --from agentic-ledger <команда>
Файл настроек
{
"mcpServers": {
"agentic-ledger": {
"command": "uvx",
"args": [
"agentic-ledger"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from agentic-ledger <команда>
Файл настроек
{
"servers": {
"agentic-ledger": {
"type": "stdio",
"command": "uvx",
"args": [
"agentic-ledger"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from agentic-ledger <команда>
Командой платформы
gemini mcp add agentic-ledger uvx agentic-ledgeruvx запускает команду с именем пакета; если в README она другая — uvx --from agentic-ledger <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о agentic-ledger
Как установить agentic-ledger в Claude Code?
Одной командой: claude mcp add agentic-ledger -- uvx agentic-ledger. Дальше agenticledger connect claude-code пропишет конфиг агента, чтобы вызовы шли через прокси.
Что делает agentic-ledger?
Стоит между агентом и LLM, записывает запросы и ответы, считает стоимость и группирует вызовы в прогоны по идентификатору сессии. Отдельно помечает зацикленные прогоны.
Нужно ли менять код агента?
Нет. Достаточно перевести base_url на прокси и добавить заголовок с идентификатором сессии. Ключ, модель и сообщения не трогаются.
