Интеграция ИИ-ассистента (MCP)

Обзор

Это руководство объясняет, как подключить ИИ-ассистентов, таких как Claude Desktop, Cursor, Windsurf и Continue, к вашему рабочему пространству Workify с помощью Model Context Protocol (MCP). После подключения ваш ИИ-ассистент сможет читать задачи, создавать задачи, отслеживать время и помогать вам работать эффективнее через естественный диалог.

Что вы узнаете:

Как получить ваш API-ключ
Универсальный формат конфигурации для всех клиентов
Руководства по настройке для конкретных клиентов
Как проверить ваше подключение
Что ваш ИИ может делать с Workify

Подробные инструкции по настройке для конкретных клиентов смотрите в наших специальных руководствах:

Настройка Claude Desktop — macOS, Windows, Linux
Настройка Cursor — с фокусом на IDE и примерами рабочих процессов
Настройка Windsurf — конфигурация через интерфейс настроек
Настройка Continue — конфигурация транспорта SSE

Что такое MCP?

MCP (Model Context Protocol) — это открытый стандарт, который позволяет ИИ-ассистентам подключаться к внешним инструментам и источникам данных. Благодаря MCP-интеграции Workify ваш ИИ-ассистент получает прямой доступ к вашим проектам, задачам и учёту времени.

Два способа подключения

Workify поддерживает два пути аутентификации. Выберите тот, который поддерживает ваш клиент:

Путь	Использовать для
OAuth-коннектор (Custom Connector) (рекомендуется)	claude.ai в вебе, интерфейс «Custom Connector» в Claude Desktop, ChatGPT MCP — любой клиент, который просит вас «Добавить пользовательский коннектор», указав только URL
API-ключ (Bearer-токен)	Cursor, Windsurf, Continue, классический `claude_desktop_config.json` в Claude Desktop и любой клиент, который принимает статический файл конфигурации

Оба пути дают ИИ один и тот же набор инструментов и одну и ту же область доступа (ваши данные Workify и ничьи больше).

Путь A — OAuth-коннектор (Claude, ChatGPT)

Если ваш клиент предлагает кнопку «Добавить пользовательский коннектор» или «Подключить MCP-сервер», которая запрашивает только URL, используйте этот путь. Копировать API-ключ не нужно.

В вашем ИИ-клиенте откройте экран настройки коннектора / MCP.
Введите URL: https://app.workify.ru/mcp
Клиент откроет окно браузера Workify. Войдите в Workify, если вы ещё не вошли.
Проверьте экран Authorize — на нём показано, какой клиент запрашивает доступ и что он может делать (читать задачи, создавать задачи, отслеживать время и т. д.). Нажмите Authorize.
Браузер вернёт вас в ИИ-клиент; коннектор теперь активен.

Вы можете отозвать это подключение в любой момент в разделе Настройки → Интеграции → ИИ-ассистенты → Подключённые ИИ-клиенты.

Путь B — API-ключ (Cursor, Windsurf, Continue, классические файлы конфигурации)

Используйте его для клиентов, которые принимают статический JSON-конфиг и Bearer-токен:

Перейдите в Настройки → Интеграции
Найдите раздел Public API
Нажмите Add API Key
Немедленно скопируйте сгенерированный ключ (он показывается только один раз)
Сохраните его в надёжном месте — он понадобится вам для конфигурации

Совет: Создавайте отдельные API-ключи для разных ИИ-ассистентов, чтобы управлять доступом независимо.

Универсальная конфигурация

Всем MCP-клиентам для подключения к Workify нужны эти два фрагмента информации:

URL эндпоинта:

https://app.workify.ru/mcp

Заголовок авторизации:

Authorization: Bearer YOUR_API_KEY

Замените YOUR_API_KEY на API-ключ, который вы скопировали на предыдущем шаге.

Формат конфигурации

Точная структура JSON различается в зависимости от клиента, но всем клиентам нужны:

URL эндпоинта Workify: https://app.workify.ru/mcp
Заголовок авторизации с вашим API-ключом: Bearer YOUR_API_KEY

Пример структуры конфигурации (формат различается в зависимости от клиента):

