🔌 Подключение ИИ-клиента

Что это. Пошаговая инструкция, как подключить Claude Code, Cursor, VS Code или Codex к Fixorix MCP: ключ с доступом через MCP, переменная окружения с ключом, конфиг клиента и проверка.

Когда нужно. При первом подключении ИИ-клиента к проекту, при смене ключа и когда нужно подключить второй клиент.

Готовые конфиги — в дашборде

Те же конфиги, что ниже, дашборд собирает сам: карточка «Подключить ИИ-клиент по MCP» на вкладке Настройки → «MCP» → «Подключение» и свёрнутый блок с тем же названием на вкладке Настройки → «API». Выберите клиент переключателем «ИИ-клиент» и систему переключателем «Система» — и скопируйте конфиг кнопкой. Вариант адреса — «Все инструменты», «Только чтение» или «Выбранные тулсеты» — выбирается в свёрнутом блоке «Другие адреса». В окне «Ключ создан» у ключа для ИИ-клиента команда установки переменной окружения показывается уже с вашим ключом.

📷 Скриншот: карточка «Подключить ИИ-клиент по MCP» с переключателем клиентов (будет добавлен).

Шаг 1. Проверьте, что MCP разрешён в проекте

Откройте Настройки → «MCP» → «Подключение» и убедитесь, что в карточке «Доступ» включён переключатель «Разрешить Fixorix MCP» — по умолчанию он включён. Если его выключили, сервер отвечает любому ключу проекта ошибкой 403 mcp_disabled. Включает его администратор проекта.

Шаг 2. Создайте ключ для ИИ-клиента

Откройте Настройки → вкладка «API» и нажмите «Создать ключ» — или нажмите «Создать ключ для ИИ-клиента» на вкладке Настройки → «MCP» → «Подключение».
Задайте «Имя», по которому ключ потом легко узнать, например Cursor — Иван.
Включите переключатель «Для ИИ-клиента (MCP)» — если окно открыто кнопкой «Создать ключ для ИИ-клиента», он уже включён.
Выберите «Пресет»: «ИИ-клиент: только чтение» — чтобы модель только читала данные, или «ИИ-клиент: оператор» — чтобы она ещё могла ставить приоритет и теги, а после вашего подтверждения в дашборде — менять статус чата и статьи базы знаний (запуск и остановка ботов и публикация сценариев — отдельными галочками, см. Ключи и права). Пресет сам отметит права и выберет режим «Доступ через MCP».
При необходимости отметьте галочки в блоке «Дополнительно», например «Контакты».
Проверьте блок «Какие инструменты будут доступны» и нажмите «Создать ключ».
Скопируйте секрет из окна «Ключ создан» — он показывается один раз.

Что дают пресеты и почему в них нет части прав — на странице Ключи и права.

У меня уже есть ключ

Ключу, который создан без переключателя, доступ через MCP можно включить: карандаш в строке ключа → окно «Редактирование API-ключа» → «Доступ через MCP» → «Только чтение» или «Чтение и запись» → «Сохранить». Права (scopes) у выпущенного ключа при этом не меняются: если их не хватает, выпустите новый ключ. Но лучше завести для ИИ-клиента отдельный ключ, см. Ключи и права.

Шаг 3. Сохраните ключ в переменной окружения

Конфиги Cursor и Codex ниже не содержат самого ключа: клиент читает его из переменной окружения FIXORIX_API_KEY при каждом подключении. Так ключ не попадёт в git вместе с конфигом и в историю чата с моделью. Claude Code устроен иначе: переменная нужна только при выполнении команды claude mcp add, а сам ключ Claude Code сохраняет в своём конфиге, см. ниже.

macOS / Linux — добавьте строку в профиль оболочки (~/.zshrc, ~/.bashrc):

export FIXORIX_API_KEY="<ВАШ_КЛЮЧ>"

Windows (PowerShell):

$env:FIXORIX_API_KEY = '<ВАШ_КЛЮЧ>'

Команда PowerShell задаёт переменную только для текущего окна. Чтобы она сохранилась, задайте её в «Переменных среды» Windows или выполните setx FIXORIX_API_KEY "<ВАШ_КЛЮЧ>" и откройте новое окно.

Переменная должна быть видна самому клиенту

Редакторы (Cursor, VS Code) берут переменные окружения при запуске. Задайте переменную и перезапустите клиент — иначе он отправит пустой ключ и получит 401.

Шаг 4. Подключите клиент

Везде ниже адрес — https://mcp.fixorix.ru, все инструменты, доступные ключу. Чтобы сузить набор, допишите к нему /readonly или /x/chats,knowledge, см. Адреса.

Claude Code

Выполните в терминале:

claude mcp add --transport http fixorix https://mcp.fixorix.ru --header "Authorization: Bearer ${FIXORIX_API_KEY}"

Значение ${FIXORIX_API_KEY} подставляет оболочка в момент выполнения команды, поэтому переменная должна быть задана в этом же окне терминала. Проверить подключение — командой claude mcp list или /mcp внутри Claude Code.

Claude Code хранит сам ключ в своём конфиге

Оболочка подставляет ключ в команду ещё до запуска claude, поэтому Claude Code получает не имя переменной, а сам ключ и записывает заголовок Authorization: Bearer fxr_… открытым текстом в свой конфиг ~/.claude.json (в Windows — %USERPROFILE%\.claude.json). После этого переменная окружения Claude Code не нужна, а её смена на подключение не влияет.

