Перейти к документации
ДокументацияMCP

MCP-клиенты и удалённые серверы

Подключите к Sallyport Claude Code, Cursor, Codex, Claude, ChatGPT и другие MCP-клиенты и дайте агентам удалённые MCP-серверы.

На этой странице

Адрес

Любой MCP-клиент подключается к https://mcp.sallyport.cloud/mcp по Streamable HTTP. Работают клиенты и на ревизии MCP 2026-07-28, и на более ранних.

Большинство клиентов подключаются через вход: вы добавляете адрес, входите в Sallyport в браузере и нажимаете «Разрешить». Токен копировать не нужно, заранее настраивать консоль тоже. Скрипты и клиенты без входа вместо этого передают токен агента в заголовке Authorization: Bearer.

Подключение через вход

Так подключаются Claude, Claude Code, ChatGPT, Codex, Cursor, VS Code, Gemini CLI и MCP Inspector. Куда вписать адрес, показано на странице каждого клиента в разделе Интеграции.

  • Добавьте https://mcp.sallyport.cloud/mcp как MCP-сервер в своём клиенте.
  • Клиент сам регистрируется в Sallyport и открывает его в браузере.
  • Войдите или создайте аккаунт. Подключение ждёт вас 30 минут, этого хватит, чтобы подтвердить почту.
  • Прочитайте экран согласия «Разрешить клиенту … подключить агента» и нажмите «Разрешить». Браузер вернётся в клиент, и клиент подключён.

Экран согласия

«Кто просит доступ» называет клиента. Клиент, известный по собственному сайту, помечен «Домен подтверждён» с этим доменом, а также «Издатель: Anthropic» для claude.ai или «Издатель: OpenAI» для chatgpt.com. Клиент, который зарегистрировался сам, помечен «Не проверен» с пояснением «Этот клиент зарегистрировался сам. Sallyport не смог проверить его название.»

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

«Что сможет использовать агент» перечисляет сервисы с пометкой «Работает сразу» или «Сначала спросит вас». Для нового агента участника там написано «Пока ничего. Сервисы этому агенту выдаёт администратор в консоли.»

В «Подробности» лежат ID клиента, адрес возврата и, если рабочих пространств несколько, выбор пространства для агента.

Что делает «Разрешить»

Sallyport создаёт агента с именем клиента. Агент владельца или администратора получает все сервисы рабочего пространства. Агент участника начинает без сервисов, пока администратор не добавит их в разделе «Доступ» на странице агента.

Когда человек впервые подключает клиент, каждый владелец получает уведомление со ссылкой, которая его отключает. Журнал записывает каждое согласие.

Клиент входит снова из новой сессии, с нового порта или когда продлевает доступ. Пока агент активен, вы увидите короткий экран «Переподключить Claude Code» с одной кнопкой «Переподключить». Клиент ничего не получит, пока вы её не нажмёте. Владельцев повторно не уведомляют. Если агента приостановили, снова откроется полный экран согласия. Если его удалили, повторный вход станет новым подключением, и каждый владелец получит уведомление.

Подключённые приложения

«Настройки», «Подключённые приложения» показывает все ИИ-клиенты, которые вошли в Sallyport. Участники видят и отключают свои. Владельцы и администраторы видят и отключают все.

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

Платформы с агентом на каждую машину

Платформа, которая запускает агентов на своих машинах, например detachbox, подключается один раз. Экран согласия у неё короткий: кто просит, куда вы вернётесь, и три строки. detachbox сможет создать агента для каждой своей машины, видеть ваших агентов и добавлять их в чаты. Переименовать, поставить на паузу или удалить он может только созданных им агентов. Каждый новый агент начинает без доступа, и что может каждый, выбираете вы. Само подключение не агент и ничем не пользуется, поэтому списка сервисов на карточке нет.

У каждой машины свой агент, поэтому «Активность» и одобрения показывают, какая машина позвонила. Агент новой машины ничем не пользуется. detachbox отправляет вас на его страницу, вы выбираете его сервисы или копируете доступ другого агента, и «Готово» возвращает вас обратно. «Подключённые приложения» показывают, сколькими агентами управляет приложение, каждого с его машиной. Пауза одного агента останавливает одну машину. «Отключить» останавливает их все, а при новом подключении они возвращаются со своим доступом. Все машины одного подключения считаются одним агентом на любом тарифе.

Получите токен агента

Токен подходит для скрипта, файла проекта в git или клиента без входа. Откройте агента в разделе Агенты. Блок «Подключить агента» копирует готовую настройку для Claude Code, Cursor или файла .mcp.json в проекте. В неё попадает токен, который вы только что создали кнопкой «Новый токен», или новый.

Для другого клиента нажмите «Новый токен» в разделе «Токены» и скопируйте его: он показывается один раз. Токен обозначает агента и его доступ. Ключей сервисов в нём нет.

Кнопка с корзиной рядом с токеном отзывает его. Поле «Разрешённые IP-адреса (необязательно)» в разделе «Лимиты» ограничивает, откуда работают токены агента.

Claude Code с токеном

Нажмите «Скопировать для Claude Code» и выполните команду в терминале. --scope user добавляет Sallyport во все проекты. Проверьте через claude mcp list и перезапустите Claude Code.

Shell · та же команда, набранная вручную
export SP_AGENT_TOKEN='<agent-token>'
claude mcp add --transport http --scope user sallyport https://mcp.sallyport.cloud/mcp --header "Authorization: Bearer $SP_AGENT_TOKEN"

