# korg-ledger

Записывает действия агента в журнал с хеш-цепочкой и проверяет, что запись не подменили. Пригодится, когда нужно доказать, что сессия прошла без правок задним числом.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Автор: New1Direction
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/New1Direction/korgex
- Обновлён: 2026-10-13
- HTML: https://affpapa.org/nevibecode/mcp/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`. Формат записи у каждого свой, копируйте целиком.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `KORG_JOURNAL_PATH`, `KORG_LEDGER_HMAC_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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

**Командой платформы**
```bash
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 <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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 <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
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 <команда>

## Когда брать
- проверить, что журнал сессии агента не правили после запуска
- собрать подписанную запись действий агента для разбора инцидента
- подключить журнал korgex к агенту в Cursor или Claude
- задать путь и ключ подписи для хранения журнала в своём каталоге
- сверить события сессии по хеш-цепочке и причинному графу

## Примеры запросов агенту
- Подключи korg-ledger и покажи, что записано в журнале текущей сессии
- Проверь целостность журнала: хеш-цепочка и причинный граф должны сойтись
- Настрой korg-ledger с путём `KORG_JOURNAL_PATH` и ключом `KORG_LEDGER_HMAC_KEY`

## Похожие
- [Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgres](https://affpapa.org/nevibecode/mcp/ekwo-os-open-source-accounting-ledger-invoices-and-vat-on-your-own-supabase-or-p.md) — MCP-сервер · ★ 40
- [finance-expert](https://affpapa.org/nevibecode/skills/finance-expert.md) — скилл · 6400 установок
- [continuity-ledger](https://affpapa.org/nevibecode/skills/continuity-ledger.md) — скилл · 509 установок
- [Model Ledger](https://affpapa.org/nevibecode/mcp/model-ledger.md) — MCP-сервер · ★ 17
- [agentic-ledger](https://affpapa.org/nevibecode/mcp/agentic-ledger.md) — MCP-сервер · ★ 7
- [close-month](https://affpapa.org/nevibecode/skills/close-month.md) — скилл · 1800 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md