Подключение других MCP-клиентов

Помимо Claude и ChatGPT подойдёт любой MCP-клиент, который поддерживает удалённые серверы по HTTP и вход через OAuth, — например IDE вроде Cursor или MCP Inspector для тестирования. Эта статья для тех, кто сам настраивает такой клиент или создаёт собственную интеграцию.

#Основные данные

URL сервера

https://dock.at-harbor.com/mcp

Транспорт

Streamable HTTP без состояния. Каждый запрос — это POST с сообщением JSON-RPC (или пакетом сообщений), ответ приходит в виде JSON. Нет ни ID сессии, ни серверного потока.

Версии протокола

2025-11-25, 2025-06-18 и 2025-03-26

Методы

initialize, ping, tools/list и tools/call. Ресурсы (resources) и промпты (prompts) сервер не предоставляет.

Вход

OAuth 2.1 с PKCE (S256). Без токена сервер отвечает кодом 401 и указывает на свои метаданные в заголовке WWW-Authenticate.

#Настройка клиента

1. Добавьте в клиенте удалённый MCP-сервер (часто это называется «Remote», «HTTP» или «Streamable HTTP»)
2. Укажите https://dock.at-harbor.com/mcp в качестве URL
3. Оставьте client ID и secret пустыми — клиент регистрируется сам
4. Запустите подключение; в браузере откроется вход, а затем страница согласия LinkHarbor
5. Выберите рабочее пространство и разрешения и нажмите «Разрешить»

Как называется эта настройка, зависит от программы. В MCP Inspector, например, нужно выбрать транспорт «Streamable HTTP».

#OAuth-процесс подробно

1. Клиент обращается к MCP-серверу без токена и получает 401 с указанием на метаданные ресурса
2. Он читает метаданные сервера авторизации (эндпоинты, поддерживаемые методы, разрешения)
3. Он регистрируется: через Dynamic Client Registration или с документом метаданных клиента по https-адресу
4. Он открывает браузер с запросом авторизации, включая PKCE и resource=https://dock.at-harbor.com/mcp
5. Вы входите в аккаунт и принимаете решение на странице согласия
6. Клиент обменивает код на access token и refresh token

Если клиент не запрашивает никаких разрешений, запрашиваются все; на странице согласия их всё равно можно сузить. Если уже заменённый refresh token используется повторно, LinkHarbor из соображений безопасности завершает всё подключение.

#Правила для адресов перенаправления

• Адреса https
• http — только для loopback-адресов на вашем собственном компьютере (для десктопных клиентов и IDE)
• Собственные схемы приложений в обратной доменной нотации
• Не больше 10 адресов на клиент, без фрагментов

Если приложение присылает адрес, который для него не зарегистрирован, LinkHarbor останавливает процесс: «Приложение прислало адрес возврата, который для него не зарегистрирован. Запрос остановлен.»

#Адреса обнаружения для разработчиков

#Неизвестные приложения

Приложения, у которых все адреса перенаправления находятся на claude.ai, claude.com, chatgpt.com или openai.com, считаются известными. Для программ на вашем собственном компьютере, которые возвращаются через localhost, — например Claude Code, Codex и IDE — на странице согласия показывается подсказка «LinkHarbor не знает это приложение. Оно работает на вашем собственном компьютере. Продолжайте, только если вы только что сами его запустили», а внизу — «После выбора вы вернётесь в приложение на своём компьютере». Другие неизвестные веб-приложения показывают «LinkHarbor не знает это приложение. Продолжайте, только если вы сами это начали и доверяете …», где вместо многоточия стоит их адрес. Обе подсказки нормальны, если вы только что сами настроили клиент. Логотип появляется, только если приложение его передаёт. Если вы не начинали вход сами, нажмите «Отклонить».