Устранение неполадок MCP в Claude Desktop: сервер не отображается

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

Быстрый справочник «симптом — решение»

Шаг 1: проверьте расположение файла конфигурации

Сначала убедитесь, что вы редактируете правильный файл конфигурации. Расположение зависит от операционной системы:

macOS

Путь к файлу конфигурации:

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

Как проверить:

1. Откройте Finder
2. Нажмите Cmd+Shift+G
3. Вставьте: ~/Library/Application Support/Claude
4. Убедитесь, что файл claude_desktop_config.json существует

Windows

Путь к файлу конфигурации:

%APPDATA%\Claude\claude_desktop_config.json

Как проверить:

1. Нажмите Win+R
2. Введите: %APPDATA%\Claude
3. Нажмите Enter
4. Убедитесь, что файл claude_desktop_config.json существует

Linux

Путь к файлу конфигурации:

~/.config/Claude/claude_desktop_config.json

Как проверить:

1. Откройте терминал
2. Выполните: ls -la ~/.config/Claude/claude_desktop_config.json
3. Убедитесь, что файл существует и доступен для чтения

Файл не существует?

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

1. Создайте каталог при необходимости (например, ~/.config/Claude/ в Linux)
2. Создайте файл claude_desktop_config.json
3. Начните с: {}
4. Добавьте конфигурацию MCP-сервера

Шаг 2: проверьте синтаксис JSON

Невалидный JSON помешает Claude Desktop загрузить конфигурацию. Проверьте распространённые ошибки:

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

• Замыкающие запятые: после последнего элемента в объекте или массиве не должно быть запятой
• Отсутствующие кавычки: все ключи и строковые значения должны быть в двойных кавычках
• Неверная вложенность: убедитесь, что скобки и фигурные скобки корректно сопоставлены
• Комментарии: JSON не поддерживает комментарии (удалите любые // или /* */)

Правильный формат конфигурации

Ваша конфигурация должна выглядеть так (замените YOUR_API_KEY на ваш реальный ключ):

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

Проверьте JSON онлайн

Используйте онлайн-валидатор JSON для проверки синтаксиса:

1. Скопируйте всё содержимое файла конфигурации
2. Вставьте в JSONLint или аналогичный валидатор
3. Исправьте все указанные ошибки
4. Сохраните исправленный файл

Шаг 3: проверьте API-ключ

Убедитесь, что ваш API-ключ верный и активный:

Чек-лист API-ключа:

• ✅ Ключ скопирован корректно (без лишних пробелов или переносов строк)
• ✅ Ключ включает префикс «Bearer » (с пробелом) в заголовке
• ✅ Ключ активен в разделе Workify Settings → Integrations
• ✅ Ключ не отозван и не просрочен
• ✅ Ключ имеет необходимые разрешения

Протестируйте API-ключ

Убедитесь, что ваш API-ключ работает, протестировав конечную точку:

export WORKIFY_API_KEY="YOUR_API_KEY"
curl -H "Authorization: Bearer $WORKIFY_API_KEY" \
  https://app.workify.ru/mcp

Примечание. Если сканеры секретов всё равно отмечают этот пример, рассмотрите возможность добавить конечную точку в список разрешённых или использовать тестовый API-ключ специально для целей документации.

Если вы получаете ошибку 401 Unauthorized, см. наше руководство по устранению ошибки 401.

Шаг 4: перезапустите Claude Desktop

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

macOS

1. Полностью закройте Claude Desktop (Cmd+Q или правый клик по иконке в доке → Quit)
2. Подождите несколько секунд
3. Снова откройте Claude Desktop
4. Проверьте, появляется ли Workify MCP в списке серверов

Windows

1. Полностью закройте Claude Desktop (проверьте системный трей)
2. Подождите несколько секунд
3. Снова откройте Claude Desktop
4. Проверьте, появляется ли Workify MCP в списке серверов

Linux

1. Полностью закройте Claude Desktop
2. Подождите несколько секунд
3. Снова откройте Claude Desktop
4. Проверьте, появляется ли Workify MCP в списке серверов

Не просто сворачивание

Убедитесь, что вы полностью закрыли Claude Desktop, а не просто свернули его. На некоторых системах может потребоваться проверить системный трей или Мониторинг системы / Диспетчер задач, чтобы убедиться, что приложение полностью закрыто.

Шаг 5: проверочные запросы

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

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

Попробуйте эти запросы, чтобы убедиться, что Workify MCP работает:

• «Какие MCP-серверы доступны?»
• «Перечисли доступные MCP-инструменты»
• «Можешь ли ты получить доступ к задачам Workify?»
• «Покажи мои проекты Workify»

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

Если Workify MCP работает, Claude должен:

• Указать Workify как доступный MCP-сервер
• Показать доступные инструменты, такие как list_tasks, create_task и т. д.
• Иметь возможность выполнять вызовы инструментов к Workify

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

Если сервер появляется, но инструменты не загружаются:

• Ознакомьтесь с руководством Инструменты не отображаются
• Убедитесь, что ваш API-ключ имеет правильные разрешения
• Проверьте наличие ошибок подключения в логах Claude Desktop

Всё ещё не работает?

Если вы попробовали все описанные выше шаги, а Workify MCP по-прежнему не появляется:

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

Связанные руководства

• Ошибки JSON в конфигурации — исправление невалидного синтаксиса JSON и ошибок схемы
• Ошибка подключения — диагностика проблем сети и подключения
• Инструменты не отображаются — исправление проблем, когда инструменты не появляются
• Указатель по устранению неполадок — просмотр всех руководств по устранению неполадок