Ручное подключение

ИИ-агент подключается к сайту как к удалённому MCP-серверу. Для подключения нужны два значения:

Значение заголовка начинается со слова Bearer и пробела, затем следует токен. Не передавайте токен другим людям: агент с ним получает доступ к инструментам сайта от имени вашего пользователя.

Клиент должен поддерживать протокол MCP версии 2025-11-25 или 2026-07-28 и транспорт Streamable HTTP. Вход через OAuth шлюз не поддерживает, поэтому токен всегда указывается в заголовке.

Чтобы агент сам провёл вас по шагам подключения, передайте ему ссылку на страницу «Инструкция для агента».

Подготовка на сайте

Шлюз должен быть установлен и включён, а пользователь, от имени которого работает агент, — входить в группу «MCP: Клиенты» и иметь access-токен. См. «Доступ и группы».

Адрес сервера состоит из адреса сайта, пути API и /mcp.

Приложения

Claude

Веб-версия claude.ai и приложения Claude подключают сервер как пользовательский коннектор. Запросы к серверу идут из инфраструктуры Anthropic, поэтому сайт должен быть доступен из интернета.

1. Откройте страницу Customize → Connectors и нажмите Add custom connector.
2. В поле MCP server URL укажите адрес сервера.
3. В разделе Authentication выберите No sign-in.
4. В разделе Request headers выберите заголовок authorization и введите значение Bearer ACCESS_TOKEN.
5. Нажмите Add.

Раздел Request headers находится в бета-версии и доступен не всем организациям. Если его нет, подключить шлюз в Claude пока нельзя: используйте Codex или Claude Code. В тарифах Team и Enterprise участник не может добавить коннектор сам. Его добавляет владелец организации на странице Organization settings → Connectors через Add → Custom, а участники подключают его в Customize → Connectors. Токен из Request headers становится общим для всех участников.

Документация клиента: Add a connector that isn’t in the directory.

Claude Desktop

Способ подходит, если сайт недоступен из интернета, например работает на localhost. Claude Desktop запускает на компьютере пользователя мост mcp-remote: он обращается к сайту и передаёт токен в заголовке. Нужен установленный Node.js.

1. Узнайте полный путь к npx командой which npx в терминале macOS или where npx в Windows. Приложение, запущенное не из терминала, может не найти npx по короткому имени.
2. Откройте файл ~/Library/Application Support/Claude/claude_desktop_config.json в macOS или %APPDATA%\Claude\claude_desktop_config.json в Windows.
3. Добавьте сервер в объект mcpServers, указав полный путь к npx, адрес сервера и токен:

1{
2  "mcpServers": {
3    "site": {
4      "command": "/opt/homebrew/bin/npx",
5      "args": [
6        "-y",
7        "mcp-remote",
8        "http://localhost/api/mcp",
9        "--header",
10        "Authorization:${AUTH_HEADER}"
11      ],
12      "env": {
13        "AUTH_HEADER": "Bearer ACCESS_TOKEN"
14      }
15    }
16  }
17}

4. Полностью закройте Claude Desktop и запустите его снова.

Значение заголовка передаётся через переменную AUTH_HEADER, чтобы пробел после Bearer не разделил аргумент. Если mcp-remote отказывается подключаться по http://, добавьте в args параметр --allow-http. Журнал подключения в macOS находится в файле ~/Library/Logs/Claude/mcp-server-site.log.

Документация клиента: mcp-remote.

ChatGPT

Сервер подключается в Codex — агенте приложения ChatGPT. Обычный чат ChatGPT подключить нельзя: он принимает только серверы с OAuth и не передаёт токен в заголовке.

1. Откройте Settings → MCP servers и нажмите Add server.
2. Введите название сервера, например site, и выберите тип Streamable HTTP.
3. В поле URL укажите адрес сервера.
4. Добавьте заголовок Authorization со значением Bearer ACCESS_TOKEN. Поле «Переменная окружения токена Bearer» оставьте пустым: в нём указывается имя переменной, а не токен.
5. Сохраните сервер и нажмите Restart.

