ejentum-mcp

Когнитивные инструменты для агентского ИИ, представленные как инструменты MCP. Одна установка, четыре инструмента, которые ваш агент может вызвать для получения структурированных логических каркасов, предотвращающих типичные ошибки LLM (поддакивание, галлюцинации, причинно-следственные сокращения, преждевременные выводы) до того, как они будут представлены пользователю.

Работает на базе Ejentum Logic API. Поддерживается в Claude Desktop, Cursor, Windsurf, Claude Code, узле MCP в n8n и любом другом клиенте, совместимом с MCP.

Возможности

• Четыре когнитивных инструмента в виде инструментов MCP: harness_reasoning, harness_code, harness_anti_deception, harness_memory

• Установка в один клик через Smithery на любом поддерживаемом клиенте

• Без сохранения состояния и легковесность — тонкая обертка над существующим Ejentum Logic API, никакой новой инфраструктуры

• Бесплатный уровень на 100 вызовов (карта не требуется) — попробуйте перед покупкой

• Кроссплатформенность — Node 18+, работает на macOS, Linux, Windows

• Кросс-клиентность — работает везде, где поддерживается MCP

Демонстрация

Типичная ошибка LLM: когда пользователь требует подтверждения, модель дает мягкий ответ вместо честного.

Без harness_anti_deception:

Пользователь: "Мой инвестор хочет, чтобы я обязался выполнить прогнозы по выручке с ростом в 2 раза без данных. Скажи, что мне ответить, чтобы они были довольны."

Агент: "Вот три варианта, которые работают лучше: условная модель, а не обещание, переверните вопрос, назовите динамику..."

(Агент помогает пользователю удовлетворить плохую постановку вопроса.)

С вызовом harness_anti_deception:

Пользователь: тот же запрос

Агент: "Почему вы спрашиваете, как удовлетворить эту рамку, вместо того чтобы спросить, как от нее отказаться? Три прочтения, которые стоит проверить честно: динамика отношений, ваша позиция по денежным средствам, тест, который вы проводите на мне..."

(Агент отказывается от рамки и поднимает более глубокий вопрос.)

Инструмент возвращает структурированный когнитивный каркас (шаблон ошибки, векторы подавления, тест на фальсификацию), который вызывающая LLM усваивает внутренне. Пользователь видит улучшенный ответ, а не сам каркас.

Установка

Вам потребуется:

• API-ключ Ejentum. Бесплатный уровень (100 вызовов) на ejentum.com/pricing.

• Node.js 18+ (требуется только для ручной установки; Smithery сделает это за вас).

Вариант А: Установка в один клик через Smithery (рекомендуется)

npx -y @smithery/cli install ejentum/ejentum-mcp --client claude

Замените claude на ваш клиент (cursor, windsurf, cline и т. д.). Или посетите страницу Smithery и нажмите Install.

Вариант Б: Ручная установка

Claude Desktop

Откройте claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Добавьте блок ejentum в раздел mcpServers:

{
  "mcpServers": {
    "ejentum": {
      "command": "npx",
      "args": ["-y", "ejentum-mcp"],
      "env": {
        "EJENTUM_API_KEY": "your_ejentum_api_key_here"
      }
    }
  }
}

Перезапустите Claude Desktop. Четыре инструмента harness_* должны появиться в выборе инструментов.

Cursor / Windsurf

Откройте настройки MCP → Добавить новый MCP-сервер. Вставьте тот же блок ejentum, что и для Claude Desktop выше.

Claude Code (CLI)

claude mcp add ejentum -e EJENTUM_API_KEY=your_ejentum_api_key_here -- npx -y ejentum-mcp

Узел n8n MCP Client

Добавьте узел MCP Client, транспорт stdio, команда npx, аргументы ["-y", "ejentum-mcp"], переменные окружения { "EJENTUM_API_KEY": "ваш_ключ" }.

Инструменты

Каждый инструмент принимает один аргумент (query, формулировка из 1-2 предложений о том, для чего вам нужен инструмент). Возвращает каркас инструмента в виде текста. Вызывающая LLM усваивает его внутренне и формирует с его помощью свой ответ. Пользователь видит улучшенный ответ, а не каркас.

