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

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

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

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

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

Ручной токен вводить не нужно. Клиент хранит выданные ему OAuth-данные доступа; подключение можно отключить в его настройках. Это не удаляет созданные задачи или страницы.

Основные рецепты для ChatGPT, Claude, Claude Code, Cursor и VS Code — на странице подключения. Поддержка удалённого MCP и поддержка OAuth — разные возможности; для других клиентов проверьте их документацию.

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

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

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

Токен выпускается в настройках аккаунта и передаётся заголовком. Пример для клиентов, которые поддерживают этот формат:

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

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

Используйте полный заголовок Authorization: Bearer ...: это стандартная форма, совместимая с MCP-клиентами. Значение токена храните вне Git и истории переписки.

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

Переходник

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

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

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

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

Сузить каталог. Параметр ?profile=pages или заголовок X-Mcp-Profile оставляет нужный набор вместо всего каталога. Актуальный состав и измерения — Срезы каталога.

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

Как проверить своё подключение

Начните с чтения: попросите назвать текущую учётную запись, доступные пространства и проекты. Проверьте, что инструмент действительно вызван и область ответа совпадает с нужной. Только после этого пробуйте запись в заранее выбранный тестовый объект.

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

Python: OpenAI Agents SDK

Для Python-клиента установите openai-agents. Этот пример открывает MCP-соединение и читает каталог; модель и ключ OpenAI для самого чтения каталога не нужны. Задайте MCP_URL и MCP_TOKEN в окружении, не в исходниках.

import asyncio
import os
from agents.mcp import MCPServerStreamableHttp

async def main():
    async with MCPServerStreamableHttp(
        name="workspace",
        params={
            "url": os.environ["MCP_URL"],
            "headers": {"Authorization": f"Bearer {os.environ['MCP_TOKEN']}"},
        },
    ) as server:
        tools = await server.list_tools()
        print([tool.name for tool in tools])

asyncio.run(main())

Здесь используется ручной токен. Для OAuth из собственного кода нужна отдельная реализация входа и обновления доступа. Конструктор и транспорт описаны в OpenAI Agents SDK.

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

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