Устранение неполадок MCP в Windsurf: заголовки авторизации не отправляются

Windsurf подключается к Workify MCP, но вызовы инструментов не срабатывают? Это специфичное для Windsurf руководство по устранению неполадок поможет вам исправить случаи, когда сервер подключается, но вызовы инструментов не срабатывают из-за отсутствующих заголовков авторизации. Узнайте, как проверить конфигурацию заголовков, и получите рабочий пример.

Понимание проблемы

Windsurf может успешно установить соединение с MCP-сервером, но при выполнении вызовов инструментов заголовок Authorization не отправляется, из-за чего вызовы инструментов завершаются ошибками 401.

Характерная картина симптомов

MCP-сервер отображается в Windsurf как «connected»
Инструменты могут появляться в списке инструментов
Но вызовы инструментов завершаются ошибкой 401 Unauthorized
Ошибка указывает на отсутствующий или недействительный заголовок Authorization

Шаг 1: проверьте конфигурацию заголовков

Убедитесь, что ваша конфигурация MCP в Windsurf включает заголовок Authorization:

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

Рабочая конфигурация Windsurf

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

Критически важные моменты:

Объект headers должен присутствовать
Ключ Authorization должен быть именно «Authorization» (с учётом регистра)
Значение должно быть «Bearer », за которым следует ваш API-ключ (с пробелом)
Никаких лишних пробелов или проблем с форматированием

Распространённые ошибки конфигурации

Примечание. Приведённые ниже примеры JSON содержат встроенные комментарии // только для пояснения. Эти комментарии не являются валидным JSON и должны быть удалены при создании реального файла конфигурации.

Отсутствует объект headers

{
  "mcpServers": {
    "workify": {
      "url": "https://app.workify.ru/mcp"
      // Missing "headers" object
    }
  }
}

Решение: добавьте объект headers с ключом Authorization. Примечание: приведённый выше пример содержит поясняющий комментарий (не валидный JSON) — удалите строку с комментарием при создании конфигурации.

Неправильное имя ключа заголовка

{
  "mcpServers": {
    "workify": {
      "url": "https://app.workify.ru/mcp",
      "headers": {
        "authorization": "Bearer YOUR_API_KEY"  // Wrong case
        // or
        "Auth": "Bearer YOUR_API_KEY"  // Wrong name
      }
    }
  }
}

Решение: используйте именно "Authorization" (заглавная A, остальное строчными). Примечание: приведённый выше пример содержит поясняющие комментарии (не валидный JSON) — удалите строки с комментариями при создании конфигурации.

Отсутствует префикс Bearer

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

Решение: включите префикс «Bearer »: "Bearer YOUR_API_KEY". Примечание: приведённый выше пример содержит поясняющий комментарий (не валидный JSON) — удалите комментарий при создании конфигурации.

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

Если вы используете интерфейс настроек Windsurf (а не JSON-файл), убедитесь, что заголовок настроен правильно:

Настройка через интерфейс настроек

В Windsurf Settings → MCP Servers:

Найдите запись MCP-сервера Workify
Проверьте раздел «Headers» или «Authentication»
Убедитесь, что заголовок «Authorization» присутствует
Значение должно быть: Bearer YOUR_API_KEY
Сохраните настройки
При необходимости перезапустите Windsurf

Интерфейс настроек против JSON-файла

Источник конфигурации

Windsurf может использовать один из вариантов:

Интерфейс настроек: настройка через интерфейс настроек Windsurf
JSON-файл: настройка в файле конфигурации (расположение варьируется)

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

Шаг 3: проверьте передачу заголовков

Убедитесь, что Windsurf действительно отправляет заголовок Authorization:

Диагностические шаги

Проверьте, отправляются ли заголовки:

Попробуйте простой вызов инструмента: «List my projects»
Если он завершается ошибкой 401, проверьте сообщение об ошибке
Ошибка должна указывать на отсутствующий заголовок Authorization
Сравните с рабочим тестом curl (см. ниже)

Сравните с тестом curl

Тест с помощью curl (должен работать)

curl -H "Authorization: Bearer <API_KEY_PLACEHOLDER>" \
  https://app.workify.ru/mcp

Если curl работает, а Windsurf нет, значит проблема в передаче заголовков в Windsurf.

Шаг 4: рабочий пример фрагмента

Вот полный рабочий пример конфигурации Windsurf:

Полная рабочая конфигурация

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

Замените YOUR_API_KEY на ваш реальный API-ключ Workify.

Пример с несколькими серверами

Если у вас несколько MCP-серверов:

{
  "mcpServers": {
    "workify": {
      "url": "https://app.workify.ru/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_WORKIFY_API_KEY"
      }
    },
    "other-server": {
      "url": "https://other-server.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_OTHER_API_KEY"
      }
    }
  }
}

Шаг 5: перезапустите Windsurf

После исправления конфигурации заголовков перезапустите Windsurf, чтобы применить изменения:

Шаги перезапуска

Сохраните вашу конфигурацию (JSON-файл или интерфейс настроек)
Полностью закройте Windsurf
Подождите несколько секунд
Снова откройте Windsurf
Протестируйте простым вызовом инструмента

Шаг 6: убедитесь, что заголовок отправляется

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

Тестовые вызовы инструментов

Попробуйте эти тестовые запросы:

«List my Workify projects» (проверяет list_projects)
«Show me my tasks» (проверяет list_tasks)
«What MCP tools are available?» (проверяет обнаружение инструментов)

Если они работают, значит заголовки отправляются правильно. Если они завершаются ошибкой 401, заголовки по-прежнему не передаются.

Ожидаемое поведение

Когда заголовки работают правильно:

Вызовы инструментов успешны (нет ошибок 401)
Вы получаете реальные данные (проекты, задачи и т. д.)
Нет ошибок «unauthorized» или «missing header»

Чек-лист быстрого решения

Перед эскалацией

✅ Конфигурация включает объект headers
✅ Ключ Authorization — именно «Authorization» (с учётом регистра)
✅ Значение заголовка — «Bearer YOUR_API_KEY» (с пробелом после Bearer)
✅ API-ключ активен и не отозван
✅ Файл конфигурации является валидным JSON (если используется JSON-файл)
✅ Настройки сохранены в Windsurf (если используется интерфейс настроек)
✅ Windsurf полностью перезапущен после изменений конфигурации
✅ Протестировано с помощью curl — работает (подтверждает валидность API-ключа)

Всё ещё есть проблемы?

Если заголовки по-прежнему не отправляются после всех шагов:

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

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

401 Unauthorized — общее устранение проблем с аутентификацией
Инструменты не отображаются — исправление проблем, когда инструменты не появляются
Настройка Windsurf — обзор руководства по настройке MCP в Windsurf
Указатель по устранению неполадок — просмотр всех руководств по устранению неполадок