CHAP Coordinator — журнал решений человека над работой агента
CHAP Coordinator
MCP-сервер записывает одобрения, правки и эскалации человека над работой агента в журнал с проверяемой цепочкой хешей
- 122 ★ репозитория
- Последний коммит
- Apache-2.0
Минимальный доступ
Почему такой уровень
- Сервер пишет только в свой журнал или в базу SQLite и не трогает ваши файлы и сервисы
- Журнал решений может содержать содержимое черновиков и правок: храните его как рабочие данные
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/chap-coordinatorОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Сервер пишет только в свой журнал или в базу SQLite и не трогает ваши файлы и сервисы
- Журнал решений может содержать содержимое черновиков и правок: храните его как рабочие данные
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
CHAP (Collaborative Human-Agent Protocol) задает общий формат для решений, которые люди принимают над работой агентов: одобрение, отклонение, правка, передача, эскалация. Координатор проверяет каждый вызов по правилам рабочего пространства и пишет его в упорядоченный журнал аудита. Пакет `@brightbeamai/chap-coordinator-mcp` показывает методы CHAP как инструменты MCP, поэтому Claude Desktop, Cursor или Claude Code ведут рабочее пространство без собственного кода. По умолчанию сервер работает от имени одного участника, агента `agent:assistant`, и отказывается действовать как человек: решение принимает человек в отдельном окне проверки, а не через ассистента. Правка человека записывается как конверт переопределения с диффом, причиной и тегами, которые задает команда, поэтому исправления можно потом анализировать. С включенной цепочкой хешей измененная запись обнаруживается при проверке. Дополнительные профили добавляют подписи, привязку ключей к личностям и журнал прозрачности.
Для кого. Командам, где агенты готовят черновики и рекомендации, а люди утверждают их и должны оставлять проверяемый след: от одиночного разработчика с Cursor до регулируемого производства.
Подходит, если
- Работа агента проходит согласование, и нужен журнал, кто что одобрил и почему
- Правки человека к ответам агента надо собирать с причиной и тегами для разбора
- Журнал изменений должен выявлять подмену записей, а не только хранить их
- Агент ведет задачи, но решение по каждой остается за человеком в окне проверки
- Нужно общее описание согласований для связки MCP и A2A
Не подходит, если
- Нужно просто попросить подтверждение в чате: для этого хватит встроенных запросов разрешений агента
- Нужны готовая система управления задачами или трекер: CHAP описывает журнал решений, а не доску задач
- Требуется стабильный протокол: версия 0.3 остается публичным черновиком и может меняться до 1.0
Пример запроса к агенту
Зафиксируй в CHAP, что я утвердил черновик письма клиенту с правкой в третьем абзаце, и укажи причину правки.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
CHAP_PARTICIPANT- Участник, от имени которого сервер делает вызовы, по умолчанию `agent:assistant`.
CHAP_DB_PATH- Путь к файлу SQLite для хранения рабочих пространств.
Ограничения
Версия CHAP 0.3 остается публичным черновиком: перед 1.0 интерфейс может меняться. Референсные координаторы написаны на TypeScript и Python, для MCP-сервера нужен Node 22 или новее.
Без параметров `--url` и `--db` сервер хранит данные только в памяти и теряет рабочие пространства при перезапуске клиента, о чем пишет в stderr. Для постоянного хранения нужен необязательный пакет `better-sqlite3`: при заданном `--db` и недоступном пакете сервер завершается и не принимает решения без записи.
Защита от подмены работает, если свежая голова цепочки хранится вне досягаемости оператора. Порядок описан в файле `SECURITY.md`.
Как отключить. Удалите запись `chap` из конфигурации MCP-клиента. Файл SQLite, если он был задан в `--db`, удаляется вручную.
Частые вопросы
Что такое CHAP простыми словами?
Это протокол записи того, что агент сделал и что решил человек: одобрил, отклонил, исправил, передал дальше. Записи идут в один журнал, который можно запрашивать и проверять.
Чем CHAP связан с MCP и A2A?
MCP связывает агентов с инструментами, A2A агентов друг с другом, а CHAP записывает работу, которой агенты делятся с людьми. Протоколы дополняют друг друга.
Может ли ассистент сам одобрить свою работу?
Нет. Сервер отказывается действовать как участник `human:` и отклоняет вызовы от имени других участников. Решение принимает человек в окне проверки.
Как поставить сервер?
Пакет ставится командой `npm install @brightbeamai/chap-coordinator-mcp`, бинарный файл называется `chap-mcp-server`. Для проекта с окном проверки есть `npx create-chap-app my-gate --template mcp-gate`.
Где хранится журнал?
При параметре `--db` в файле SQLite, при `--url` на сервере CHAP, к которому подключен клиент. Без обоих параметров только в памяти процесса.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер общей комнаты для агентов: решения, задачи с проверкой другим агентом и итоговый отчет, вход по коду.
MCP самохостной панели EmperorClaw: Claude Code и Codex читают знания компании, задачи и клиентов в выданной области доступа
MCP-сервер и CLI координируют специализированных агентов, сохраняют рабочие шаблоны и связывают задания с хуками проекта.
MCP-сервер, который вставляет в задачи агента шаг обратной связи: веб или десктоп-окно для текста, картинок и промптов
Локальная память агента на журнале поправок: сказали Claude Code один раз, и новая сессия читает правило до начала работы
MCP-сервер запускает субагентов, описанных в Markdown, через Codex, Claude Code, Cursor CLI и другие CLI из любого MCP-клиента
Коротко о README
Описание протокола разбирает понятия рабочего пространства, участника, задачи, артефакта, конверта и журнала аудита. Ядро Core дополняют необязательные профили, а для установки есть пакеты на TypeScript и Python и генератор `create-chap-app`. Рядом лежат спецификация, глоссарий, техотчет на arXiv и разбор безопасности.