Настройка MCP Workify для Cursor: подключите задачи и проекты к вашему редактору
Подключите Cursor к Workify через MCP, чтобы перенести управление проектами прямо в вашу IDE. В этом руководстве показано, как добавить Workify в качестве MCP-сервера, перезапустить/перезагрузить редактор и протестировать первый рабочий процесс.
Предварительные требования
- Cursor установлен в вашей системе
- Аккаунт Workify с доступом к API-ключу
- Базовое умение редактировать JSON-файлы
Шаг 1: получите свой API-ключ Workify
- Войдите в Workify
- Перейдите в Настройки → Интеграции
- Найдите раздел Публичный API
- Нажмите Добавить API-ключ
- Сразу же скопируйте ключ (он показывается только один раз)
- Сохраните его в надёжном месте — он понадобится на следующем шаге
💡 Совет
Давайте API-ключу понятное имя (например, «Cursor — рабочий ноутбук»), чтобы легко управлять несколькими ключами.
Шаг 2: найдите файл конфигурации MCP
Cursor хранит конфигурацию MCP-серверов в одном файле на всех платформах:
Расположение файла конфигурации
~/.cursor/mcp.json
Символ ~ обозначает ваш домашний каталог:
- macOS/Linux:
/Users/yourusername/.cursor/mcp.json - Windows:
C:\Users\yourusername\.cursor\mcp.json
Если файл не существует
Если ~/.cursor/mcp.json не существует:
- Создайте каталог
.cursorв домашней папке (если его нет) - Создайте новый файл с именем
mcp.json - Начните с пустого JSON-объекта:
{}
Шаг 3: добавьте конфигурацию MCP-сервера Workify
Откройте ~/.cursor/mcp.json в текстовом редакторе и добавьте конфигурацию MCP-сервера Workify.
Если это ваш первый MCP-сервер
Если файл пуст или в нём нет раздела mcpServers, используйте такую структуру:
{
"mcpServers": {
"workify": {
"url": "https://app.workify.ru/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Если у вас уже есть другие MCP-серверы
Если у вас уже настроены MCP-серверы, добавьте Workify в существующий объект mcpServers:
{
"mcpServers": {
"existing-server": {
...
},
"workify": {
"url": "https://app.workify.ru/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
⚠️ Важно
- Замените
YOUR_API_KEYна фактический API-ключ, скопированный на шаге 1 - Между «Bearer» и вашим API-ключом должен быть пробел
- Не заключайте API-ключ в кавычки внутри значения заголовка
- Убедитесь, что JSON корректен (без завершающих запятых, с правильными кавычками)
Шаг 4: сохраните и перезапустите Cursor
- Сохраните файл
mcp.json - Полностью закройте Cursor (а не просто окно)
- Перезапустите Cursor
- Дождитесь полной инициализации Cursor
Альтернатива: перезагрузка окна
Некоторые версии Cursor поддерживают перезагрузку без полного перезапуска:
- Нажмите
Cmd+Shift+P(macOS) илиCtrl+Shift+P(Windows/Linux) - Введите «Reload Window» и выберите эту команду
Примечание: полный перезапуск надёжнее. Используйте перезагрузку, только если перезапуск не помогает.
Шаг 5: убедитесь, что инструменты доступны
После перезапуска убедитесь, что ИИ в Cursor видит MCP-инструменты Workify:
Проверочный запрос
В чате Cursor спросите:
Ожидаемый ответ:
ИИ должен перечислить такие инструменты, как:
list_tasksget_taskcreate_taskupdate_tasklist_projectsstart_time_tracking- И другие...
Шаг 6: первый тестовый рабочий процесс
Попробуйте эти рабочие процессы, чтобы протестировать соединение:
1. Список задач
Промпт:
Ожидается: ИИ перечисляет ваши задачи или сообщает, что их нет.
2. Открыть задачу
Промпт:
Ожидается: ИИ извлекает и отображает детали задачи, включая описание, статус и комментарии.
3. Добавить комментарий о прогрессе
Промпт:
Ожидается: ИИ добавляет комментарий к задаче.
Примечание: это операция записи. ИИ должен запросить подтверждение перед добавлением комментария.
Рабочие процессы, ориентированные на IDE
Интеграция Cursor с Workify открывает мощные рабочие процессы в IDE:
Связывание кода с задачами
Связывайте изменения в коде с задачами Workify:
Контекст задачи в редакторе
Получайте требования к задаче прямо во время написания кода:
Обновления прогресса
Фиксируйте прогресс прямо из вашего редактора:
Устранение неполадок
❌ Сбои подключения или авторизации
Возможные причины:
- Неверный API-ключ или неправильный формат заголовка
- API-ключ был отозван
- Проблемы с сетевым подключением
Решение:
- Убедитесь, что API-ключ активен в Workify: Настройки → Интеграции
- Проверьте формат заголовка:
"Authorization": "Bearer YOUR_API_KEY" - Убедитесь, что после «Bearer» есть пробел
- Попробуйте перевыпустить API-ключ
❌ Изменения не применяются после редактирования конфигурации
Возможные причины:
- Cursor не был полностью перезапущен
- Файл конфигурации находится не в том месте
- Синтаксические ошибки в JSON
Решение:
- Убедитесь, что файл конфигурации находится по пути
~/.cursor/mcp.json - Проверьте синтаксис JSON
- Полностью закройте и перезапустите Cursor (а не просто перезагрузите)
- Проверьте логи Cursor на наличие сообщений об ошибках
❌ Инструменты не отображаются
Возможные причины:
- Не удалось подключиться к MCP-серверу
- Сбой авторизации, при котором соединение всё же устанавливается
- Проблема с кэшированием на стороне клиента
Решение:
- Сначала проверьте подключение и авторизацию
- Попробуйте полный перезапуск (а не просто перезагрузку)
- Убедитесь, что URL эндпоинта верен
Читать руководство по устранению неполадок с инструментами →
Дальнейшие шаги
Рабочие процессы Cursor
Еженедельное планирование, отчёты о статусе и учёт времени прямо из вашей IDE
Рабочие процессы в редакторе
Реализуйте задачи и фиксируйте прогресс обратно в Workify
Подключите Cursor к Workify
Перенесите управление проектами в вашу IDE
Банковская карта не требуется