Graqle — MCP-сервер для Claude Code: граф знаний и проверка решений
Собирает код, документы и правила в один граф знаний, по которому агент отвечает на вопросы, и умеет пропускать действия через проверку с вердиктом.
claude mcp add graqle -- uvx graqleЧто делает Graqle
Graqle строит граф из репозитория и папки с документами: graq scan repo . разбирает код, graq scan docs ./policies — политики и ADR, graq learn knowledge добавляет отдельный факт. Дальше graq run отвечает на вопрос вместе с уверенностью и ссылками на источники, откуда взят ответ. PDF, DOCX, PPTX и XLSX подтягиваются, если поставить пакет с дополнением graqle[docs].
Поверх графа работает Decision Assurance Gate. Перед действием агента она отвечает одним из пяти вердиктов (EXECUTE, REPLAN, HOLD, REJECT, ESCALATE) и оставляет подписанную запись в цепочке хешей. По умолчанию шлюз выключен: установка ничего не меняет, пока не выставлен GRAQLE_DAG_ENABLED. Включать стоит осознанно — готовых порогов, солей и ключей в пакете нет, все значения GRAQLE_DAG_* задаёте вы, включая ключ ed25519 для подписи. Пропустите хоть одно — при первой загрузке настроек GraQle упадёт с ошибкой конфигурации и назовёт пропущенное поле.
Несколько агентов на одном проекте могут делить один граф: graq mcp serve поднимает сервер по HTTP, а каждая сессия подключается к нему через graq mcp relay. Так каждая сессия держит в памяти небольшой релей вместо полной копии графа (на графе в 20 000 узлов три отдельных сервера занимают 687 MB, общий сервер с тремя релеями — 493 MB). Файлы при этом остаются на машине пользователя, а ограничить доступ можно через --allowed-roots.
Какие задачи решает
- ответить на вопрос по коду и политикам со ссылкой на источники
- собрать документы, ADR и репозиторий в один граф знаний
- проверить действие агента до выполнения и получить причину отказа
- подписывать каждое решение записью, которую проверит аудитор
- дать нескольким агентам общий граф и не держать его копию в каждой сессии
Примеры запросов агенту
- Подключи Graqle по
mcp.jsonи ответь, какое одобрение нужно для крупного возврата - Просканируй
./policiesи репозиторий, потом ответь, что говорит политика о доступе к данным вендора - Включи Decision Assurance Gate через
GRAQLE_DAG_ENABLED=1и проверь вердикт для этого действия
Как установить Graqle
Командой платформы
claude mcp add graqle -- uvx graqleuvx запускает команду с именем пакета; если в README она другая — uvx --from graqle <команда>
Командой платформы
codex mcp add graqle -- uvx graqleuvx запускает команду с именем пакета; если в README она другая — uvx --from graqle <команда>
Файл настроек
{
"mcpServers": {
"graqle": {
"command": "uvx",
"args": [
"graqle"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from graqle <команда>
Файл настроек
{
"servers": {
"graqle": {
"type": "stdio",
"command": "uvx",
"args": [
"graqle"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from graqle <команда>
Командой платформы
gemini mcp add graqle uvx graqleuvx запускает команду с именем пакета; если в README она другая — uvx --from graqle <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Graqle
Как установить Graqle в Claude Code?
Одной командой: claude mcp add graqle -- uvx graqle. Для разбора PDF, DOCX, PPTX и XLSX дополнительно поставьте пакет с дополнением graqle[docs].
Что делает Graqle?
Превращает код, документы и правила в один граф знаний, по которому агент отвечает на вопросы. Перед действием агента шлюз Decision Assurance Gate выдаёт вердикт и оставляет подписанную запись.
Что нужно, чтобы включить Decision Assurance Gate?
Задать GRAQLE_DAG_ENABLED=1 и все обязательные значения GRAQLE_DAG_*: ключ ed25519 с манифестом, пороги, соль, версию калибратора и остальное. Готовых значений в пакете нет, при пропуске GraQle выдаёт ошибку конфигурации.