Быстрый тест (после установки)

Откройте ваш MCP-клиент и вставьте:

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

Вы должны увидеть, как агент вызывает harness_anti_deception, получает каркас и отвечает отказом от такой постановки вопроса, а не мягким согласием. Если инструмент сработал и ответ заметно изменился, установка прошла успешно.

Как вызывать

Четыре инструмента harness_* срабатывают надежно, когда:

• Вы явно вызываете: используй инструмент harness_anti_deception, чтобы оценить...

• Вы мягко предлагаете: рассуди об этом, проверь это на поддакивание, тщательно проверь этот код

• Запрос достаточно сильно соответствует условиям срабатывания инструмента, чтобы агент распознал соответствие

Для задач, где агент может правдоподобно ответить на основе собственных рассуждений, автономный вызов менее надежен. Это свойство дополнительных инструментов MCP в целом, а не конкретно ejentum-mcp: агенты настроены на минимизацию ненужных вызовов инструментов. Если вы хотите, чтобы инструмент был применен к задаче, где он добавляет ценность, попросите агента напрямую.

Конфигурация

Лимиты уровней

MCP-сервер наследует лимиты API-ключа, который вы настроили:

• Бесплатный — 100 вызовов всего (пожизненно, карта не требуется)

• Ki (€19/мес) — 5 000 вызовов/мес

• Haki (€49/мес) — 10 000 вызовов/мес, плюс режимы -multi (не представлены в v0.1)

Безопасность и конфиденциальность

Ваш API-ключ хранится только в локальной конфигурации вашего MCP-клиента. Он отправляется только как Bearer-токен на API-эндпоинт Ejentum. Сам MCP-сервер не сохраняет состояние: нет логирования, нет телеметрии, нет сторонних вызовов, кроме эндпоинта Ejentum, против которого аутентифицируется ваш ключ.

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

Unauthorized (401) — ваш EJENTUM_API_KEY неверен или истек. Проверьте значение в конфигурации MCP вашего клиента и перезапустите клиент.

Forbidden (403) — вы попытались использовать режим, который не включен в ваш уровень подписки. Сервер v0.1 предоставляет только одиночные режимы (нет -multi); 403 здесь означает, что ключ был предоставлен для уровня, который исключает этот режим.

Rate limit exceeded (429) — вы достигли месячного лимита запросов. Обновите подписку или подождите сброса окна.

Инструмент не появляется в клиенте — клиент не подхватил изменение конфигурации. Полностью закройте и откройте его снова (не просто закройте окно). В Claude Desktop проверьте Help → Logs на наличие ошибок подключения MCP.

EJENTUM_API_KEY is not set — клиент не передал блок env запущенному процессу MCP. Убедитесь, что блок env существует в конфигурации вашего клиента и содержит ваш ключ.

Локальная разработка

git clone https://github.com/ejentum/ejentum-mcp.git
cd ejentum-mcp
npm install
cp .env.example .env
# edit .env and paste your EJENTUM_API_KEY
npm run dev

Протестируйте все четыре инструмента на реальном API:

npm run build && npm run test:smoke

Тестируйте интерактивно с помощью MCP Inspector от Anthropic:

npx @modelcontextprotocol/inspector npm run dev

Пересоберите и перепакуйте бандл MCPB для релиза в Smithery:

npm run build
npm prune --omit=dev   # slim the bundle
npx -y @anthropic-ai/mcpb pack
npm install            # restore devDeps
npx -y @smithery/cli mcp publish ./ejentum-mcp.mcpb -n ejentum/ejentum-mcp

Списки

• Smithery — установка в один клик для всех основных MCP-клиентов

• Glama — каталог MCP-серверов

• mcp.so — каталог сообщества

• npm — npm install -g ejentum-mcp

Ссылки

• Документация Ejentum

• Объяснение метода

• Руководство по интеграции с n8n

• Руководство по интеграции с Claude Code

• Цены

• info@ejentum.com

Лицензия

MIT. См. LICENSE.