К содержанию
Quevell
EN
Меню

MCP

Подключение ChatGPT, Codex и Claude к Quevell: права, подтверждение действий, история, отзыв доступа и файлы.

Обновлено: 19 октября 2026

Адрес подключения

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

https://<ключ>.quevell.com/api/mcp

Вместо <ключ> укажите ключ компании. Используйте HTTPS. Возможности плана и клиента проверяются отдельно: успешное чтение не доказывает возможность записи или передачи файла.

От чьего имени действует приложение

  • Персональное подключение. Вы входите в Quevell обычным способом, проходите второй фактор, если он требуется, проверяете компанию, приложение, обратный адрес и запрашиваемые действия, затем разрешаете доступ. Приложение действует от вашего имени с вашими текущими правами. Для чтения нужен mcp.read, для записи также mcp.write; offline_access разрешает обновление токена, пока действуют исходная сессия и подключение. Личный OAuth-токен принимается только MCP и не открывает остальные REST-методы.
  • Сервисный аккаунт. У него собственные проектные права и отзываемые учетные данные из раздела Сервисные аккаунты. Его токен не становится личным входом человека. Поддержка client_credentials сервером не означает поддержку этого режима каждым облачным приложением. Секреты не передавайте в промпте или отчете.

Подключение клиентов

Статус проверки клиентов. ChatGPT прошел живую проверку подключения, чтения, записи, отзыва и повторного подключения в тестовой компании. Подключение к production также подтверждено. 19 октября 2026 года владелец подтвердил подключение, чтение и запись через Claude в production, затем отзыв доступа в профиле Quevell и успешное повторное подключение. Передача файлов и подтверждение опасных действий в Claude пока не проверены. Desktop и Code отдельно не приняты. Передача файлов в ChatGPT пока не проверена.

ChatGPT: Quevell MCP Plugin

  1. В разделе плагинов ChatGPT добавьте собственный MCP-сервер. Назовите подключение Quevell MCP Plugin.
  2. Укажите адрес MCP своей компании из примера выше и выберите OAuth. Адреса OAuth и параметры клиента определяются автоматически; создавать сервисный аккаунт или вводить его секрет не требуется.
  3. В открывшемся Quevell войдите в свою учетную запись, проверьте компанию и действия приложения, затем разрешите доступ.
  4. В новом чате выберите Quevell MCP Plugin через @. Попросите: "Вызови list_projects с offset 0, limit 10. Ничего не изменяй". Затем можно прочитать свою задачу через get_issue.

Доступность подключения зависит от плана и правил рабочего пространства. Названия пунктов сверяйте с официальной инструкцией ChatGPT. В Quevell подтвержденное приложение может называться ChatGPT: это имя OAuth-клиента, а Quevell MCP Plugin обозначает плагин.

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

Codex CLI

Добавьте HTTP-сервер и запросите нужные scopes:

codex mcp add quevell --url https://<ключ>.quevell.com/api/mcp
codex mcp login quevell --scopes mcp.read,mcp.write,offline_access

Для одного чтения достаточно mcp.read; обновление доступа требует offline_access. Если ваша версия требует заранее известный идентификатор публичного клиента, при добавлении укажите --oauth-client-id quevell-codex. Такой вход получает метку публичного клиента. Для отдельной сервисной интеграции есть --bearer-token-env-var QUEVELL_MCP_TOKEN: значение передайте защищенным окружением; конфигурация хранит имя переменной, не токен. Команды сверены с CLI 0.160.0.

Claude в браузере или Desktop

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

Claude Code

Для HTTP-подключения можно явно задать запрашиваемые scopes:

claude mcp add-json quevell '{"type":"http","url":"https://<ключ>.quevell.com/api/mcp","oauth":{"scopes":"mcp.read mcp.write offline_access"}}'
claude mcp login quevell

В интерактивном клиенте вход также доступен через /mcp. Если требуется заранее известный идентификатор публичного клиента, используется quevell-claude-code без secret. Сверьте свою версию с официальной инструкцией Claude Code.

Запись и повторные запросы

Запись передает UUID requestId: сетевой повтор использует тот же UUID и те же аргументы. Новое намерение получает новый UUID. Версию для изменения берут из прочитанного состояния; конфликт не разрешается автоматической подменой версии.

Подтверждение опасных действий

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

История действий

История различает человека и сервисный аккаунт, канал MCP и приложение. Метка "публичный OAuth-клиент (без подписи приложения)" относится к программе. Пользователь проходит обычный вход и разрешает доступ. Метка "подтвержденное приложение" означает проверенную подпись клиента. Записи без сведений об уровне подтверждения показывают "подлинность приложения не подтверждена". Подтвержденные реквизиты сервисной интеграции не устанавливают AI-модель. Рабочие операции и история остаются ограничены обычными правами Quevell.

Отзыв доступа

В Профиле → Подключенные приложения нажмите Отозвать у нужной связи. Старый токен перестанет работать; новое подключение потребует нового согласия. Завершение исходной сессии также прекращает делегирование. Для сервисного режима отзывают OAuth-клиент или токен сервисного аккаунта. Удаление настройки из AI-клиента само по себе не отзывает полномочия на сервере.

Файлы

Файлы передаются через MCP-инструменты в пределах разрешенных действий. Предел загрузки сервера: 10 МБ; у клиента может быть меньший предел или отсутствовать подходящий способ передачи файла. Поддержку встроенного выбора файлов нельзя вывести из одного успешного малого запроса.