Claude Code

Claude Code сам входит в Sallyport: токен копировать не нужно, заранее настраивать консоль тоже. Токен из консоли тоже работает, для файла проекта в git.

Подключение

• Выполните команду ниже в терминале. --scope user добавляет Sallyport во все проекты.
• Выполните claude mcp login sallyport или наберите /mcp в Claude Code и выберите sallyport. Браузер откроет Sallyport.
• Войдите или создайте аккаунт и нажмите «Разрешить» на экране согласия. Там написано «После разрешения вы вернётесь в приложение на этом компьютере»: это приложение и есть Claude Code.

claude mcp add --transport http --scope user sallyport https://mcp.sallyport.cloud/mcp

Кнопка «Разрешить» создаёт агента с именем клиента. Агент владельца или администратора сразу получает все подключения рабочего пространства. Агент участника начинает без подключений, и их добавляет администратор в разделе «Доступ». Повторный вход потом занимает одно нажатие «Переподключить».

Подключение с токеном

Claude Code принимает и токен агента в заголовке. Консоль пишет всю команду за вас, вместе с токеном.

• В консоли откройте Агенты, нажмите «Новый агент», введите имя и нажмите «Создать агента».
• На странице агента в блоке «Подключить агента» оставьте выбранным «Claude Code» и нажмите «Скопировать для Claude Code». В копии будет токен, который вы только что создали на этой странице, или новый.
• Выполните скопированную команду в терминале и перезапустите Claude Code. claude mcp list покажет, что sallyport подключён.

claude mcp add --transport http --scope user sallyport https://mcp.sallyport.cloud/mcp \
  --header "Authorization: Bearer YOUR_AGENT_TOKEN"

--scope user делает Sallyport доступным во всех проектах и хранит токен в ~/.claude.json, за пределами ваших репозиториев.

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

Агентов создают только владельцы и администраторы. Новый агент сразу получает все подключения своего рабочего пространства, а список «Доступ» на странице агента это меняет.

Общий файл проекта

Файл .mcp.json проекта попадает в git вместе с кодом. Claude Code подставляет ${VAR} в заголовки, поэтому в файле стоит имя переменной, а токен каждый разработчик держит у себя.

{
  "mcpServers": {
    "sallyport": {
      "type": "http",
      "url": "https://mcp.sallyport.cloud/mcp",
      "headers": { "Authorization": "Bearer ${SP_AGENT_TOKEN}" }
    }
  }
}

Задайте SP_AGENT_TOKEN в оболочке, из которой запускается Claude Code. Вариант «.mcp.json» в консоли копирует тот же файл с уже вписанным токеном, и такую версию в git не добавляйте.

Как различать сессии

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

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

stripe_read     Stripe API (api.stripe.com/v1), reading only. Key: stripe-live.
stripe_write    Stripe API (api.stripe.com/v1). Key: stripe-live. For reads use stripe_read.
http_request    For a host in your list use its own tool.
list_access     Every service you can reach, one short entry each.
get_call        The state of a call by call_id, at once.

Подключение к веб-API даёт два инструмента: _read для чтения и _write для всего остального. Сервер, на котором агент выполняет команды, даёт один инструмент _exec. База данных даёт _query и _execute, а удалённый MCP-сервер приносит свои инструменты. В описании названы ключ и то, что проходит сразу, поэтому агент знает свой доступ до первого вызова.

Когда вызов ждёт человека

По умолчанию вызовы проходят сразу. Вызов ждёт, если вы включили «Спрашивать каждый раз» или поставили классу «Нужно подтверждение» в разделе «Доступ» на странице агента. Ещё он ждёт, когда выходит за бюджет, который вы задали на странице Лимиты.

Пока карточка открыта, Sallyport держит вызов до 4 минут и каждые 10 секунд сообщает о ходе ожидания. В интерактивной сессии Claude Code через 2 минуты уводит вызов в фон и передаёт ответ, когда тот придёт.

Если за 4 минуты ответа нет, агент получает approve_url и call_id, показывает вам ссылку и после вашего ответа повторяет вызов с тем же call_id. Сервис вызывается один раз. Карточка по умолчанию открыта час. Куда приходят карточки, описано на странице Подтверждения.

Не задавайте MCP_TOOL_TIMEOUT и timeout сервера или ставьте их больше 240000. Меньшее значение обрывает ожидание внутри Claude Code, и агент теряет ссылку и call_id.