Все статьи

Подключите Unitcore к Claude

Unitcore подключается к Claude как коннектор: вы добавляете адрес сервера, входите в свой аккаунт Unitcore и подтверждаете доступ. После этого Claude обращается к вашим данным от вашего имени и ровно в тех границах, которые видите вы сами.

Подключение занимает пару минут и делается один раз на аккаунт: коннектор, добавленный в браузере, дальше доступен и в десктопном приложении, и на телефоне.

Подключить в один клик

Добавить Unitcore в Claude

Откроется claude.ai с уже вписанными именем и адресом сервера. Ссылка только заполняет форму: добавить коннектор и войти в Unitcore всё равно предстоит вам.

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

Remote MCP server URL

https://unitcore.io/api/mcp

Ни ключей, ни токенов, ни паролей вводить никуда не нужно — доступ выдаётся через ваш обычный аккаунт Unitcore.

Настраивать ничего не придётся. Claude сам обратится к серверу и подставит обе настройки авторизации, пометив их Detected, — в диалоге можно сразу нажать Add. Что означают переключатели и почему их лучше не трогать — в шаге 3.

Перед началом

  • Войдите в Unitcore в этом же браузере. Тогда на шаге авторизации вы сразу увидите экран согласия, без повторного входа.
  • Аккаунт Claude подойдёт любой, включая бесплатный. На бесплатном тарифе доступен один свой коннектор, так что слот стоит потратить осознанно.
  • Team или Enterprise: свои коннекторы добавляет владелец организации. Ему нужна та же ссылка, но на админскую страницу; вам после этого останется нажать Connect.

Шаг 1. Откройте диалог коннектора

Кнопка выше открывает его сразу. Руками — так:

Где вы работаетеЧто сделать
Claude в браузереАватар в правом верхнем углу → SettingsCustomizeConnectors
Claude Desktop⌘ , или Ctrl ,CustomizeConnectors
Claude на телефонеКоннекторы добавляются только с компьютера. Добавленный один раз, он появится на телефоне сам

В разделе Connectors нажмите + и выберите Add custom connector.

Шаг 2. Имя и адрес

Name

Unitcore

Remote MCP server URL

https://unitcore.io/api/mcp

Имя — просто подпись, по которой вы узнаете своё подключение в списке коннекторов; на права оно не влияет.

Шаг 3. Нажмите Add

Claude уже обратился к серверу и выбрал обе настройки авторизации сам. Рядом с ними стоит пометка Detected — это вывод из проверки вашего адреса, а не значение по умолчанию:

БлокЧто выбрано
AuthenticationAlways required — сервер требует вход всегда
OAuth clientNo client ID — register one automatically — клиент регистрируется динамически

Поле Request headers остаётся пустым: API-ключей здесь нет. Нажмите Add.

Почему остальные переключатели не подойдут

Use Anthropic's hosted client metadata помечен как Recommended, но это общий совет Claude, а не вывод о вашем сервере. Этот способ Claude выбирает, только когда сервер авторизации объявляет поддержку client id metadata document. Сервер Unitcore её не объявляет — поэтому пометка Detected стоит у соседнего пункта. Переключите вручную, и подключение оборвётся на возврате из браузера.

Use your own OAuth client просит client id, который вы зарегистрировали заранее сами. У Unitcore такого пути нет: клиенты регистрируются динамически, и на каждое подключение выдаётся свой.

Required when the server asks и None в блоке Authentication говорят Claude, что часть инструментов работает без входа. Здесь это не так: на запрос без токена сервер отвечает 401, и подключение без авторизации не даст ничего.

Настройки авторизации нельзя изменить у уже добавленного коннектора. Если переключили и подключение сломалось — Remove и добавить заново.

Шаг 4. Вход и экран согласия

В списке коннекторов появится карточка. Нажмите Connect — откроется окно браузера, и если вы ещё не вошли в Unitcore, сначала будет форма входа.

