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

Частые ситуации и что с ними делать.

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

Проверьте, что адрес заканчивается на /mcp и открывается в браузере. Если инсталляция за корпоративной сетью — ассистент должен иметь до неё доступ.

Просит токен, хотя нужен вход аккаунтом

Инсталляция не отдаёт данные о способе входа. Обратитесь к администратору: на сервере должны быть открыты служебные адреса /.well-known/oauth-protected-resource и /.well-known/oauth-authorization-server, а обращение без токена — возвращать 401.

Отвечает `invalid_token`

Сервер отказал на входе, до всякой работы. Тело ответа короткое — {"error":"invalid_token"}, — и оно ничего не поясняет, поэтому вот что стоит проверить по порядку:

Токен скопирован целиком. Он длинный; при копировании из настроек часто теряется хвост.
Токен не отозван и не истёк. Срок задаётся при выпуске, и по умолчанию в поле стоит 90 дней, а не «бессрочно».
Токен от той установки, к которой подключаетесь. Токен одного сервера на другом не работает, и отказ выглядит точно так же.

Второй раз готовый токен посмотреть нельзя — если сомневаетесь, выпустите новый и замените в настройках подключения.

Слово Bearer перед токеном ставить не обязательно: сервер принимает и голое значение. Ошибка при этом не в нём.

Ассистент говорит, что инструмент не загружен

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

Это происходит на стороне клиента: он подгружает описания инструментов по мере надобности и выгружает те, которыми давно не пользовались. Чем больше набор, тем чаще. Повторите просьбу — обычно со второго раза проходит.

Чтобы сталкиваться с этим реже, подключитесь набором под своё занятие — добавьте ?profile=pages (или tasks, forms, projects) к адресу подключения. Меньше набор — реже подгрузка. Как это устроено, описано на странице подключения.

Ассистент отвечает про другой проект

Уточните проект в запросе или закрепите его: «работаем в проекте X». Подробнее — выбор проекта.

Число не сходится с интерфейсом

Две частые причины:

Права. Сводка проекта считает по всей базе, список — только доступное вам.
Область. Вопрос про проект, а ответ по одному списку — или наоборот. Спросите: «по какому проекту ты считал?»

Не находит задачу по названию

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

Надёжнее — ключ задачи (BUGT-34) или ссылка из браузера.

Отвечает, что статуса не существует

Статусы задаются в проекте и в разных проектах называются по-разному. Спросите: «какие статусы есть в этом проекте?»

Инструменты перестали отвечать посреди работы

Часть вызовов проходит, часть возвращает внутреннюю ошибку или «инструмент не готов», повторы не помогают, а новый разговор всё чинит.

Это происходит на стороне приложения, а не сервера. Приложение держит описания инструментов у себя и подгружает их по мере надобности; когда их много, оно вытесняет загруженные раньше и теряет связь с ними. Сервер такого вызова вообще не видит — в его журнале запроса не будет.

Что делать:

Начните новый разговор. Обычно этого достаточно.
Если не помогло, перезапустите приложение и подключитесь заново в его настройках.
Если повторяется часто, назовите занятие в адресе: ?profile=pages (или tasks, forms, projects). Короткий список приложению держать легче, и вытеснять ему становится нечего.

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