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

MCP

MCP (Model Context Protocol) позволяет ИИ-ассистентам и другим совместимым приложениям работать с данными Planfix по стандартному протоколу.

После подключения клиент получает только явно разрешённые возможности и действует от имени вошедшего в систему сотрудника. Стандартные права доступа Planfix продолжают действовать: ИИ-ассистент не может просматривать или изменять то, что недоступно этому пользователю.

Доступные действия зависят от MCP-клиента, предоставленных разрешений и текущей версии сервера. Например, клиент может искать задачи и контакты, просматривать сведения о них и добавлять комментарии, если для этого предоставлены соответствующие разрешения.

Требования

  • аккаунт сотрудника Planfix;
  • MCP-клиент с поддержкой Streamable HTTP и OAuth.

Адрес MCP-сервера

Используйте URL MCP-сервера: 

https://mcp.planfix.com/mcp

URL одинаков для всех аккаунтов Planfix. Не добавляйте к нему имя аккаунта и не передавайте отдельный заголовок с аккаунтом. Аккаунт выбирается во время авторизации OAuth.

Подключение любого MCP-клиента

  1. Откройте настройки MCP-серверов в клиенте.
  2. Добавьте новый сервер, выбрав транспорт Streamable HTTP.
  3. Укажите название, например Planfix, и URL MCP-сервера.
  4. Сохраните настройки и начните авторизацию OAuth.
  5. В открывшемся окне браузера выберите аккаунт Planfix. Его можно найти по названию, URL или адресу электронной почты.
  6. Проверьте название приложения и запрашиваемые разрешения, затем подтвердите подключение.

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

При подключении Codex через DCR запрос нельзя передать администратору после начала входа. Поэтому заранее выберите подходящий вариант в следующем разделе.

Подключение Codex

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

Если вы администратор: подключение через DCR

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

Добавьте MCP-сервер: 

codex mcp add planfix --url https://mcp.planfix.com/mcp

Начните авторизацию OAuth и явно выберите DCR в качестве способа регистрации клиента: 

codex mcp login planfix --oauth-client-registration dcr

Codex откроет браузер. Выберите аккаунт Planfix, в котором у вас есть права администратора, проверьте запрашиваемые разрешения и нажмите Разрешить и подключить.

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

Параметр --oauth-client-registration dcr применяется только для этого входа и не сохраняется в config.toml. Codex самостоятельно сохранит полученные данные подключения OAuth.

Если вы не администратор: подключение с помощью client_id

Сначала попросите управляющего аккаунтом или технического администратора создать приложение:

  1. Откройте Управление аккаунтом → API → Приложения OAuth и MCP.
  2. В блоке Приложения этого аккаунта нажмите Создать приложение.
  3. Введите название, например Codex.
  4. Выберите тип Публичный клиент. Codex не требуется секрет клиента.
  5. Добавьте URI перенаправления http://127.0.0.1/callback.
  6. Выберите минимально необходимые разрешения и сохраните приложение.
  7. Передайте пользователю полученный client_id.

Planfix публикует издателя и поддерживает привязку к нему ответа авторизации, поэтому для нового предварительно зарегистрированного клиента Codex используется постоянный адрес обратного вызова http://127.0.0.1/callback. Во время входа Codex добавляет временный порт loopback. Planfix принимает такой порт, если хост и путь не изменились.

Пользователь добавляет сервер, подставив выданный идентификатор: 

codex mcp add planfix --url https://mcp.planfix.com/mcp --oauth-client-id CLIENT_ID

Codex покажет полный URL обратного вызова. В стандартной конфигурации он выглядит так: 

OAuth callback URL: http://127.0.0.1/callback

Если из-за пользовательских настроек Codex отображается другой адрес, попросите администратора добавить этот URI перенаправления в приложение.

Затем выполните: 

codex mcp login planfix

Параметр --oauth-client-id указывает Codex использовать предварительно зарегистрированный клиент и не запускать CIMD или DCR. Настройки сохраняются примерно так: 

[mcp_servers.planfix]
url = "https://mcp.planfix.com/mcp"

[mcp_servers.planfix.oauth]
client_id = "CLIENT_ID"
callback_url = "http://127.0.0.1/callback"

