korg-ledger — MCP-сервер для Claude Code: журнал сессий с проверкой
Записывает действия агента в журнал с хеш-цепочкой и проверяет, что запись не подменили. Пригодится, когда нужно доказать, что сессия прошла без правок задним числом.
claude mcp add --env KORG_JOURNAL_PATH=<KORG_JOURNAL_PATH> --env KORG_LEDGER_HMAC_KEY=<KORG_LEDGER_HMAC_KEY> --transport stdio korg-ledger -- uvx korgexЧто делает korg-ledger
Сервер поднимает инструменты korgex по протоколу MCP: агент получает доступ к журналу сессии, а вы потом проверяете его целостность. Хеш-цепочка и причинный граф связывают события между собой, поэтому подмена даже одного символа видна при проверке.
Запускается через uvx korgex, отдельная установка не нужна. Для работы задайте KORG_JOURNAL_PATH — путь к файлу журнала, и KORG_LEDGER_HMAC_KEY — ключ для подписи записей. Без ключа проверка подлинности теряет смысл: подпись нечем сверять.
Конфигурация различается по платформам. В Claude и Codex это команда claude mcp add или codex mcp add с флагами --env, в Cursor и GitHub Copilot — JSON-блок с command, args и env, в Gemini CLI — gemini mcp add с -e. Формат записи у каждого свой, копируйте целиком.
Какие задачи решает
- проверить, что журнал сессии агента не правили после запуска
- собрать подписанную запись действий агента для разбора инцидента
- подключить журнал korgex к агенту в Cursor или Claude
- задать путь и ключ подписи для хранения журнала в своём каталоге
- сверить события сессии по хеш-цепочке и причинному графу
Примеры запросов агенту
- Подключи korg-ledger и покажи, что записано в журнале текущей сессии
- Проверь целостность журнала: хеш-цепочка и причинный граф должны сойтись
- Настрой korg-ledger с путём
KORG_JOURNAL_PATHи ключомKORG_LEDGER_HMAC_KEY
Как установить korg-ledger
Командой платформы
claude mcp add --env KORG_JOURNAL_PATH=<KORG_JOURNAL_PATH> --env KORG_LEDGER_HMAC_KEY=<KORG_LEDGER_HMAC_KEY> --transport stdio korg-ledger -- uvx korgexВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from korgex <команда>
Командой платформы
codex mcp add korg-ledger --env KORG_JOURNAL_PATH=<KORG_JOURNAL_PATH> --env KORG_LEDGER_HMAC_KEY=<KORG_LEDGER_HMAC_KEY> -- uvx korgexВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from korgex <команда>
Файл настроек
{
"mcpServers": {
"korg-ledger": {
"command": "uvx",
"args": [
"korgex"
],
"env": {
"KORG_JOURNAL_PATH": "<KORG_JOURNAL_PATH>",
"KORG_LEDGER_HMAC_KEY": "<KORG_LEDGER_HMAC_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from korgex <команда>
Файл настроек
{
"servers": {
"korg-ledger": {
"type": "stdio",
"command": "uvx",
"args": [
"korgex"
],
"env": {
"KORG_JOURNAL_PATH": "<KORG_JOURNAL_PATH>",
"KORG_LEDGER_HMAC_KEY": "<KORG_LEDGER_HMAC_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from korgex <команда>
Командой платформы
gemini mcp add -e KORG_JOURNAL_PATH=<KORG_JOURNAL_PATH> -e KORG_LEDGER_HMAC_KEY=<KORG_LEDGER_HMAC_KEY> korg-ledger uvx korgexВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from korgex <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о korg-ledger
Как установить korg-ledger в Claude Code?
Добавьте сервер командой claude mcp add korg-ledger -- uvx korgex. Если нужны путь к журналу и ключ подписи, используйте вариант с --env KORG_JOURNAL_PATH=<KORG_JOURNAL_PATH> --env KORG_LEDGER_HMAC_KEY=<KORG_LEDGER_HMAC_KEY> --transport stdio korg-ledger -- uvx korgex.
Что делает korg-ledger?
Даёт агенту доступ к журналу сессии korgex и позволяет проверить, что запись не изменена. Целостность подтверждается хеш-цепочкой и причинным графом событий.
Что нужно задать для работы сервера?
Две переменные окружения: KORG_JOURNAL_PATH с путём к журналу и KORG_LEDGER_HMAC_KEY с ключом подписи. Обе передаются при добавлении сервера.