Вкладка «Вставить в Claude» даёт вместо команды сообщение. Нажмите «Скопировать сообщение для Claude», вставьте его в чат Claude Code, и Claude выполнит команду сам.

«Подписать каждую сессию Claude Code» делается по желанию. Нажмите «Скопировать хук сессии для Claude» и вставьте его в Claude Code. Тогда у каждого вызова видно, из какой сессии и папки он пришёл.

Cursor и файл .mcp.json в проекте

«Скопировать для Cursor» даёт такой текст для ~/.cursor/mcp.json с уже подставленным токеном:

JSON · ~/.cursor/mcp.json
{
  "mcpServers": {
    "sallyport": {
      "url": "https://mcp.sallyport.cloud/mcp",
      "headers": {
        "Authorization": "Bearer <agent-token>"
      }
    }
  }
}

«Скопировать .mcp.json» даёт то же самое с "type": "http" для файла .mcp.json проекта в Claude Code. В этом файле лежит токен, поэтому не добавляйте его в git.

Codex CLI, Gemini CLI и VS Code с токеном

Эти клиенты настраиваются вручную с тем же адресом и токеном.

TOML · ~/.codex/config.toml
[mcp_servers.sallyport]
url = "https://mcp.sallyport.cloud/mcp"
bearer_token_env_var = "SP_AGENT_TOKEN"
tool_timeout_sec = 300

Codex берёт токен из переменной SP_AGENT_TOKEN в окружении, из которого он запускается. Sallyport держит вызов, который ждёт подтверждения, открытым не дольше 240 секунд. С tool_timeout_sec = 300 Codex дождётся конца этого срока; по умолчанию он ждёт 60 секунд.

JSON · ~/.gemini/settings.json
{
  "mcpServers": {
    "sallyport": {
      "httpUrl": "https://mcp.sallyport.cloud/mcp",
      "headers": {
        "Authorization": "Bearer <agent-token>"
      }
    }
  }
}
JSON · пользовательский mcp.json в VS Code
{
  "servers": {
    "sallyport": {
      "type": "http",
      "url": "https://mcp.sallyport.cloud/mcp",
      "headers": {
        "Authorization": "Bearer <agent-token>"
      }
    }
  }
}

Gemini CLI принимает адрес в httpUrl. В VS Code файл открывает команда «MCP: Open User Configuration». Замените <agent-token> и держите эти файлы вне репозиториев.

Что видит агент

Каждый сервис приходит к агенту как инструменты с его именем. У HTTP-сервиса их два: github_read берёт только чтение, а github_write любые вызовы. Оба принимают method и полный path из документации API сервиса:

JSON · аргументы github_read
{
  "method": "GET",
  "path": "/user"
}

База данных даёт инструменты _query и _execute, а SSH-хост даёт _exec для команд и _sftp_read с _sftp_write для файлов. Почтовый ящик даёт _read, _send и _change. Инструменты удалённого MCP-сервера сохраняют свои имена после имени подключения. У каждого агента есть и встроенные инструменты:

ИнструментЧто делает
list_accessВсе сервисы, доступные агенту: инструменты, что выполняется сразу, что ждёт человека и работает ли ключ.
http_requestВызывает любой публичный HTTPS-адрес. Хост без ключа превращается в запрос доступа со ссылкой для вас.
request_accessПросит доступ к сервису по хосту или названию и передаёт purpose человеку, который выдаёт доступ.
get_callСостояние вызова, в том числе ожидающего подтверждения.
list_requestsЗапросы доступа агента: открытые, выполненные и отклонённые с причиной.
cancel_requestОтзывает запрос доступа или собственный вызов агента, который ждёт человека.
ssh_execВыполняет команду на SSH-хосте по имени хоста. Появляется, когда у агента есть SSH-хост; хост вне списка превращается в запрос доступа со ссылкой для вас.
fetch_bodyОстаток длинного ответа.
feedbackЗаписка команде Sallyport о том, что мешало агенту.
search_tools, callПоявляются, когда в списке больше 40 инструментов: находят инструмент удалённого MCP-сервера и запускают его.

Вызов, который ждёт человека, сразу сообщает об этом клиенту, если клиент прислал progressToken. Это уведомление о прогрессе и все следующие уведомления вызова несут _meta с sallyport.cloud/call_id и sallyport.cloud/approve_url. Ссылка на одобрение есть и в тексте сообщения, поэтому её покажет любой клиент.

Подключите удалённый MCP-сервер

Откройте Удалённый MCP. Укажите «URL MCP-сервера»: полный HTTPS-адрес с нестандартным портом, если он есть, и путём, например https://mcp.example.com/mcp.

Выберите «Авторизация»: «Без авторизации», «Bearer-токен», «Basic», «Ключ API» в заголовке или параметре URL либо «OAuth 2.1». Нажмите «Сохранить ключ и создать подключение».

Инструменты сервера получат все агенты рабочего пространства. Sallyport соединяется с сервером, подставляет его ключ и возвращает результаты. Агент при этом подключён только к https://mcp.sallyport.cloud/mcp.

Вход на сервер через OAuth 2.1

С вариантом «OAuth 2.1» сохранение открывает страницу входа сервера, а затем возвращает вас к подключению. Sallyport хранит токены и продлевает их.

На серверах, которые это позволяют, Sallyport регистрируется сам. Для остальных зарегистрируйте приложение с адресом возврата https://mcp.sallyport.cloud/callback/upstream. Его ID введите в «ID приложения (необязательно)», а секрет, если он есть, в соседнее поле.

Когда доступ закончится, нажмите «Переподключить через OAuth» на странице подключения.