{
  "mcpServers": {
    "workify": {
      "url": "https://app.workify.ru/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Примечание: Continue использует немного другой формат с транспортом SSE. Подробности смотрите в руководстве по настройке Continue.

Настройка для конкретных клиентов

У каждого ИИ-ассистента своё расположение файла конфигурации и свой формат. Следуйте специальному руководству по настройке для вашего клиента:

Настройка Claude Desktop — пошаговое руководство для macOS, Windows и Linux
Настройка Cursor — настройка с фокусом на IDE и примерами рабочих процессов
Настройка Windsurf — руководство по конфигурации через интерфейс настроек
Настройка Continue — конфигурация транспорта SSE

Каждое руководство включает:

Точное расположение файлов конфигурации для вашей операционной системы
Полные фрагменты JSON-конфигурации с плейсхолдерами
Инструкции для конкретной платформы
Советы по устранению неполадок

Контрольный список проверки

После настройки вашего ИИ-ассистента используйте этот контрольный список, чтобы убедиться, что всё работает:

✅ Шаг 1: Файл конфигурации

Файл конфигурации существует и находится в правильном месте
Синтаксис JSON корректен (нет висячих запятых, правильные кавычки)
URL эндпоинта в точности: https://app.workify.ru/mcp
Заголовок авторизации использует формат: Bearer YOUR_API_KEY (с пробелом после «Bearer»)
API-ключ скопирован правильно (без лишних пробелов или символов)

✅ Шаг 2: Перезапуск клиента

ИИ-ассистент был полностью перезапущен (не просто перезагружен)
Все окна/экземпляры клиента были закрыты и открыты заново

✅ Шаг 3: Проверьте доступность инструментов

Проверьте, что ваш ИИ-ассистент видит инструменты Workify, спросив:

Для Claude Desktop, Cursor или Windsurf:

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

Для Continue:

«Перечисли доступные MCP-инструменты»

Ожидаемый результат: Ваш ИИ должен перечислить MCP-инструменты Workify, такие как list_tasks, create_task, start_time_tracking и т. д.

✅ Шаг 4: Проверьте операцию чтения

Попробуйте простую операцию чтения:

«Перечисли мои задачи из Workify»

Ожидаемый результат: Ваш ИИ должен получить и показать ваши задачи (или сказать, что задач нет).

✅ Шаг 5: Проверьте статус подключения

Спросите ваш ИИ:

«Можешь ли ты подключиться к Workify?»

Ожидаемый результат: Ваш ИИ должен подтвердить, что имеет доступ к инструментам Workify.

Распространённые проблемы

Если инструменты не появляются:

Убедитесь, что расположение файла конфигурации правильное для вашей ОС
Проверьте, что синтаксис JSON корректен (используйте валидатор JSON)
Убедитесь, что вы полностью перезапустили клиента
Проверьте, что API-ключ активен в разделе Настройки → Интеграции

Если вы получаете «Authorization failed»:

Проверьте формат заголовка авторизации: Bearer YOUR_API_KEY (с пробелом)
Убедитесь, что API-ключ правильный и активный
Убедитесь, что в ключе нет лишних пробелов или символов

Если подключение не удаётся:

Проверьте ваше интернет-соединение
Проверьте, доступен ли https://app.workify.ru в вашем браузере
Попробуйте перегенерировать ваш API-ключ

Для получения дополнительной помощи по устранению неполадок смотрите наши руководства по устранению неполадок MCP.

Что может делать ваш ИИ

Читать информацию

Ваш ИИ-ассистент может получать:

Детали задачи — полное описание, комментарии, даты, исполнители
Обзор доски — колонки, количество задач, контекст проекта
Информацию о проекте — клиент, статус, связанные доски

Выполнять действия

Ваш ИИ-ассистент может выполнять:

Создание задач — добавлять новые задачи с описаниями, датами и назначениями
Обновление задач — менять статус, перемещать между колонками, обновлять детали
Добавление комментариев — документировать выполненную работу или оставлять заметки
Учёт времени — запускать и останавливать отслеживание времени по задачам
Поиск и просмотр списков — находить задачи, проекты и доски

Примеры диалогов

Общая продуктивность (Claude Desktop)

Вы: «Какие задачи нужно сдать на этой неделе?» ИИ: Перечисляет ваши предстоящие задачи со сроками и проектами

Вы: «Создай задачу связаться с Acme Corp по поводу предложения» ИИ: Создаёт новую задачу и подтверждает детали

Вы: «Начни отслеживать время по моей текущей задаче» ИИ: Запускает таймер по вашей активной задаче

Рабочий процесс разработки (Cursor)

Вы: Делитесь ссылкой на задачу Workify «Помоги мне реализовать эту функцию» ИИ: Читает требования задачи и помогает вам написать код

Вы: «Добавь комментарий к задаче #123, что я завершил изменения API» ИИ: Добавляет комментарий, документирующий вашу работу

Вы: «Каковы критерии приёмки для этой задачи?» ИИ: Получает и показывает описание задачи и комментарии

Доступные инструменты

Инструмент	Описание
`list_tasks`	Поиск и фильтрация задач по проекту, доске или ключевому слову
`get_task`	Получить полные детали конкретной задачи
`create_task`	Создать новую задачу с названием, описанием, датами
`update_task`	Обновить детали задачи или переместить в другую колонку
`delete_task`	Удалить задачу навсегда
`list_projects`	Перечислить все проекты, к которым у вас есть доступ
`get_project`	Получить детали проекта и связанные доски
`list_boards`	Перечислить доски, опционально с фильтром по проекту
`get_board`	Получить детали доски, включая колонки
`list_task_comments`	Получить все комментарии к задаче
`add_task_comment`	Добавить комментарий к задаче
`start_time_tracking`	Начать отслеживание времени по задаче
`stop_time_tracking`	Остановить текущую сессию отслеживания времени
`get_tracking_status`	Проверить, активно ли отслеживание времени

Замечания по безопасности

Ваш API-ключ предоставляет полный доступ к вашим данным Workify — храните его в безопасности
Никогда не делитесь вашим API-ключом и не добавляйте его в систему контроля версий
Вы можете деактивировать или удалить API-ключи в любой момент в разделе Настройки → Интеграции
Каждый API-запрос ограничен областью данных только вашей команды

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

«Authorization failed» или «Invalid API key»

Дважды проверьте, что вы скопировали API-ключ полностью
Убедитесь, что ключ активен в разделе Настройки → Интеграции → Public API
Убедитесь, что вы используете префикс Bearer, за которым следует пробел перед ключом

ИИ не видит инструменты Workify

Перезапустите ваш ИИ-ассистент после добавления конфигурации
Убедитесь, что URL MCP-сервера правильный: https://app.workify.ru/mcp
Проверьте, что JSON-конфигурация корректна (нет синтаксических ошибок)

Ошибки «Connection refused»

Проверьте ваше интернет-соединение
Проверьте, доступен ли Workify в вашем браузере
Попробуйте перегенерировать ваш API-ключ

Поддержка

Нужна помощь? Свяжитесь с нашей командой поддержки или ознакомьтесь с документацией по Public API для получения более подробной информации об используемом API.