Настройка MCP Workify для Claude Desktop (macOS, Windows, Linux)

Пошаговое руководство по подключению Claude Desktop к Workify через MCP. Этот учебник охватывает расположение конфигурационных файлов для всех операционных систем, структуру JSON, проверку и распространённые способы устранения неполадок.

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

Claude Desktop установлен в вашей системе
Аккаунт Workify с доступом к API-ключу
Базовые навыки редактирования JSON-файлов

Шаг 1: Получите ваш API-ключ Workify

Войдите в Workify
Перейдите в Настройки → Интеграции
Найдите раздел Публичный API
Нажмите Добавить API-ключ
Скопируйте ключ сразу же (он отображается только один раз)
Храните его в безопасном месте - он понадобится на следующем шаге

💡 Совет

Дайте API-ключу описательное имя (например, «Claude Desktop - MacBook Pro»), чтобы легко управлять несколькими ключами.

Шаг 2: Найдите ваш файл конфигурации

Расположение файла конфигурации зависит от вашей операционной системы:

macOS

Путь:

~/Library/Application Support/Claude/claude_desktop_config.json

Чтобы открыть в Finder: нажмите Cmd+Shift+G и вставьте путь.

Windows

Путь:

%APPDATA%\Claude\claude_desktop_config.json

Чтобы открыть в Проводнике: нажмите Win+R, введите %APPDATA%\Claude и нажмите Enter.

Linux

Путь:

~/.config/Claude/claude_desktop_config.json

Символ ~ обозначает вашу домашнюю директорию.

Если файл не существует

Если файл конфигурации ещё не существует:

Создайте директорию при необходимости (например, ~/.config/Claude/ на Linux)
Создайте новый файл с именем claude_desktop_config.json
Начните с пустого JSON-объекта: {}

Шаг 3: Добавьте конфигурацию MCP-сервера Workify

Откройте файл конфигурации в текстовом редакторе и добавьте MCP-сервер Workify. Точная структура зависит от того, настроены ли у вас уже другие MCP-серверы.

Если это ваш первый 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: Проверьте синтаксис JSON

Перед сохранением проверьте ваш JSON, чтобы избежать ошибок:

Онлайн-валидатор: используйте jsonlint.com или аналогичный
Командная строка: python -m json.tool claude_desktop_config.json
VS Code: редактор подсветит ошибки синтаксиса JSON

Распространённые ошибки JSON

Завершающие запятые (например, "key": "value", в последнем элементе)
Отсутствие кавычек вокруг ключей или строковых значений
Одинарные кавычки вместо двойных
Отсутствие запятых между свойствами объекта

Шаг 5: Сохраните и перезапустите Claude Desktop

Сохраните файл конфигурации
Полностью закройте Claude Desktop (не просто сверните)
Перезапустите Claude Desktop
Дождитесь полной инициализации Claude (может занять несколько секунд)

Почему требуется перезапуск

Claude Desktop загружает конфигурацию MCP-сервера только при запуске. Просто сохранить файл недостаточно - для вступления изменений в силу необходимо полностью закрыть и перезапустить приложение.

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

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

Запрос для проверки

Спросите Claude:

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

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

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

list_tasks
get_task
create_task
update_task
list_projects
start_time_tracking
И многое другое...

Первый тест: список ваших задач

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

Запрос:

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

Ожидается: Claude должен перечислить ваши задачи (или сказать, что их нет, если ваше рабочее пространство пусто).

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

❌ «Ошибка авторизации» или ошибка 401

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

API-ключ некорректен или содержит лишние пробелы
Отсутствует префикс «Bearer» или пробел после «Bearer»
API-ключ был отозван или удалён
Завершающие пробелы при копировании ключа

Исправление:

Убедитесь, что ключ активен в Workify: Настройки → Интеграции
Проверьте формат заголовка: "Authorization": "Bearer YOUR_API_KEY" (с пробелом)
При необходимости сгенерируйте API-ключ заново

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

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

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

Claude Desktop не был полностью перезапущен
Ошибка синтаксиса JSON в файле конфигурации
Файл конфигурации в неправильном расположении
Подключение к MCP-серверу молча не удалось

Исправление:

Проверьте синтаксис JSON (используйте jsonlint.com)
Убедитесь, что файл конфигурации находится в правильном расположении для вашей ОС
Полностью закройте и перезапустите Claude Desktop
Проверьте логи Claude Desktop на наличие сообщений об ошибках

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

❌ «Подключение отклонено» или сетевая ошибка

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

Проблемы с интернет-подключением
Брандмауэр блокирует HTTPS-соединения
Корпоративный прокси мешает работе
Сервис Workify временно недоступен

Исправление:

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

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

❌ Ошибка недопустимого JSON

Распространённые ошибки:

Завершающая запятая после последнего свойства
Отсутствие кавычек вокруг ключей или значений
Одинарные кавычки вместо двойных
Отсутствие запятой между свойствами

Исправление:

Используйте валидатор JSON (jsonlint.com)
Проверьте наличие завершающих запятых
Убедитесь, что все строки используют двойные кавычки

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

Примеры рабочих процессов

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

Еженедельное планирование

Запрос:

«Какие задачи должны быть выполнены на этой неделе в Workify? Покажи, что предстоит сделать, что заблокировано и что мне следует приоритизировать.»

Создать задачу-напоминание

Запрос:

«Создай задачу, чтобы связаться с Acme Corp на следующей неделе. Покажи, что ты создашь, прежде чем создавать.»

Учёт времени

Запрос:

«Начни отслеживать время по задаче [название задачи]»

Больше рабочих процессов в нашем руководстве по сценариям использования.

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

Рабочие процессы Claude Desktop

Запросы для еженедельного планирования, отчётов о статусе и учёта времени

Лучшие практики безопасности

Управление API-ключами и безопасные операции записи

Готовы начать?

Подключите Claude Desktop к Workify за считанные минуты

Начать бесплатный период → Быстрый старт за 5 минут

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

Настройка MCP Workify для Claude Desktop (macOS, Windows, Linux)

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

Шаг 1: Получите ваш API-ключ Workify

Шаг 2: Найдите ваш файл конфигурации

macOS

Windows

Linux

Если файл не существует

Шаг 3: Добавьте конфигурацию MCP-сервера Workify

Если это ваш первый MCP-сервер

Если у вас уже есть другие MCP-серверы

Шаг 4: Проверьте синтаксис JSON

Шаг 5: Сохраните и перезапустите Claude Desktop

Почему требуется перезапуск

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

Запрос для проверки

Первый тест: список ваших задач

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

❌ «Ошибка авторизации» или ошибка 401

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

❌ «Подключение отклонено» или сетевая ошибка

❌ Ошибка недопустимого JSON

Примеры рабочих процессов

Еженедельное планирование

Создать задачу-напоминание

Учёт времени

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

Рабочие процессы Claude Desktop

Лучшие практики безопасности

Готовы начать?

Continue Reading

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

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