Закройте файл от других пользователей компьютера: chmod 600 ~/.claude.json (macOS / Linux).
Выпустите для Claude Code отдельный ключ с минимальными правами: если файл утечёт, достаточно отозвать один этот ключ.
Не добавляйте сервер с --scope project: тогда настройка вместе с ключом записывается в .mcp.json в папке проекта и может попасть в git.

Windows PowerShell

В PowerShell переменные окружения пишутся иначе, поэтому команда выглядит так:

claude mcp add --transport http fixorix https://mcp.fixorix.ru --header "Authorization: Bearer $env:FIXORIX_API_KEY"

Cursor

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

{
  "mcpServers": {
    "fixorix": {
      "url": "https://mcp.fixorix.ru",
      "headers": {
        "Authorization": "Bearer ${env:FIXORIX_API_KEY}"
      }
    }
  }
}

Если в файле уже есть другие серверы, добавьте fixorix внутрь существующего mcpServers.

VS Code

Добавьте в .vscode/mcp.json рабочей папки:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "fixorix-key",
      "description": "Fixorix API key",
      "password": true
    }
  ],
  "servers": {
    "fixorix": {
      "type": "http",
      "url": "https://mcp.fixorix.ru",
      "headers": {
        "Authorization": "Bearer ${input:fixorix-key}"
      }
    }
  }
}

Переменная окружения для VS Code не нужна: при первом запуске сервера VS Code спросит ключ и сохранит его в защищённом хранилище.

Codex

Добавьте в ~/.codex/config.toml:

[mcp_servers.fixorix]
url = "https://mcp.fixorix.ru"
bearer_token_env_var = "FIXORIX_API_KEY"

Codex сам добавит заголовок Authorization: Bearer … со значением переменной FIXORIX_API_KEY.

Другие клиенты

Подойдёт любой клиент, который подключается к MCP-серверу по HTTP (Streamable HTTP) и умеет передавать свои заголовки. Укажите адрес сервера и заголовок Authorization: Bearer <ВАШ_КЛЮЧ>.

Не вставляйте ключ в чат с моделью

Ключ передаётся только в заголовке подключения. Не пишите его в чат с ИИ-ассистентом и не кладите в файлы, которые модель может прочитать: всё, что видит модель, может оказаться в ответе, журнале или у стороннего сервиса.

Шаг 5. Проверьте подключение

Попросите модель: «Вызови project_get_context и расскажи, что мне доступно». Инструмент работает с любым ключом и ничего не меняет. В ответе будут:

проект и ключ — имя, срок действия, режим «Доступ через MCP» и права;
доступные тулсеты и инструменты;
недоступные инструменты — с причиной и подсказкой, что их откроет (недостающее право, режим ключа, настройка проекта);
справочники значений: статусы и приоритеты чатов, статусы ботов, сценариев и запусков.

Ключ, которым подключён клиент, работает и в REST API: список доступных ему методов модель найдёт в ресурсе fixorix://rest-api/operations, см. REST API тем же ключом.

Если вызова не получилось — смотрите Решение проблем.

Как поменять или отозвать доступ

Что нужно	Как сделать
Запретить ключу MCP, но оставить REST	Окно «Редактирование API-ключа» → «Доступ через MCP» → «Без MCP»
Разрешить ИИ-клиенту запись	Там же → «Чтение и запись». Нужны и права на запись у самого ключа, и «Максимальный риск» проекта не ниже «Обратимые записи», а для действий, которые видят клиенты, — «Видимые клиентам действия» (так по умолчанию). Каждое такое действие подтверждает человек, см. Безопасность
Добавить ключу права	Нельзя: права выпущенного ключа не меняются. Выпустите новый ключ и отзовите старый
Отключить ИИ-клиент навсегда	Отзовите ключ: «Отозвать» в строке ключа. Вызовы инструментов по нему прекращаются сразу
Запретить MCP всему проекту	Настройки → «MCP» → «Подключение», карточка «Доступ» → выключите «Разрешить Fixorix MCP» и нажмите «Сохранить»
Сменить ключ в клиенте	Обновите переменную `FIXORIX_API_KEY` и перезапустите клиент (в VS Code — перезапустите сервер, он спросит ключ заново). В Claude Code ключ сохранён в конфиге: выполните `claude mcp remove fixorix` и заново команду `claude mcp add` из шага 4

Отзыв ключа останавливает вызовы инструментов сразу, а смена режима «Доступ через MCP» доходит до сервера MCP не дольше чем за 15 секунд.

Кто что может

Действие	Минимальная роль
Создать ключ для ИИ-клиента, изменить «Доступ через MCP», отозвать ключ	Администратор
Включить или выключить «Разрешить Fixorix MCP»	Администратор
Видеть вкладку «Подключение» раздела «MCP»	Редактор

Fixorix MCP · Ключи и права · Каталог инструментов · Безопасность и лимиты · Решение проблем

Шаг 1. Проверьте, что MCP разрешён в проекте​

Шаг 2. Создайте ключ для ИИ-клиента​

Шаг 3. Сохраните ключ в переменной окружения​

Шаг 4. Подключите клиент​

Claude Code​

Cursor​

VS Code​

Codex​

Другие клиенты​

Шаг 5. Проверьте подключение​

Как поменять или отозвать доступ​

Кто что может​