Дальше — экран согласия Unitcore. На нём стоит действительно посмотреть три строки:

  • Client — имя клиента, который просит доступ;
  • Redirects to — куда вас вернут; у Claude это https://claude.ai/api/mcp/auth_callback;
  • Signed in as — ваш ли это аккаунт Unitcore.

Кнопка Allow access выдаёт токен, Deny завершает процесс, и доступ не выдаётся. После подтверждения окно закроется само, а карточка коннектора станет активной.

Шаг 5. Включите коннектор в разговоре

Коннектор подключён к аккаунту, но в каждом чате включается отдельно: в поле ввода нажмите +Connectors и включите переключатель рядом с Unitcore.

Шаг 6. Проверьте, что всё работает

Покажи мои пространства в Unitcore

Claude попросит подтвердить вызов инструмента — нажмите Allow или Allow always, чтобы не подтверждать каждый раз. В ответе должно быть ваше личное пространство: оно создаётся автоматически при регистрации. Видите его — подключение завершено.

Почему это безопасно подключать

Подключение AI-клиента к своим данным заслуживает большего, чем успокаивающая фраза. Правило такое: инструмент действует от имени того, кто его вызвал, и ни от чьего больше, и три вещи не дают этому правилу размыться:

  • Изоляцию обеспечивает Postgres, а не код инструментов. Запрос несёт ваш OAuth-токен, и что вернётся, решает Row Level Security. Ничто в телах инструментов не обеспечивает изоляцию — значит, ничто в них не может её случайно сломать.
  • Принимаются только OAuth-токены. Проверка требует claim client_id, поэтому утащенная из браузера сессия ключом к этому серверу не является.
  • Service-role ключ до инструментов не дотягивается. Этот ключ обходит RLS, и сборка падает, если код MCP хотя бы прочитает переменную окружения с SECRET или SERVICE_ROLE.

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

Как отключить

  • Точечно: в карточке коннектора любому инструменту можно поставить разрешение Blocked. Заблокируйте пишущие инструменты — Claude сможет читать и считать, но ничего не запишет.
  • Целиком: CustomizeConnectors → Unitcore → Remove. Клиент теряет возможность продлевать доступ; выданный токен короткоживущий и обновляется Claude самостоятельно, пока подключение существует.

Если что-то пошло не так

Что вы видитеЧто это значит
После подтверждения вернулись с ошибкой авторизацииПроверьте, не переключали ли вы блок OAuth client вручную. У существующего коннектора это не изменить: Remove и добавить заново, оставив пункт с пометкой Detected
Connect ничего не открываетБраузер заблокировал всплывающее окно. Разрешите всплывающие окна для claude.ai и повторите
Claude отвечает, что у него нет доступа к UnitcoreКоннектор не включён в этом чате: +Connectors → Unitcore
401Токен протух либо использован токен браузерной сессии. Переподключите клиент
No access token.Запрос дошёл до сервера без bearer-токена
No personal space found. Pass space_id explicitly.Нет пространства по умолчанию — назовите пространство в запросе
Список пространств пустВы вошли в другой аккаунт Unitcore. Удалите коннектор, выйдите из лишнего аккаунта и подключитесь заново
Чтение работает, запись — нетКлиента нет в списке разрешённых на запись
Не вижу пункт Add custom connectorТариф Team или Enterprise: коннектор сначала добавляет владелец организации

Частые вопросы

Нужна ли подписка Claude? Нет. Свои коннекторы работают и на бесплатном тарифе, но там доступен только один — если у вас уже подключён другой сервис, слот придётся освободить.

Работает ли это на телефоне? Да. Claude обращается к Unitcore из своего облака, а не с вашего устройства, поэтому подключение, сделанное один раз в браузере, работает и в мобильном приложении.

А если я подключусь с рабочего компьютера — коллеги увидят мои данные? Нет. Доступ привязан к вашей учётной записи Unitcore, а не к устройству или организации.

Что Claude видит из моих данных? Только то, что запрашивает в момент ответа, и ровно в тех границах, которые вы видите сами в приложении.