Ваша первая сессия MCP: повторяемый скрипт дымового теста
Проверьте, что ваша настройка MCP работает корректно, с помощью этого пошагового дымового теста. Это руководство проведёт вас через получение списка задач, чтение деталей задачи, добавление комментариев и опционально тестирование учёта времени — со всеми ожидаемыми результатами и шагами устранения неполадок, если что-то не сработает.
Что охватывает это руководство
Этот дымовой тест проверяет вашу интеграцию MCP от начала до конца:
Шаги теста
- Список задач: проверьте доступ на чтение к вашему рабочему пространству
- Чтение задачи: протестируйте получение деталей конкретной задачи
- Добавление комментария: проверьте, что права на запись работают
- Учёт времени (опционально): протестируйте запуск/остановку таймера
Предварительные требования
Перед запуском дымового теста убедитесь, что у вас есть:
- Настроенный MCP-клиент (Claude Desktop, Cursor, Windsurf или Continue)
- Сервер Workify MCP, добавленный в конфигурацию вашего клиента
- API-ключ с правами на чтение и запись
- Хотя бы одна задача в вашем рабочем пространстве Workify
- Клиент перезапущен после изменений конфигурации
Пошаговый дымовой тест
Шаг 1: получите список задач
Начните с простой операции чтения, чтобы проверить подключение:
Тестовый промпт
Ожидаемый результат:
Что делает ИИ:
- Вызывает MCP-инструмент
list_tasks - Получает список задач из Workify
- Форматирует и отображает результаты
⚠️ Если это не сработало:
- Проверьте, что API-ключ корректен и активен
- Проверьте конфигурацию MCP-сервера
- Убедитесь, что клиент был перезапущен после изменений конфигурации
- См. Инструменты не отображаются
Шаг 2: прочитайте одну задачу
Протестируйте получение деталей конкретной задачи:
Тестовый промпт
Ожидаемый результат:
Что делает ИИ:
- Вызывает
get_taskс ID задачи - Получает полные детали задачи
- Отображает отформатированную информацию
⚠️ Если это не сработало:
- Проверьте, что ID задачи корректен (скопируйте из результата шага 1)
- Проверьте, что API-ключ имеет права на чтение
- Убедитесь, что задача существует в вашем рабочем пространстве
Шаг 3: добавьте комментарий
Протестируйте права на запись, добавив комментарий:
Тестовый промпт
Ожидаемый результат:
Что делает ИИ:
- Вызывает
add_task_commentс ID задачи и текстом комментария - Подтверждает, что комментарий был добавлен
- Проверяет, что права на запись работают
⚠️ Если это не сработало:
- Проверьте, что API-ключ имеет права на запись
- Проверьте, что ID задачи корректен
- См. 401 Unauthorized
- См. 403 Forbidden
Шаг 4: учёт времени (опционально)
Протестируйте функциональность учёта времени с подтверждением:
Тестовый промпт
Ожидаемый результат:
Промпт для остановки таймера:
Что делает ИИ:
- Вызывает
get_task, чтобы показать детали задачи - Вызывает
start_time_tracking, чтобы запустить таймер - Позже: вызывает
stop_time_trackingиadd_task_comment
⚠️ Если это не сработало:
- Проверьте, что API-ключ имеет права на учёт времени
- Убедитесь, что другой таймер ещё не запущен
- См. Сбои вызова инструмента
Полный скрипт дымового теста
Вот полный скрипт, который вы можете скопировать и запустить:
Полная последовательность теста
1. Список задач
2. Чтение задачи
3. Добавление комментария
4. Учёт времени (опционально)
Чек-лист проверки
Критерии успеха
- ✅ Список задач возвращает результаты без ошибок
- ✅ Детали задачи успешно получены
- ✅ Комментарий добавлен и виден в Workify
- ✅ Таймер запускается и останавливается без ошибок (если тестировали)
- ✅ Все операции завершаются за разумное время (<5 секунд каждая)
Устранение неполадок при первом запуске
Инструменты недоступны
Симптом: ИИ сообщает, что инструменты MCP недоступны
Решение:
- Проверьте, что MCP-сервер настроен в параметрах клиента
- Проверьте, что JSON конфигурационного файла корректен
- Полностью перезапустите клиент (не просто перезагрузите)
- См. Инструменты не отображаются
Ошибки аутентификации
Симптом: ошибки 401 или 403 при вызовах инструментов
Решение:
- Проверьте, что API-ключ корректен в конфигурации
- Проверьте формат заголовка Authorization: "Bearer YOUR_KEY"
- Убедитесь, что API-ключ активен в Workify
- См. Устранение ошибки 401
Связанные ресурсы
Быстрый старт MCP
Руководство по настройке за 5 минут
Индекс устранения неполадок
Полное руководство по устранению неполадок
Еженедельное планирование
Первый рабочий процесс для пробы
Проверки работоспособности
Проверьте статус сервера
Завершите свою первую сессию MCP
Запустите дымовой тест, чтобы проверить, что ваша настройка MCP работает корректно