Запись MCP-сервера — небольшой кусок JSON с беспощадным способом отказа: если ключ неверен, ошибки не будет, сервер просто не появится. Каждому транспорту нужна своя форма — локальному команда и аргументы, удалённому URL и обычно заголовок, — а смешение даёт файл, который выглядит законченным и не делает ничего. Конструктор спрашивает только те поля, которые выбранный транспорт действительно использует, предупреждает, если заполнено поле другого, и отмечает, вероятно, самую частую ошибку на практике: живой секрет, записанный в файл, который попадёт в репозиторий. Он выдаёт и файл конфигурации, и равнозначную однострочную команду.
Возможности
Только те поля, которые использует выбранный транспорт
Предупреждает, когда заполнено поле другого транспорта
Отмечает похожий на настоящий секрет в файле, но не плейсхолдер
Предупреждает о незашифрованном HTTP к удалённому хосту, молчит про localhost
Ловит аргументы, попавшие в поле команды
Переменные окружения и заголовки как редактируемые пары
Выдаёт и файл проекта, и конфиг настольного приложения
Равнозначная команда с правильным экранированием
Как использовать Конфигурация MCP-сервера
Назовите сервер — так группируются его инструменты
Выберите используемый транспорт
Заполните команду и аргументы либо URL и заголовки
Скопируйте JSON в конфигурацию или выполните команду
Пример
Ввод
"command": "npx -y some-server"
Результат
Warning: looked up as a single executable with that name
Первое слово — команда; всё остальное аргументы.
Частые ошибки и устранение неполадок
Сервер так и не появляется. — Обычно перепутана форма: запись stdio с url или удалённая с command. Оба случая отмечаются здесь, потому что сами по себе они не дают ошибки.
Команда не найдена. — Аргументы идут отдельно. В поле команды — npx, остальное в список аргументов: команда с пробелами ищется как один исполняемый файл с таким именем.
У меня работает, у других нет. — Обычно в аргументах абсолютный путь с вашей машины или учётные данные из вашего окружения, которых больше ни у кого нет.
У меня токен в файле конфигурации. — Сошлитесь на переменную окружения. Похожий на настоящий секрет здесь отмечается, потому что конфиги попадают в репозиторий.
Часто задаваемые вопросы
Какой транспорт выбрать?
stdio для всего, что вы запускаете локально: клиент стартует его как процесс и общается через стандартный ввод-вывод. HTTP для удалённого сервера. SSE существует в основном для серверов, написанных до того, как HTTP стал обычным выбором.
Где лежит файл конфигурации?
Файл проекта живёт в репозитории, чтобы у команды были одни и те же серверы; у настольного приложения свой конфиг для серверов, нужных везде. Выдаются обе формы, путь показывается.
Как не держать токен в файле?
Запишите ссылку на переменную окружения вместо значения. Проверка смотрит, похоже ли значение на настоящие учётные данные или на плейсхолдер, и жалуется только на первое.
Файл или команда?
Они делают одно и то же. Файл лучше, когда нужно версионировать вместе с проектом; команда быстрее, когда просто пробуете. Оба берутся из одних и тех же полей.
Почему важно имя сервера?
Это ключ, под которым хранится запись, и пространство имён его инструментов, поэтому два сервера не могут его делить, а переименование меняет то, как на эти инструменты ссылаются везде.
Связанные инструменты
Схема инструмента MCP — Опишите инструмент и получите JSON Schema с проверкой строгого режима.