Приложение Codex и расширение для IDE

Приложение Codex, Codex CLI и расширение для IDE используют общую конфигурацию MCP на одном компьютере. После первого подключения через CLI перезапустите приложение или расширение. Сервер появится в разделе Настройки → MCP-серверы. Если рядом с ним отображается кнопка Авторизоваться, нажмите её и завершите вход.

Проверить активные MCP-серверы можно командой /mcp в поле ввода Codex.

Список подключений и их статус можно посмотреть с помощью команды: 

codex mcp list

Актуальные сведения об элементах интерфейса, командах и правилах выбора обратного вызова приведены в официальной документации OpenAI по MCP.

Если другой MCP-клиент не может зарегистрироваться автоматически

Современный MCP-клиент может зарегистрироваться автоматически через CIMD или DCR. Такая регистрация сама по себе не предоставляет доступ к аккаунту: правила аккаунта и одобрение администратора по-прежнему действуют.

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

  1. Откройте Управление аккаунтом → API → Приложения OAuth и MCP.
  2. Создайте приложение в блоке Приложения этого аккаунта.
  3. Выберите тип Публичный клиент.
  4. Добавьте URI перенаправления, указанный MCP-клиентом.
  5. Выберите минимально необходимые разрешения.
  6. Передайте полученный client_id пользователю или добавьте его в настройки клиента.

Такое приложение сможет подключаться только к аккаунту, в котором оно создано. Подробнее — в статье Приложения OAuth и MCP в аккаунте.

Несколько аккаунтов

Каждое подключение связано с одним аккаунтом и одним пользователем.

  • Для подключения через DCR добавьте ещё один MCP-сервер под другим названием и во время входа выберите другой аккаунт, в котором у вас есть права администратора.
  • Приложение, принадлежащее аккаунту, и его client_id работают только в аккаунте, где они были созданы. Для другого аккаунта его администратор должен создать отдельное публичное приложение. Добавьте его в Codex под другим названием и укажите новый client_id.

Не изменяйте URL MCP и не добавляйте имя аккаунта в запросы. Сервер определяет аккаунт по выданному токену OAuth.

Отключение MCP

Чтобы отозвать подключение:

  1. Откройте карточку пользователя в Planfix.
  2. Перейдите в раздел Управление сеансами.
  3. Найдите приложение с отметкой MCP и удалите сеанс.
  4. Удалите сервер из MCP-клиента или отключите его, если он больше не нужен.

Удаление сеанса отзывает связанные с ним токены OAuth. Для повторного подключения потребуется снова войти в систему и дать согласие.

Администратор может отозвать доступ приложения для всего аккаунта в разделе Управление аккаунтом → API → Приложения OAuth и MCP.

Безопасность

  • Подключайте только те приложения, которым доверяете.
  • Перед одобрением проверьте название приложения, его владельца, URI перенаправления и запрашиваемые разрешения.
  • Предоставляйте минимально необходимые разрешения. Для сценариев только с чтением не предоставляйте разрешения на изменение или удаление данных.
  • Никогда не вставляйте токен доступа или токен обновления в чат, настройки запроса или журналы.
  • Помните, что содержимое задач, контактов и комментариев может передаваться стороннему ИИ-сервису в соответствии с условиями обработки данных этого сервиса.
  • Удалите подключение в разделе Управление сеансами, если оно больше не используется или вы его не узнаёте.

Устранение неполадок

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

Сообщение или симптом Что делать
Приложение заблокировано политикой аккаунта Администратор должен одобрить это приложение или изменить политику в отношении сторонних приложений.
После входа клиент снова запрашивает авторизацию Удалите подключение из клиента и создайте его заново. Проверьте, что используется точный URL MCP.
Выбран неправильный аккаунт Отзовите подключение и войдите снова, выбрав нужный аккаунт. Переключить токен на другой аккаунт нельзя.
Клиент запрашивает client_id Попросите администратора создать публичное приложение для аккаунта и добавить MCP-сервер с параметром --oauth-client-id.
Операция недоступна Проверьте предоставленные области доступа и права доступа пользователя в Planfix.

Перейти

Источник — https://planfix.com/ru/help/MCP