Список подключённых серверов показывает команда /mcp в поле ввода. Если в форме нет полей для заголовков, укажите токен в файле настроек Codex. Приложение ChatGPT, Codex CLI и расширение Codex для редакторов используют общие настройки MCP-серверов.

Документация клиента: Model Context Protocol в Codex.

VS Code

Для агента GitHub Copilot:

1. Выполните команду MCP: Add Server из палитры команд.
2. Выберите тип HTTP и укажите адрес сервера.
3. Введите идентификатор сервера, например site, и выберите, где сохранить настройки: для всех проектов или только для текущего.
4. В открывшемся файле mcp.json добавьте серверу заголовок с токеном, как в примере ниже, и сохраните файл.

1{
2  "inputs": [
3    {
4      "type": "promptString",
5      "id": "site-token",
6      "description": "Access-токен MCP-шлюза",
7      "password": true
8    }
9  ],
10  "servers": {
11    "site": {
12      "type": "http",
13      "url": "https://example.com/api/mcp",
14      "headers": {
15        "Authorization": "Bearer ${input:site-token}"
16      }
17    }
18  }
19}

При первом запуске сервера VS Code запросит токен и сохранит его в защищённом хранилище, поэтому в файле токен не хранится.

Документация клиента: MCP servers in VS Code.

Cursor

Добавьте сервер в файл ~/.cursor/mcp.json для всех проектов или в .cursor/mcp.json в корне проекта:

1{
2  "mcpServers": {
3    "site": {
4      "url": "https://example.com/api/mcp",
5      "headers": {
6        "Authorization": "Bearer ${env:MCP_SITE_TOKEN}"
7      }
8    }
9  }
10}

Токен берётся из переменной окружения MCP_SITE_TOKEN. Задайте её в профиле оболочки или в переменных окружения системы и перезапустите Cursor. Подключённые серверы отображаются на странице Customize.

Документация клиента: Model Context Protocol в Cursor.

Командная строка

Этот способ подходит разработчикам. В примерах токен берётся из переменной окружения MCP_SITE_TOKEN: не записывайте его в файлы, которые попадают в репозиторий.

Claude Code

1claude mcp add --transport http site https://example.com/api/mcp \
2  --header "Authorization: Bearer $MCP_SITE_TOKEN"

Оболочка подставит значение переменной при выполнении команды, и токен сохранится в личных настройках Claude Code ~/.claude.json только для текущего проекта. Чтобы сервер был доступен во всех проектах, добавьте параметр --scope user.

Для общего доступа команды опишите сервер в файле .mcp.json в корне проекта. Токен в нём задаётся ссылкой на переменную окружения:

1{
2  "mcpServers": {
3    "site": {
4      "type": "http",
5      "url": "https://example.com/api/mcp",
6      "headers": {
7        "Authorization": "Bearer ${MCP_SITE_TOKEN}"
8      }
9    }
10  }
11}

Проверьте подключение командой claude mcp list или командой /mcp внутри сессии.

Документация клиента: Connect Claude Code to tools via MCP.

Codex

Добавьте сервер в файл настроек ~/.codex/config.toml:

1[mcp_servers.site]
2url = "https://example.com/api/mcp"
3bearer_token_env_var = "MCP_SITE_TOKEN"

Codex читает токен из указанной переменной окружения и передаёт его в заголовке Authorization: Bearer. Настройки действуют и в приложении ChatGPT.

Документация клиента: Model Context Protocol в Codex.

Gemini CLI

1gemini mcp add --scope user --transport http \
2  --header "Authorization: Bearer $MCP_SITE_TOKEN" site https://example.com/api/mcp

С параметром --scope user настройки сохраняются в ~/.gemini/settings.json. Без него сервер добавляется в файл проекта .gemini/settings.json вместе с токеном. Проверьте подключение командой /mcp внутри сессии.

Документация клиента: MCP servers with Gemini CLI.

Ошибки подключения

Если клиент не обновляет токен сам, после окончания срока укажите в его настройках новый access-токен и перезапустите клиент. Как получить токен — в разделе «Доступ и группы» → «Токен».