Workify logo Единственный бизнес-инструмент, который вам нужен Workify
Menu

Настройка MCP Workify для Cursor: подключите задачи и проекты к вашему редактору

Подключите Cursor к Workify через MCP, чтобы перенести управление проектами прямо в вашу IDE. В этом руководстве показано, как добавить Workify в качестве MCP-сервера, перезапустить/перезагрузить редактор и протестировать первый рабочий процесс.

Предварительные требования

Шаг 1: получите свой API-ключ Workify

  1. Войдите в Workify
  2. Перейдите в НастройкиИнтеграции
  3. Найдите раздел Публичный API
  4. Нажмите Добавить API-ключ
  5. Сразу же скопируйте ключ (он показывается только один раз)
  6. Сохраните его в надёжном месте — он понадобится на следующем шаге

💡 Совет

Давайте 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 не существует:

  1. Создайте каталог .cursor в домашней папке (если его нет)
  2. Создайте новый файл с именем mcp.json
  3. Начните с пустого 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

  1. Сохраните файл mcp.json
  2. Полностью закройте Cursor (а не просто окно)
  3. Перезапустите Cursor
  4. Дождитесь полной инициализации Cursor

Альтернатива: перезагрузка окна

Некоторые версии Cursor поддерживают перезагрузку без полного перезапуска:

  • Нажмите Cmd+Shift+P (macOS) или Ctrl+Shift+P (Windows/Linux)
  • Введите «Reload Window» и выберите эту команду

Примечание: полный перезапуск надёжнее. Используйте перезагрузку, только если перезапуск не помогает.

Шаг 5: убедитесь, что инструменты доступны

После перезапуска убедитесь, что ИИ в Cursor видит MCP-инструменты Workify:

Проверочный запрос

В чате Cursor спросите:

«Какие MCP-инструменты доступны из Workify?»

Ожидаемый ответ:

ИИ должен перечислить такие инструменты, как:

  • list_tasks
  • get_task
  • create_task
  • update_task
  • list_projects
  • start_time_tracking
  • И другие...

Шаг 6: первый тестовый рабочий процесс

Попробуйте эти рабочие процессы, чтобы протестировать соединение:

1. Список задач

Промпт:

«Какие задачи у меня есть в Workify?»

Ожидается: ИИ перечисляет ваши задачи или сообщает, что их нет.

2. Открыть задачу

Промпт:

«Покажи детали задачи [название задачи]»

Ожидается: ИИ извлекает и отображает детали задачи, включая описание, статус и комментарии.

3. Добавить комментарий о прогрессе

Промпт:

«Добавь к задаче [название задачи] комментарий: „Изменения API завершены, готово к проверке“»

Ожидается: ИИ добавляет комментарий к задаче.

Примечание: это операция записи. ИИ должен запросить подтверждение перед добавлением комментария.

Рабочие процессы, ориентированные на IDE

Интеграция Cursor с Workify открывает мощные рабочие процессы в IDE:

Связывание кода с задачами

Связывайте изменения в коде с задачами Workify:

«Я работаю над задачей по функции входа. Помоги мне реализовать её, а затем добавь комментарий по завершении.»

Контекст задачи в редакторе

Получайте требования к задаче прямо во время написания кода:

«Каковы критерии приёмки для задачи по дашборду?»

Обновления прогресса

Фиксируйте прогресс прямо из вашего редактора:

«Обнови статус задачи по рефакторингу API на „в работе“ и добавь комментарий о внесённых мной изменениях.»

Устранение неполадок

❌ Сбои подключения или авторизации

Возможные причины:

  • Неверный API-ключ или неправильный формат заголовка
  • API-ключ был отозван
  • Проблемы с сетевым подключением

Решение:

  1. Убедитесь, что API-ключ активен в Workify: Настройки → Интеграции
  2. Проверьте формат заголовка: "Authorization": "Bearer YOUR_API_KEY"
  3. Убедитесь, что после «Bearer» есть пробел
  4. Попробуйте перевыпустить API-ключ

Читать руководство по устранению ошибки 401 →

Читать руководство по устранению неполадок подключения →

❌ Изменения не применяются после редактирования конфигурации

Возможные причины:

  • Cursor не был полностью перезапущен
  • Файл конфигурации находится не в том месте
  • Синтаксические ошибки в JSON

Решение:

  1. Убедитесь, что файл конфигурации находится по пути ~/.cursor/mcp.json
  2. Проверьте синтаксис JSON
  3. Полностью закройте и перезапустите Cursor (а не просто перезагрузите)
  4. Проверьте логи Cursor на наличие сообщений об ошибках

Читать об устранении неполадок с перезагрузкой Cursor →

❌ Инструменты не отображаются

Возможные причины:

  • Не удалось подключиться к MCP-серверу
  • Сбой авторизации, при котором соединение всё же устанавливается
  • Проблема с кэшированием на стороне клиента

Решение:

  1. Сначала проверьте подключение и авторизацию
  2. Попробуйте полный перезапуск (а не просто перезагрузку)
  3. Убедитесь, что URL эндпоинта верен

Читать руководство по устранению неполадок с инструментами →

Дальнейшие шаги

Подключите Cursor к Workify

Перенесите управление проектами в вашу IDE

Банковская карта не требуется

Continue Reading

Настройка MCP Workify для Continue

Руководство по интеграции Continue с акцентом на удалённый транспорт SSE. Содержит фрагменты конфигурации, шаги проверки...

Как подключить любой MCP-клиент к удалённому MCP-серверу

Универсальное руководство по подключению любого MCP-клиента к удалённому MCP-серверу. Включает готовый чек-лист, настрой...