Подключение агентов к BrainEx

BrainEx — это MCP-сервер по адресу https://mcp.brainex.store/mcp. Любой агент, который умеет MCP по HTTP, подключается к нему одним блоком настроек и ключом устройства.

Коротко о ключе

Что это. Строка вида bxk_…. Она заменяет вам логин и пароль для агента: у кого ключ, тот работает от вашего имени.
Откуда. Войдите на главной через GitVerse, укажите имя устройства — ключ покажут один раз. Нет доступа — запросите.
Один ключ — одно устройство. Для ноутбука и сервера получите два ключа с разными именами. Тогда в журнале видно, кто что сделал, и отзывать можно по одному.
Где хранить. В переменной окружения или в файле .env с правами только для вас (chmod 600). На Маке надёжнее всего — Связка ключей. Не кладите ключ в репозиторий, в проектные конфиги, в чаты и в записи BrainEx.
Проверка. Агент вызывает whoami — в ответе ваш логин и имя устройства. device_list показывает все ваши ключи.
Утёк или потерян. Сразу отзовите его сами: device_revoke(credential_id) (номер — в device_list), затем войдите снова и получите новый. Утечку сообщите владельцу.
Коннектор claude.ai (Claude в браузере и телефоне) ключ не использует — там вход через GitVerse кнопкой.

Claude Code

Одна команда в терминале. --scope user обязательно: ключ ляжет в ваш личный ~/.claude.json, а не в .mcp.json проекта, который попадёт в git.

claude mcp add brainex --scope user --transport http https://mcp.brainex.store/mcp --header "X-BrainEx-Key: bxk_ВАШ_КЛЮЧ"

Проверка: claude mcp list → brainex connected. В новой сессии попросите агента вызвать whoami. Инструменты появляются только в сессии, открытой после добавления.

Codex (CLI и приложение)

Ключ — в переменной окружения, в ~/.codex/config.toml только её имя:

[mcp_servers.brainex]
url = "https://mcp.brainex.store/mcp"
env_http_headers = { "X-BrainEx-Key" = "BRAINEX_MCP_KEY" }

Переменная для терминала — в ~/.zshrc: export BRAINEX_MCP_KEY="bxk_ВАШ_КЛЮЧ". Приложение Codex, запущенное из Dock, не видит ~/.zshrc: на Маке выполните launchctl setenv BRAINEX_MCP_KEY "bxk_ВАШ_КЛЮЧ" и перезапустите приложение (после перезагрузки команду нужно повторить или поставить в автозапуск).

Hermes

Ключ — в ~/.hermes/.env, в ~/.hermes/config.yaml — ссылка на него:

MCP_BRAINEX_API_KEY=bxk_ВАШ_КЛЮЧ

mcp_servers:
  brainex:
    url: https://mcp.brainex.store/mcp
    headers:
      X-BrainEx-Key: ${MCP_BRAINEX_API_KEY}
    enabled: true

Перезапустите Hermes (приложение или hermes gateway restart). Если Hermes работает как сторож по расписанию — пусть вызывает inbox_peek, а не whoami: он не засоряет список активных сессий.

Qwen Code, Gemini CLI и похожие

В личном ~/.qwen/settings.json (или ~/.gemini/settings.json), не в папке проекта:

{
  "mcpServers": {
    "brainex": {
      "httpUrl": "https://mcp.brainex.store/mcp",
      "headers": { "X-BrainEx-Key": "bxk_ВАШ_КЛЮЧ" }
    }
  }
}

Клиент умеет только stdio

Через мост mcp-remote (нужен Node.js):

{
  "mcpServers": {
    "brainex": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.brainex.store/mcp", "--header", "X-BrainEx-Key:${BRAINEX_MCP_KEY}"],
      "env": { "BRAINEX_MCP_KEY": "bxk_ВАШ_КЛЮЧ" }
    }
  }
}

Claude в браузере и телефоне

Настройки → Коннекторы → Добавить свой → адрес https://mcp.brainex.store/mcp. Войдите через GitVerse и подтвердите доступ. Ключ не нужен.

Если не работает

401 / Unauthorized	ключ неверный, с пробелом или отозван. Проверьте заголовок `X-BrainEx-Key`; не помогло — получите новый ключ.
«аккаунт не приглашён»	доступ ещё не открыт — запросите.
проектов нет	вас не добавили соавтором в репозитории GitVerse; после добавления они появятся в течение часа.
инструментов не видно	перезапустите клиент или откройте новую сессию — список инструментов читается при подключении.
первый вызов после паузы падает	сессия, простоявшая 15 минут, закрывается сервером, а VPN часто рвёт старое соединение. Повторите вызов — это безопасно. Для WARP добавьте `mcp.brainex.store` в исключения.

Первые вызовы

whoami — проверка ключа; с ответом приходят правила работы, агент применяет их сам.
project_list → project_open(project_id) — ваши проекты и контекст.
space_create() — личное пространство для заметок вне репозиториев.

Правила целиком — на странице для агентов.