# Подключение другого клиента MCP {/* #connect-another-mcp-client */}

Эти шаги подходят для AI-агента или редактора с поддержкой удалённых серверов MCP, для которого здесь нет отдельного руководства. Сначала выберите OAuth или персональный токен, как описано в разделе [Перед началом](/docs/ru/connect-ai-agents#before-you-start).

## Добавление сервера {/* #add-the-server */}

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

## Вход через браузер по OAuth {/* #oauth-browser-sign-in */}

Если клиент поддерживает обнаружение 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 ключей отклоняются.

### Клиенты без автоматической регистрации {/* #clients-without-automatic-registration */}

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

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

### Локальный обратный вызов для собственных клиентов {/* #local-callback-for-custom-clients */}

Настройте клиент на прослушивание порта `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-интерфейсу; не открывайте порт в сеть. Одновременно порт может слушать только один процесс входа; завершите текущий вход перед следующим.

### Автоматический возврат в клиент {/* #automatic-return-to-the-client */}

Клиент 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://github.com/modelcontextprotocol/csharp-sdk/blob/main/src/ModelContextProtocol.Core/Authentication/ClientOAuthOptions.cs).

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

При выборе OAuth удалите вручную заданный заголовок `Authorization`. При ошибке обратного вызова [сообщите поддержке](https://reconstruct.dev/support) URI, показанный клиентом.

## Персональный токен доступа {/* #personal-access-token */}

Если OAuth не поддерживается, [создайте токен MCP](/docs/ru/connect-ai-agents#personal-access-token) в настройках платформы и задайте HTTP-заголовок `Authorization` со значением `Bearer <your MCP token>`. Используйте хранилище секретов клиента или переменную `CR_RECONSTRUCT_MCP_TOKEN`, если они поддерживаются.

## Проверка подключения {/* #check-the-connection */}

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

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

Если соединение не установлено, см. [таблицу устранения неполадок](/docs/ru/connect-ai-agents#troubleshooting). После подключения попробуйте [примеры запросов](/docs/ru/prompt-examples).