Приложения OAuth и MCP в аккаунте

В разделе Приложения OAuth и MCP находятся настройки подключения внешних приложений к аккаунту Planfix.

Откройте Управление аккаунтом → API → Приложения OAuth и MCP. Этот раздел доступен администраторам аккаунта и техническим администраторам.

Раздел включает три области:

MCP — адрес MCP-сервера и краткие инструкции по подключению;
Приложения, принадлежащие этому аккаунту — OAuth-приложения, созданные специально для текущего аккаунта;
Сторонние приложения — общая политика и приложения, явно одобренные в аккаунте.

MCP

В этой области отображается URL MCP Planfix:

https://mcp.planfix.com/mcp

Обычно пользователю достаточно добавить этот URL в совместимый MCP-клиент и выполнить вход через OAuth. Название аккаунта выбирается на странице Planfix и не включается в URL. Пошаговые инструкции см. в разделе MCP.

Приложения, принадлежащие этому аккаунту

Создайте приложение, принадлежащее аккаунту, если интеграция предназначена только для текущего аккаунта, а внешнему клиенту нужен заранее заданный client_id.

Приложение, принадлежащее аккаунту:

не может подключаться к другим аккаунтам;
доступно в аккаунте-владельце независимо от политики сторонних приложений;
использует глобальные конечные точки OAuth;
может работать с REST API или MCP в пределах выбранных областей доступа.

Создание приложения

Выберите Создать приложение.
Укажите понятные название и описание.
Выберите тип OAuth-клиента.
Добавьте URI перенаправления клиента.
Выберите минимально необходимые уровни доступа.
Сохраните приложение и скопируйте созданные учетные данные.

Тип клиента	Когда использовать
Публичный	Мобильное, настольное или браузерное приложение либо локальный MCP-клиент. Секрет не создается; поток авторизации защищен с помощью PKCE.
Конфиденциальный	Серверное приложение, способное надежно хранить секрет клиента. Никогда не включайте секрет в код клиентской части, мобильное приложение или распространяемый файл конфигурации.

Секрет клиента отображается после создания конфиденциального приложения. Храните его в защищенном хранилище секретов.

URI перенаправления и разрешения

Для обычных веб-приложений используйте https. http разрешен только для локальных хостов, таких как localhost и 127.0.0.1.

Выбирайте только области доступа, необходимые интеграции. Области доступа ограничивают доступ приложения, но не расширяют разрешения пользователя, который его подключает.

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

Управление приложением

В карточке приложения можно:

изменить название, описание, URI перенаправления и области доступа;
отключить и снова включить приложение;
заменить секрет конфиденциального клиента.

После замены секрета прежний секрет клиента немедленно перестает работать. Скопируйте новый секрет и обновите конфигурацию интеграции на сервере.

Отключение приложения блокирует авторизацию и использование выданных им токенов. Перед отключением убедитесь, что от него не зависят бизнес-процессы.

Сторонние приложения

К сторонним приложениям относятся приложения партнеров, опубликованные приложения и MCP-клиенты, зарегистрированные через CIMD или DCR.

Политика сторонних приложений

Политика	Результат
Разрешить опубликованные приложения	Приложения, опубликованные Planfix, доступны без отдельного одобрения. Для закрытых приложений партнеров и автоматически зарегистрированных MCP-клиентов по-прежнему требуется явное одобрение администратора.
Только одобренные приложения	Для каждого стороннего приложения требуется явное одобрение администратора.
Блокировать сторонние приложения	Сторонние OAuth-приложения и приложения MCP блокируются. Приложения, принадлежащие аккаунту, продолжают работать.

Для аккаунтов, в которых необходимо проверять каждую интеграцию отдельно, рекомендуется выбрать Только одобренные приложения.

Одобрение приложения

Запрос на одобрение может появиться двумя способами:

пользователь начинает подключение через OAuth, и Planfix сообщает, что требуется одобрение;
партнер отправляет администратору прямую ссылку на приложение.

Перед одобрением приложения проверьте:

его название, описание и владельца;
URI перенаправления или хост обратного вызова;
запрашиваемые области доступа;
требуется ли интеграция сотрудникам.

Одобрение администратора применяется ко всему аккаунту, но не подключает автоматически каждого пользователя. Каждый сотрудник входит отдельно и дает согласие от своего имени. Если приложение подключает администратор, действие Одобрить и подключить выполняет обе операции.

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

Отзыв одобрения

Чтобы заблокировать приложение для аккаунта, найдите его в списке одобренных и отзовите доступ. Связанные с ним токены OAuth пользователей этого аккаунта будут отозваны.

Если выбрана политика Разрешить опубликованные приложения, отзыв отдельного одобрения не блокирует опубликованное приложение, поскольку общая политика по-прежнему разрешает его. Чтобы заблокировать приложение, выберите Только одобренные приложения или Блокировать сторонние приложения.

Личные подключения пользователей

Одобрение аккаунта и подключение отдельного пользователя — это два независимых уровня управления.

Сотрудник может просматривать и отзывать собственные подключения OAuth:

Откройте свою карточку пользователя.
Перейдите в Управление сессиями.
Найдите приложение; подключения MCP отмечены как MCP.
Удалите сессию.

Удаление сессии отзывает связанные с ней токены. Чтобы восстановить доступ, пользователю потребуется снова пройти авторизацию OAuth.