·

Подключение официального MCP Planfix к Codex: права и первая проверка

Успешный вход связывает Codex с аккаунтом сотрудника в Planfix. Но подключение ещё не показывает, подходит ли MCP для задачи: сначала проверьте приложение, разрешения и небольшой безопасный сценарий.

В видео о подключении Codex я разбираю реальную настройку и случаи, где пришлось перепроверять OAuth и состояние сервера. Демонстрация показывает опыт одной сессии, а не универсальную последовательность действий. Текущие названия команд и поля интерфейса сверяйте с документацией.

Перед подключением

Официальный сервер Planfix использует адрес https://mcp.planfix.com/mcp и OAuth. Нужны учётная запись сотрудника Planfix и MCP-клиент с поддержкой Streamable HTTP и OAuth. Подключение действует от имени вошедшего сотрудника: его права Planfix сохраняются, а конкретные действия зависят также от клиента, выданных разрешений и версии сервера. Перед подтверждением проверьте название приложения, владельца, адрес возврата и запрошенный доступ; предоставляйте только минимально необходимый. Учитывайте, что содержимое задач, контактов и комментариев может передаваться внешнему AI-сервису.

Выберите способ по своей роли

Если вы администратор аккаунта Planfix, Codex может зарегистрировать OAuth-клиент автоматически через DCR. В терминале добавьте сервер, затем начните вход:

codex mcp add planfix --url https://mcp.planfix.com/mcp
codex mcp login planfix --oauth-client-registration dcr

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

Если вы не администратор, попросите администратора заранее создать в Planfix OAuth-приложение типа Public client, указать redirect URI из официальной инструкции и выдать вам его client_id. Секрет клиенту Codex не нужен. Затем укажите выданный идентификатор при добавлении сервера и отдельно выполните вход:

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

Проверьте полный callback URL, который показывает Codex, и убедитесь, что он разрешён в приложении. В типовой настройке используется http://127.0.0.1/callback; при других параметрах Codex ориентируйтесь на фактически показанный адрес. Пошаговую настройку клиента и redirect URI смотрите в официальной справке Planfix MCP.

Первая проверка

  1. Убедитесь, что Codex показывает сервер Planfix подключённым: используйте codex mcp list или команду /mcp в Codex.
  2. Начните с тестовой задачи или другого безопасного примера, который разрешено просматривать.
  3. Попросите найти конкретную запись и сравните ответ с данными в Planfix.
  4. Если требуется изменение, сначала проверьте область разрешений и подтверждение операции; после действия сверьте результат в интерфейсе.

Подключённый сервер подтверждает авторизацию, но не доказывает, что нужная операция доступна или полезна для рабочего процесса. Для проверки полного цикла — действия, сверки в Planfix и чтения изменения обратно — см. MCP Planfix на практике: проверка полного цикла.

Четыре частые ошибки

  1. Запустить DCR без прав администратора. Выберите вход через заранее зарегистрированный Public client и client_id либо подключайтесь под администратором.
  2. Повторять OAuth, когда клиент снова просит войти. Проверьте точный URL MCP; удалите соединение в клиенте и создайте его заново. Не повторяйте вручную старый callback.
  3. Выбрать не тот аккаунт Planfix. Отзовите соединение и авторизуйтесь снова под нужным аккаунтом: токен нельзя переключить на другой аккаунт.
  4. Считать недоступное действие поломкой подключения. Проверьте разрешения OAuth, собственные права сотрудника и, если приложение блокируется политикой аккаунта, попросите администратора одобрить его.

Связанные материалы

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

Обсудить сценарий в Telegram