@konsulto/mcp

MCP-сервер, который позволяет Claude Code (и любому другому клиенту с поддержкой MCP) управлять платформой аудита кибербезопасности Konsulto из CLI:

• Чтение — список ваших аудитов, поиск результатов/шаблонов, чтение результата (включая тело, отрендеренное в markdown, чтобы LLM могла анализировать текст), чтение отдельного раздела.

• Запись — создание результатов на основе структурированных полей (бэкенд формирует тело Tiptap), обновление скалярных значений, добавление/замена текста раздела с использованием markdown, массовое изменение статуса с предварительным просмотром (dry-run).

• Доказательства — загрузка файлов/встроенного контента/base64, вставка доказательств в тело результата в нужный раздел.

• Область тестирования и активы — список области тестирования, список/создание активов, сопоставление или создание актива и привязка его к результату.

Действует от имени пользователя с его правами доступа, ограниченными персональным MCP-токеном. Три уровня проверки во время выполнения: включен ли функциональный флаг арендатора, есть ли у роли право mcp:use, не отозван/не истек ли токен.

Быстрый старт

1. Создайте MCP-токен в веб-приложении Konsulto

Войдите в систему → Profile → MCP Tokens → New MCP token. Скопируйте значение kon_mcp_… один раз — оно больше не будет отображаться. (Администратор арендатора должен сначала включить интеграцию MCP в разделе Account → API Access.)

2. Сохраните токен локально

mkdir -p ~/.konsulto && chmod 700 ~/.konsulto
cat > ~/.konsulto/credentials <<EOF
token: kon_mcp_REPLACE_WITH_YOUR_TOKEN
endpoint: https://api.konsulto.io
EOF
chmod 600 ~/.konsulto/credentials

Или используйте переменную окружения KONSULTO_TOKEN, если не хотите создавать файл.

3. Сообщите Claude Code о сервере

Добавьте в ~/.claude/mcp.json:

{
  "mcpServers": {
    "konsulto": {
      "command": "npx",
      "args": ["-y", "@konsulto/mcp"]
    }
  }
}

Проверьте подключение:

npx @konsulto/mcp doctor

Вы должны увидеть все зеленые галочки.

Related MCP server: claude-sessions-mcp

Привязка к папке (необязательно, рекомендуется)

Запустите npx @konsulto/mcp init внутри папки проекта, чтобы привязать её к одному аудиту:

~/audits/acme-q2-pentest/
├── .konsulto.yml          ← pins this folder to one audit
├── recon/
└── notes.md

Когда Claude Code запускается в этой папке (или любой подпапке), MCP автоматически привязывает аудит. Больше не нужно думать об ID аудита.

Файл можно передавать вашей команде — он содержит ID аудита и необязательный эндпоинт, никаких секретов.

Шаблоны рабочих процессов

Инструменты

Каждый инструмент имеет префикс konsulto_*, чтобы не конфликтовать с другими MCP (Burp, nmap, prowler и т.д.), которые у вас могут быть настроены.

Идентификация и контекст

Шаблоны

Результаты — чтение

Результаты — запись

Доказательства

Область тестирования и активы

Вспомогательный CLI

Пакет поставляется с двумя бинарными файлами:

• konsulto-mcp — stdio MCP-сервер. Claude Code запускает его. Вам не нужно запускать его напрямую.

• konsulto — интерактивный помощник:

  • konsulto init — создание .konsulto.yml для текущей папки

  • konsulto whoami — проверка токена, отображение личности + прав доступа + активного аудита

  • konsulto doctor — проверка прав доступа к файлу учетных данных, валидности токена, доступности сети, включения функции MCP, наличия права mcp:use у роли

Устранение неполадок

konsulto doctor охватывает каждую из этих проблем с предложением решения в одну строку.

Модель безопасности

• Три уровня проверки при каждом запросе API: включен ли функциональный флаг арендатора, есть ли у вашей роли право mcp:use, не отозван/не истек ли ваш токен. Отключение любого из них немедленно прекращает трафик MCP — отзыв каждого токена по отдельности не требуется.

• Хранение токенов: ~/.konsulto/credentials (chmod 600) или переменная KONSULTO_TOKEN. Никогда не храните их в ~/.claude/mcp.json.

• Уведомление при входе с нового IP: когда ваш токен используется с IP-адреса, с которого ранее не было входов, вы получаете письмо, чтобы можно было обнаружить утечку. В письме есть ссылка на процесс отзыва.

• Срок действия по умолчанию: 90 дней. Максимум 365.

• Права доступа считываются в реальном времени: изменение вашей роли вступает в силу в течение одного запроса — вам не нужно перевыпускать токен.

Несколько проектов на одной машине

Установите KONSULTO_PROFILE=acme, чтобы считывать ~/.konsulto/credentials.acme вместо стандартного файла. Полезно, если вы работаете с арендатором Konsulto клиента с того же ноутбука, который используете для арендатора вашей фирмы.

Лицензия

MIT — см. LICENSE.