kcp-harness — MCP-сервер для Claude Code
Прокси между агентом и его инструментами: решает, какие файлы знаний доступны, и пишет журнал каждого решения.
claude mcp add kcp-harness -- npx -y kcp-harnessЧто делает kcp-harness — KCP compliance proxy
kcp-harness встаёт на пути вызовов MCP и пропускает через себя обращения агента к знаниям проекта. Классификатор отделяет работу с управляемыми путями от обычных вызовов, дальше запрос проходит каскад из 14 детерминированных гейтов — от аудитории и сроков до бюджета и лимита контекста. Модель в планировании не участвует: одинаковый вход даёт одинаковый план.
Побочный результат работы — артефакты: трассы решений по каждому запросу, журнал в формате JSONL только на дозапись, реестр расходов с потолком, тикеты на согласование у названного человека. Если проверка не проходит, агент не получает ничего. Обойти слой нельзя, потому что агент видит только MCP-интерфейс прокси.
Ставится через npm install -g kcp-harness, дальше kcp-harness init создаёт harness.yaml, а kcp-harness integrate claude-code прописывает .mcp.json и хуки PreToolUse. Для Cursor, Copilot, Windsurf, Cline и других агентов у команды integrate свои форматы конфигов. Есть готовые бинарники под Linux, macOS и Windows — тогда Node не нужен.
Какие задачи решает
- показать, почему агент прочитал именно этот файл
- удержать расходы агента в заданном потолке
- получить журнал обращений к знаниям проекта
- остановить чтение устаревшего или отозванного документа
- вынести спорные чтения на согласование человеку
Примеры запросов агенту
- Спланируй загрузку знаний через
kcp_planи покажи, какие юниты пропущены - Загрузи управляемый документ через
kcp_load - Покажи трассу решения по последнему чтению из
docs/
Как установить kcp-harness — KCP compliance proxy
Командой платформы
claude mcp add kcp-harness -- npx -y kcp-harnessКомандой платформы
codex mcp add kcp-harness-kcp-compliance-proxy -- npx -y kcp-harnessФайл настроек
{
"mcpServers": {
"kcp-harness-kcp-compliance-proxy": {
"command": "npx",
"args": [
"-y",
"kcp-harness"
]
}
}
}Файл настроек
{
"servers": {
"kcp-harness-kcp-compliance-proxy": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"kcp-harness"
]
}
}
}Командой платформы
gemini mcp add kcp-harness-kcp-compliance-proxy npx -y kcp-harnessПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о kcp-harness — KCP compliance proxy
Как установить kcp-harness в Claude Code?
Сначала claude mcp add kcp-harness -- npx -y kcp-harness, затем kcp-harness init для harness.yaml и kcp-harness integrate claude-code для .mcp.json и хуков PreToolUse.
Что делает kcp-harness?
Перехватывает вызовы агента к управляемым знаниям, прогоняет их через каскад из 14 гейтов и записывает решение в журнал. Плюс ведёт реестр расходов и тикеты на согласование.
Что нужно для работы kcp-harness?
Файл harness.yaml после kcp-harness init и интеграция под конкретного агента. Планировщик работает без LLM, поэтому решения воспроизводимы.
