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

Разрешите агенту работать в вашем пространстве через MCP с OAuth-авторизацией. Подключение действует от вашего имени.

Подключение

Откройте «MCP-подключения» в выбранном пространстве pmly.
Укажите название клиента, его точный OAuth redirect URI и необходимые права. Redirect URI берётся из настроек MCP-клиента; используйте HTTPS или HTTP loopback для локального клиента.
Зарегистрируйте подключение. Скопируйте URL сервера и Client ID из настроек.
В клиенте укажите URL https://app.pmly.ru/mcp и полученный clientId. На локальном стенде используйте адрес из настроек подключения.
Войдите в pmly в браузере и подтвердите выбранные разрешения. Начните с инструментов getContext, listTeams и listStatuses.

Клиент должен поддерживать Streamable HTTP, заранее зарегистрированный OAuth client ID, Authorization Code и PKCE S256. Секрет клиента не требуется. Персональный REST-токен и браузерная cookie-сессия не авторизуют MCP.

Права и срок действия

Регистрация связана с одним пользователем и пространством. До 20 регистраций на пользователя в пространстве; 1–5 redirect URI на подключение. Название — до 100 символов.

Scopes совпадают с REST для пространства, задач, комментариев, проектов, циклов и представлений; дополнительно доступны attachments:read и attachments:write. Запись требует чтения. Бизнес-права пользователя сохраняются.

OAuth access token действует один час. После истечения нужна повторная авторизация; refresh token для публичных клиентов не поддерживается. Каждая авторизация требует нового согласия. Отзыв подключения немедленно блокирует все его токены. Удаление участника удаляет его подключения без возможности восстановить их повторным приглашением.

Инструменты и запись

Доступны 29 операций из REST-справочника, с теми же operationId, и четыре файловых инструмента. В MCP параметры пути и query передаются аргументами, HTTP body — объектом input, ключ создания — idempotencyKey.

Демонстрационные аргументы createIssue

{
  "workspaceId": "<id пространства>",
  "idempotencyKey": "agent-issue-001",
  "input": {"teamId": "<id команды>", "title": "Задача от агента"}
}

Для изменения используйте актуальную input.version. Правила конфликтов и повторов совпадают с REST. Комментарий сохраняет пользовательского автора и серверную отметку «через <название клиента>»; название нельзя подменить аргументом.

Файлы

Инструмент	Аргументы и результат
`uploadAttachment`	`workspaceId`, ровно один `issueId`/`projectId`, `filename`, `mediaType`, `contentBase64`, `idempotencyKey`. Возвращает метаданные файла.
`listAttachments`	`workspaceId`, ровно один `issueId`/`projectId`, `limit`, `offset`. Возвращает страницу метаданных.
`readAttachment`	`workspaceId`, `attachmentId`, `offset`, `length` до 65536. Возвращает метаданные, `contentBase64`, `offset`, `nextOffset`, `eof`.
`deleteAttachment`	`workspaceId`, `attachmentId`. Возвращает `{"success":true}`. Удалять может загрузивший участник или владелец пространства.

До 10 МиБ на файл и 100 МиБ активных файлов на пространство. Поддерживаются PNG, JPEG, WebP, PDF, TXT, Markdown, CSV, JSON, DOCX, XLSX и PPTX. Пустые файлы и содержимое, не соответствующее формату, отклоняются. Удаление освобождает квоту; повтор старого создания не восстанавливает удалённый файл.

Если не подключается

Клиент должен принимать заданный Client ID. Dynamic Client Registration и Client ID Metadata Documents не поддерживаются.
Проверьте точное совпадение redirect URI с зарегистрированным адресом, URL сервера, членство и scopes.
При истёкшем токене авторизуйтесь повторно; REST-токен в настройках MCP не подходит.
Лимиты по умолчанию — 120 запросов и 30 записей в минуту на подключение. При HTTP 429 подождите Retry-After секунд.