Если что-то не работает

Подключение не устанавливается

Используйте адрес MCP с путём /mcp, а не адрес документации или страницы входа. Параметр набора, например ?profile=pages, допустим. Открытие этого адреса в браузере показывает версию сервера, но не проверяет вход и выполнение инструментов.

Облачный клиент должен иметь сетевой доступ к серверу со своей стороны. Доступность из браузера на вашем ноутбуке не доказывает доступность из ChatGPT или удалённого коннектора Claude. Для корпоративной установки проверьте прокси и сеть.

Не появляется вход через OAuth

Клиент должен поддерживать OAuth, а сервер — отдавать данные о способе входа. Администратору: проверьте /.well-known/oauth-protected-resource, /.well-known/oauth-authorization-server и ответ 401 с WWW-Authenticate на неавторизованный POST к /mcp. Проверка своей установки.

Ошибка авторизации или invalid_token

При OAuth повторите вход в настройках подключения. Если появляется invalid_grant, обновление доступа или код входа не принят: не повторяйте старый код вручную, начните вход заново.

При ручном токене проверьте:

1. Ключ скопирован целиком, без лишних пробелов и кавычек.
2. Он не истёк и не отозван.
3. Он выпущен на той установке, к которой подключаетесь.
4. Он передаётся в Authorization: Bearer ..., а не в URL или текст запроса.

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

Читать можно, менять нельзя

Причины различаются: режим токена «только чтение» (TOKEN_SCOPE_READ_ONLY), права вашей учётной записи или запрещённое действие в настройках клиента. Проверьте, можете ли выполнить действие в приложении вручную. Повторная авторизация не даёт дополнительных прав.

Отказ пользователя в подтверждении — не сбой: действие не следует запускать повторно.

Инструмент отсутствует или не загружен

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

Ошибка описания инструмента сама по себе не устанавливает, на чьей стороне сбой. Для диагностики нужны время запроса, имя инструмента и результат, а при доступе администратора — журнал сервера. Наборы инструментов.

Запрос долго выполнялся или оборвался

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

Начало нового разговора не отменяет уже выполненную запись.

Не тот проект, пустой список или другое число

Уточните пространство, проект, даты, фильтры и полноту выдачи. Пустая страница или частичный результат не доказывают отсутствие задач во всём пространстве. Разница со сводкой не доказывает, что существуют скрытые от вас задачи. Как выбирается область запроса.

Несколько объектов с одинаковым названием

Используйте ссылку, ключ задачи или проект для уточнения. Сервер должен отказать от случайного выбора при неоднозначности — это защита от изменения не того объекта.

Статус, исполнитель или поле не найдены

Статусы и пользовательские поля зависят от проекта; исполнитель должен иметь нужный доступ. Попросите показать доступные варианты. Не заменяйте неизвестное значение произвольным «похожим» и не повторяйте ту же запись без исправления аргументов.

Форма изменилась с момента чтения

Для layers_form_update нужен свежий configHash из layers_form_get. Если хеш отсутствует или устарел, заново прочитайте форму и примените правки к текущей конфигурации. Проверку нельзя обходить, удаляя хеш из запроса.

Публикация с PIN завершилась ошибкой

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

Приглашение не принимается

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

Превышен лимит запросов

При 429 соблюдайте Retry-After, если он есть; иначе сделайте паузу. Не обходите ограничение параллельными повторами. Лимиты.

Что сообщить поддержке

Адрес установки, время и часовой пояс, клиент, выбранный набор, имя инструмента, текст ошибки и идентификатор запроса, если он есть. Удалите токены, PIN, пароли и приватное содержимое из приложенных материалов.