Как подключить AI-агента к проекту PRO-dela по MCP

К проекту PRO-dela теперь можно подключить внешний AI-агент по Model Context Protocol (MCP): например, opencode, Claude Code, Codex или другой клиент с поддержкой удалённых MCP-серверов. Агент сможет получить контекст проекта, найти задачи, создать одну или несколько задач, назначить исполнителя и изменить статус — в пределах прав человека, который выпустил токен.

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

Зачем подключать внешнего агента к системе задач

AI-агенты хорошо работают с контекстом разработки: читают код, помогают составить план, находят связанные изменения. Но результат часто остаётся в чате или терминале. Чтобы перенести его в систему управления проектом, приходится вручную создавать задачи, назначать исполнителей и обновлять статусы.

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

Что умеет подключённый агент

Текущая MCP-поверхность включает шесть инструментов:

• get_project_context — возвращает проект, его статусы, участников и права владельца токена;
• list_tasks — ищет и показывает задачи проекта с фильтрами;
• create_task — создаёт одну задачу, при необходимости сразу назначает исполнителя и статус;
• create_tasks — создаёт пакет до 25 задач;
• set_task_status — меняет статус задачи;
• set_task_assignee — назначает исполнителя и при необходимости статус.

Задачи адресуются только по числовому ID. Это сознательное ограничение: похожие названия не должны приводить к изменению не той задачи. Имена статусов и исполнителей можно передавать текстом; если совпадение неоднозначно, агент получит список кандидатов вместо догадки.

Пакетное создание работает по принципу best-effort: успешно прошедшие элементы создаются, а ошибки возвращаются отдельно в failed. Повторять нужно только неуспешные элементы, а не отправлять весь пакет заново.

Как ограничен доступ

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

• Если пользователь не может создавать задачи в интерфейсе, агент также не сможет их создать.
• Если человеку недоступна чужая задача, токен не обойдёт эту проверку.
• Токен проекта A не может обратиться к задаче проекта B.
• После удаления пользователя из проекта его токены перестают работать.
• Владелец проекта может одним переключателем отключить все подключения внешних агентов.

Секрет показывается только один раз, сразу после выпуска. Позже в интерфейсе остаются название, короткий префикс, срок, состояние и время последнего использования. Токен можно отозвать в любой момент. Доступны сроки 30, 90 и 365 дней либо вариант без фиксированной даты; неиспользуемый 90 дней токен автоматически отзывается.

Как подключить opencode

1. Откройте нужный проект в PRO-dela.
2. Перейдите в раздел проекта «Интеграции» и блок «Внешние AI-агенты».
3. Нажмите «Выпустить токен агента», задайте понятное имя и срок.
4. Скопируйте секрет: после закрытия окна показать его повторно нельзя.
5. Скопируйте готовую конфигурацию opencode из той же формы.

{  "mcp": {    "pro-dela": {      "type": "remote",      "url": "СКОПИРОВАННЫЙ_MCP_URL",      "headers": {        "Authorization": "Bearer pdl_ВАШ_ТОКЕН"      },      "oauth": false    }  } }

Параметр "oauth": false обязателен: здесь используется статический project-scoped bearer-токен, а не OAuth. Точный URL лучше брать из интерфейса проекта — локальный и опубликованный сервер имеют разные адреса.

Claude Code и Codex

Для Claude Code PRO-dela показывает готовую команду подключения:

claude mcp add --transport http pro-dela СКОПИРОВАННЫЙ_MCP_URL \  --header "Authorization: Bearer pdl_ВАШ_ТОКЕН"

В Codex секрет удобнее хранить в переменной окружения, а в config.toml оставить только её имя:

[mcp_servers.pro-dela] url = "СКОПИРОВАННЫЙ_MCP_URL" bearer_token_env_var = "PRODELA_MCP_TOKEN"export PRODELA_MCP_TOKEN="pdl_ВАШ_ТОКЕН"

Не добавляйте рабочий секрет в публичный репозиторий, скриншот или сообщение. Если токен случайно раскрыт, отзовите его и выпустите новый.

Как подключить два проекта к одному агенту

Один токен не может охватывать несколько проектов. Для двух проектов выпустите два токена и зарегистрируйте один MCP URL дважды под разными именами:

{  "mcp": {    "pro-dela-alpha": {      "type": "remote",      "url": "СКОПИРОВАННЫЙ_MCP_URL",      "headers": {        "Authorization": "Bearer pdl_ТОКЕН_ПРОЕКТА_ALPHA"      },      "oauth": false    },    "pro-dela-beta": {      "type": "remote",      "url": "СКОПИРОВАННЫЙ_MCP_URL",      "headers": {        "Authorization": "Bearer pdl_ТОКЕН_ПРОЕКТА_BETA"      },      "oauth": false    }  } }

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

Кто управляет токенами

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

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

Практический сценарий

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

Получи контекст проекта. Покажи черновик восьми задач с исполнителями и статусами. После подтверждения создай их в PRO-dela и повторно отправляй только элементы, которые вернулись в failed.

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

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

Может ли токен увидеть все проекты моего аккаунта?

Нет. Он закреплён за одним проектом. Для другого проекта нужен отдельный токен и отдельная запись MCP-клиента.

Получит ли агент доступ к документам и счетам?

Нет. Сейчас агентская поверхность ограничена контекстом проекта и операциями с задачами. Обычный пользовательский API проектный токен не принимает.

Что произойдёт после отзыва токена?

Следующий запрос агента перестанет проходить аутентификацию. Возвратить отозванный секрет нельзя — при необходимости выпускается новый.

Можно ли подключить несколько клиентов к одному проекту?

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

AI-агент действует автономно?

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

Подключите агента к первому проекту

Откройте проект, перейдите в «Интеграции» и выпустите отдельный токен для своего MCP-клиента. Начните с безопасной проверки: попросите агента вызвать get_project_context и list_tasks, не создавая и не изменяя данные. Когда убедитесь, что подключён правильный проект и права соответствуют ожиданиям, переходите к рабочим командам.

Если у вас ещё нет аккаунта, зарегистрируйтесь в PRO-dela, создайте проект и проверьте доступный лимит подключений на странице тарифов.