Перейти к основному содержимому

Подключение другого клиента MCP

Эти шаги подходят для AI-агента или редактора с поддержкой удалённых серверов MCP, для которого здесь нет отдельного руководства. Сначала выберите OAuth или персональный токен, как описано в разделе Перед началом.

Добавление сервера​

  1. Откройте настройки серверов MCP клиента и добавьте сервер reconstruct.
  2. Выберите Streamable HTTP (иногда называется HTTP или remote HTTP).
  3. Укажите URL сервера https://reconstruct.dev/mcp.

Вход через браузер по OAuth​

Если клиент поддерживает обнаружение OAuth и динамическую регистрацию клиентов (DCR), добавьте только https://reconstruct.dev/mcp, выберите OAuth и подключитесь. Клиент зарегистрирует собственный адрес обратного вызова, откроет вход Reconstruct и автоматически получит обратный вызов после разрешения доступа. Вводить ID клиента или порт вручную не требуется.

Размещённые приложения могут зарегистрировать точный HTTPS-адрес на публичном домене, например https://app.example.com/mcp/callback. Нативные приложения могут зарегистрировать точный HTTP-адрес на 127.0.0.1 или localhost с явным портом. Обратный вызов принадлежит клиенту и обрабатывается им, а не сервером MCP. Регистрация требует PKCE S256, согласия пользователя и областей только MCP. Подстановки, HTTP-адреса вне loopback, фрагменты и удалённые URL ключей отклоняются.

Клиенты без автоматической регистрации​

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

  1. Укажите ID reconstruct-mcp, области openid aud-mcp и оставьте секрет клиента пустым.
  2. Задайте локальный порт обратного вызова OAuth 58234 и путь /callback.
  3. Сохраните и подключитесь, войдите в браузере, разрешите доступ и вернитесь в клиент.

Локальный обратный вызов для собственных клиентов​

Настройте клиент на прослушивание порта 58234 на вашем компьютере с одним из точных URI перенаправления:

  • http://127.0.0.1:58234/callback
  • http://localhost:58234/callback

Клиент должен поддерживать код авторизации с PKCE (S256). Используйте ID reconstruct-mcp, области openid aud-mcp и не задавайте секрет клиента. URI перенаправления при входе и обмене токена должен точно совпадать с настроенным.

Порт 58234 нужен только для локального обратного вызова браузера. URL удалённого сервера MCP остаётся https://reconstruct.dev/mcp по HTTPS. Привяжите обработчик к loopback-интерфейсу; не открывайте порт в сеть. Одновременно порт может слушать только один процесс входа; завершите текущий вход перед следующим.

Автоматический возврат в клиент​

Клиент MCP должен запустить локальный обработчик до открытия браузера. После входа и согласия Keycloak перенаправляет браузер на него; клиент получает ответ авторизации, обменивает код с PKCE и возобновляет соединение MCP. Пользователю не должно требоваться вручную копировать URL обратного вызова или код авторизации.

Muse Code, Grok Build, Codex и Claude Code могут использовать общий порт согласно своим руководствам. Клиенты с собственным фиксированным адресом, например Cursor или Claude Desktop, сохраняют поддерживаемые ими адреса.

Для собственного C#-приложения настройте ClientOAuthOptions.RedirectUri и реализуйте AuthorizationCallbackHandler, который открывает браузер и получает code, state и iss. Один URI не создаёт обработчик; стандартный обработчик SDK запрашивает URL перенаправления вручную. См. официальные параметры OAuth SDK C#.

Издатель — https://reconstruct.dev/sso/realms/reconstruct; используйте обнаруженные конечные точки авторизации и токенов вместо конструирования корневых /authorize и /token.

При выборе OAuth удалите вручную заданный заголовок Authorization. При ошибке обратного вызова сообщите поддержке URI, показанный клиентом.

Персональный токен доступа​

Если OAuth не поддерживается, создайте токен MCP в настройках платформы и задайте HTTP-заголовок Authorization со значением Bearer <your MCP token>. Используйте хранилище секретов клиента или переменную CR_RECONSTRUCT_MCP_TOKEN, если они поддерживаются.

Проверка подключения​

Переподключите или перезапустите клиент. Убедитесь, что list_products есть в списке инструментов, затем попросите агента вызвать его.

Единого формата JSON для всех клиентов нет. Одни используют mcpServers, другие — servers или mcp; некоторым нужно поле type. Точные имена и синтаксис подстановки токенов смотрите в документации клиента. Клиент только с устаревшим SSE не может использовать HTTP-точку /mcp Reconstruct как SSE.

Если соединение не установлено, см. таблицу устранения неполадок. После подключения попробуйте примеры запросов.