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

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

Универсальный чек-лист подключения

Независимо от того, какой MCP-клиент вы используете, вам нужно выполнить эти шаги:

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

Перед подключением вам нужен API-ключ с MCP-сервера. Для Workify:

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

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

Каждый MCP-клиент хранит свою конфигурацию в разном месте. Вот распространённые расположения:

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

• Руководство по настройке Claude Desktop
• Руководство по настройке Cursor
• Руководство по настройке Windsurf
• Руководство по настройке Continue

Шаг 3: Добавьте URL эндпоинта сервера

URL эндпоинта - это адрес, по которому ваш MCP-клиент будет подключаться к серверу. Для Workify это:

Этот URL должен быть:

• HTTPS: всегда используйте защищённые соединения (никогда HTTP)
• Точным: копируйте URL точно - без завершающих слэшей
• Доступным: убедитесь, что ваша сеть может достичь этого эндпоинта (при необходимости проверьте брандмауэры/прокси)

Шаг 4: Добавьте заголовок Authorization

Большинство MCP-клиентов требуют указания заголовков аутентификации. Для Workify нужно добавить заголовок Authorization с вашим API-ключом.

Примеры фрагментов конфигурации

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

{
  "mcpServers": [
    {
      "name": "workify",
      "transport": {
        "type": "sse",
        "url": "https://app.workify.ru/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_API_KEY"
        }
      }
    }
  ]
}

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

После добавления конфигурации:

1. Сохраните файл конфигурации (если редактируете файл)
2. Проверьте синтаксис JSON (используйте валидатор JSON, если не уверены)
3. Полностью перезапустите вашего AI-клиента - требуется закрыть и снова открыть
4. Дождитесь инициализации клиента - это может занять несколько секунд

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

После перезапуска убедитесь, что ваш AI-клиент видит инструменты MCP-сервера. Вот как это проверить:

Ожидаемый список инструментов

Для Workify вы должны увидеть эти инструменты (и другие):

• list_tasks - поиск и фильтрация задач
• get_task - получение деталей задачи
• create_task - создание новых задач
• update_task - обновление деталей задачи
• list_projects - список проектов
• start_time_tracking - запуск таймера
• И многое другое... (см. полный справочник по инструментам)

Шаг 7: Первый тестовый запрос

Как только инструменты станут видны, протестируйте простую операцию только для чтения:

Пример: тестирование с Workify

Устранение проблем с подключением

Если инструменты не появляются или вы получаете ошибки, проверьте эти распространённые проблемы:

Руководства для конкретных клиентов

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