Подключение MCP-клиента
Выберите способ подключения и предварительно проверьте разрешения текущей копии.
Подключение клиента
- Запустите Protohaund, активируйте лицензию и выберите один из бета-модулей.
- В
Settings → MCP Server → Agent accessвключитеEnable for this instance. - Задайте понятное
Instance name, особенно если одновременно открыто несколько копий. - В
MCP Server → MCP Bridge → Agent connectionвыберитеTransport → stdioи скопируйтеCommandиArguments. Если мост уже работает с другим транспортом, нажмитеRestart. - Добавьте локальный сервер в своём MCP-клиенте: команда — скопированный абсолютный путь, транспорт —
stdio, аргументы — пустой список[].
Клиент запускает соединитель и обменивается с ним сообщениями через стандартный ввод и вывод. Запуск видимого окна McpBridge сам по себе не добавляет сервер в настройки клиента. Настройки внешнего клиента Protohaund автоматически не изменяет.
Запускайте клиент и приложение от одного пользователя Windows с одинаковым уровнем привилегий. Каждый MCP-клиент использует собственное подключение.
Подключение через HTTP
Streamable HTTP выбран по умолчанию для новых настроек и работает на этом же компьютере. Сохранённый выбор транспорта сохраняется.
- В
Settings → MCP Server → MCP Bridge → Agent connectionвыберитеTransport → Streamable HTTP. - При необходимости измените
Port, затем нажмитеStartилиRestart. - Скопируйте
URLиAccess tokenкнопками с иконкой копирования рядом с полями. - В MCP-клиенте выберите Streamable HTTP, укажите скопированный адрес и ключ Bearer. Если клиент предлагает заголовки HTTP, задайте
Authorization: Bearer <скопированный ключ>.
Ключ скрыт звёздочками. Иконка глаза показывает и скрывает его, иконка обновления в поле создаёт новый ключ. В поле можно вставить или ввести собственный ключ: от 32 до 256 символов без пробелов. Enter или переход из поля сохраняет изменение, Esc отменяет незавершённый ввод. После замены ключа приложение предлагает перезапустить мост. Выберите Restart, чтобы применить ключ сразу, или Later, чтобы отложить перезапуск. После перезапуска обновите ключ в настройках агентов и подключите их заново.
Адрес по умолчанию — http://127.0.0.1:52738/mcp. Подключения с других компьютеров не поддерживаются. Мост должен работать до подключения клиента. Изменение порта и транспорта применяется при запуске или перезапуске моста; после перезапуска подключите клиент заново. Транспорты используются по отдельности: запуск HTTP завершает прежние подключения stdio и запрещает новые. Для возврата выберите stdio и перезапустите мост. Если порт занят, выберите другой. При HTTP 401 проверьте ключ доступа в настройках клиента. Разрешения текущей копии действуют одинаково для обоих вариантов подключения.
Если клиент не подключается
| Состояние | Проверка |
|---|---|
Пустой instances_list | Приложение запущено, лицензия действует, доступ включён, пользователь Windows совпадает |
License required | Активация, общий срок лицензии и автономный доступ в Account |
PermissionDenied | Локальные разрешения, текущий модуль и права лицензии |
InstanceUnavailable | Повторить обнаружение и выбрать актуальный адрес копии |
ContextChanged | Перечитать состояние и условия действия; не повторять изменение автоматически |
IncompatibleVersion | Использовать McpBridge из совместимой поставки и переподключить клиент |
Для ошибок запуска смотрите состояние в MCP Bridge и технический журнал.