stdio или HTTP: два способа связи

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

stdio — локальный подпроцесс

С транспортом stdio Claude Code запускает сервер прямо на твоей машине как отдельный процесс и общается с ним через стандартный ввод-вывод (stdin/stdout). Это вариант для инструментов, которые работают локально: доступ к твоим файлам, к локальной базе, к выгрузке из 1С, лежащей на диске.

Плюсы: ничего не уходит в сеть, нет URL, не нужен аккаунт. Сервер живёт ровно столько, сколько идёт сессия.

HTTP — удалённый сервер

С HTTP-транспортом сервер уже где-то запущен — в облаке или на другом хосте, — а Claude Code ходит к нему по сети на заданный URL. Это вариант для облачных сервисов: внешний трекер задач, чужое API, общий сервер команды.

Как выбрать

Вопрос простой: где находится то, к чему ты подключаешься?

Данные и инструмент на этой машине — бери stdio.
Сервис в облаке, есть URL — бери HTTP.

Совет

Если сомневаешься: у локального сервера ты указываешь команду запуска, у удалённого — адрес (URL). Нет команды запустить — значит, это HTTP.

Заметка

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

Практика в терминале

Закрепи разницу руками: подключи в тренажёре локальный сервер files через stdio (команда запуска после --) и удалённый docs через HTTP (флаг --transport http и URL). Затем выведи claude mcp list и обрати внимание, как у каждого сервера подписан его транспорт.

Проверь себя

Отвечено 0/3

Режим:

Когда уместен транспорт stdio?

Сервис задач работает в облаке и даёт тебе URL. Какой транспорт выбрать?

Что меняется при смене транспорта со stdio на HTTP?

Вопросы и ответы по уроку

Когда уместен транспорт stdio?

stdio запускает сервер локальным подпроцессом и общается через stdin/stdout — это для локальных инструментов и данных.