Способы подключения

Способов три. Разница между ними в одном: как ассистент доказывает серверу, что он — это вы.

Способ	Что нужно	Где это вводится	Когда выбирать
Вход учётной записью	ничего	окно браузера	почти всегда
Токен в настройке	токен из настроек пространства	файл настроек клиента	там, где браузера нет
Переходник	Node.js	файл настроек клиента	клиент умеет только локальные серверы

Вход учётной записью

Вы даёте клиенту только адрес сервера. Он сам открывает окно входа, узнаёт вас по уже открытой сессии и показывает экран согласия: что приложение сможет делать и с какого пространства начнёт. Нажали «Разрешить» — подключено.

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

Так умеют Claude в вебе и в приложении, Claude Code, Cursor, VS Code, Windsurf, Cline, Zed — все, кто поддерживает удалённые серверы по протоколу.

Доступ выдаётся ко всем вашим пространствам

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

Токен в настройке

Токен выпускается в настройках рабочего пространства и передаётся заголовком:

{
  "mcpServers": {
    "mcp": {
      "url": "https://ваш-адрес/mcp",
      "headers": { "Authorization": "Bearer ВАШ_ТОКЕН" }
    }
  }
}

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

Слово Bearer можно опустить: сервер принимает и голое значение.

Подробно о выпуске — на странице Токен доступа.

Переходник

Некоторые клиенты умеют запускать серверы только у себя на машине. Между таким клиентом и сервером ставится переходник mcp-remote: он принимает локальное подключение и передаёт запросы дальше.

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": ["mcp-remote", "https://ваш-адрес/mcp"]
    }
  }
}

Нужен Node.js. Переходник умеет оба способа: без токена он сам проведёт вход учётной записью, а с --header "Authorization:Bearer ВАШ_ТОКЕН" — передаст токен.

Что можно настроить сверх этого

Сузить каталог. Заголовок X-Mcp-Profile оставляет ассистенту один раздел вместо всех: core — четырнадцать инструментов вместо ста с лишним, минус девяносто процентов контекста ещё до первого вопроса. Подробнее — Срезы каталога.

Перечислить инструменты поимённо. Заголовок X-Mcp-Tools — самый узкий вариант, когда нужен ровно известный набор.

Что именно проверено

Разница между «должно работать» и «проверено» здесь существенная, поэтому названа прямо.

Проверено на живом сервере — вся цепочка входа, которую проходит любая программа: отказ без токена с указанием, где авторизоваться; сведения о ресурсе и о сервере входа; регистрация программы с возвратом запрошенного адреса — во всех трёх видах, включая петлевые адреса со случайным портом. Отдельно проверено, что переходник соединяется и поднимает мост, и что работа по токену отдаёт каталог и сужается заголовком среза.

Не проверено — проход по шагам внутри Cursor, VS Code, Windsurf, Cline, Zed. Они говорят на том же протоколе, и цепочка выше у них общая, но «говорит на том же протоколе» и «проверено» — разные вещи.

Python: OpenAI Agents SDK

Единственный рецепт, которого нет выше: подключение из кода, а не из готового клиента.

from agents.mcp import MCPServerStreamableHttp

mcp = MCPServerStreamableHttp(
    url="https://ваш-сервер/mcp",
    headers={"Authorization": "Bearer ВАШ_ТОКЕН"},
)

Здесь токен обязателен: окна входа у кода нет, и открыть его некому. Как выпустить токен — на соседней странице.

Чего сервер не умеет

Работать без человека. Обмен «программа за программу», без чьего-либо входа и без выпущенного человеком токена, не поддерживается: каждое подключение восходит к конкретной учётной записи.