Подготовьте безопасный пример
Создайте очередь DEMO и задачу с вымышленным описанием. Не используйте секреты и данные клиентов для проверки. Агенту нужен MCP-клиент, а вашему скрипту или сервису — HTTP-клиент к REST API. Они работают с теми же объектами и ограничениями доступа.
1. Создайте участника и токен
Удобно выделить отдельного участника для агента, чтобы видеть его авторство. Выдайте ему чтение DEMO, создайте личный токен в настройках и сохраните в защищённом хранилище клиента. Не вставляйте токен в задачу, репозиторий или переписку. Токен показывается только при создании.
2. Настройте подходящее подключение
Для MCP используйте https://tracker.18d.ru/mcp/, транспорт Streamable HTTP и Authorization: Bearer TOKEN. Клиент выполняет MCP initialize и получает инструменты. Для REST API базовый адрес — https://tracker.18d.ru/api/v1, авторизация тем же личным Bearer-токеном. Это разные протоколы: запрос REST-метода нельзя отправить как обычный вызов MCP endpoint.
Актуальные обезличенные конфигурации и запросы находятся в инструкции MCP и инструкции API. Примеры используют placeholder, который заменяют у себя, а не на странице документации.
3. Начните с чтения
«Покажи доступные очереди. Найди мою DEMO-задачу и прочитай её описание, комментарии и историю. Ничего не меняй».
Наличие сервера и списка инструментов ещё не доказывает, что токен читает нужные данные. Нужен реальный запрос списка очередей и выбранной задачи. Пустой список может означать отсутствие прав, а не отсутствие задач в системе.
4. Разрешите конкретную запись
Для пилота выдайте write на DEMO и поручите добавить тестовый комментарий. При изменении задачи агент должен прочитать актуальную version и доступный статус. После 409 нужно заново прочитать запись и пересмотреть действие. Не повторяйте вслепую комментарий или запись времени: можно получить дубликаты.
5. Прочитайте результат и отзовите тестовый доступ
Проверьте новый комментарий и его автора, статус или запись времени — именно тот результат, который поручили. Успешное подключение не равно выполненной работе. По окончании отзовите тестовый токен; новые запросы с ним должны быть отклонены.
Агент не обходит пространство и права очередей. Поиск ограничен 2000 задачами за запрос. Это не автоматический импорт и не фоновая синхронизация всех задач. MCP для агентов · REST API.