Налаштування популярних клієнтів MCP Host

Цей посібник охоплює, як налаштувати та використовувати сервери MCP з популярними AI-хостами. Кожен хост має свій підхід до конфігурації, але після налаштування всі вони спілкуються з серверами MCP за допомогою стандартизованого протоколу.

Що таке MCP Host?

MCP Host — це AI-додаток, який може підключатися до серверів MCP для розширення своїх можливостей. Уявіть це як "фронтенд", з яким взаємодіють користувачі, а сервери MCP постачають інструменти та дані у "бекенді".

flowchart LR
    User[👤 Користувач] --> Host[🖥️ MCP Хост]
    Host --> S1[MCP Сервер A]
    Host --> S2[MCP Сервер B]
    Host --> S3[MCP Сервер C]
    
    subgraph "Популярні хости"
        H1[Claude Desktop]
        H2[VS Code]
        H3[Cursor]
        H4[Cline]
        H5[Windsurf]
    end

Передумови

Сервер MCP для підключення (див. Модуль 3.1 - Перший сервер)
Встановлений хост-додаток на вашій системі
Базове знайомство з файлами конфігурації JSON

1. Claude Desktop

Claude Desktop — офіційний десктопний додаток Anthropic, що нативно підтримує MCP.

Встановлення

Завантажте Claude Desktop з claude.ai/download
Встановіть та увійдіть у свій обліковий запис Anthropic

Конфігурація

Claude Desktop використовує JSON-файл конфігурації для визначення серверів MCP.

Розташування файлу конфігурації:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Приклад конфігурації:

{
  "mcpServers": {
    "calculator": {
      "command": "python",
      "args": ["-m", "mcp_calculator_server"],
      "env": {
        "PYTHONPATH": "/path/to/your/server"
      }
    },
    "weather": {
      "command": "node",
      "args": ["/path/to/weather-server/build/index.js"]
    },
    "database": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@localhost/mydb"
      }
    }
  }
}

Варіанти конфігурації

Поле	Опис	Приклад
`command`	Виконуваний файл для запуску	`"python"`, `"node"`, `"npx"`
`args`	Аргументи командного рядка	`["-m", "my_server"]`
`env`	Змінні середовища	`{"API_KEY": "xxx"}`
`cwd`	Робоча директорія	`"/path/to/server"`

Тестування вашого налаштування

Збережіть файл конфігурації
Повністю перезапустіть Claude Desktop (закрийте та відкрийте знову)
Відкрийте нову розмову
Зверніть увагу на іконку 🔌, що позначає підключені сервери
Спробуйте попросити Claude скористатися одним із ваших інструментів

Вирішення проблем Claude Desktop

Сервер не з’являється:

Перевірте синтаксис конфігурації за допомогою валідатора JSON
Переконайтеся, що шлях до виконуваного файлу правильний
Перегляньте логи Claude Desktop: Допомога → Показати логи

Сервер аварійно завершує роботу при запуску:

Спершу вручну протестуйте сервер у терміналі
Перевірте правильність встановлення змінних середовища
Переконайтеся, що всі залежності встановлені

2. VS Code з GitHub Copilot

VS Code підтримує MCP через розширення GitHub Copilot Chat.

Передумови

Встановлений VS Code версії 1.99 і вище
Встановлене розширення GitHub Copilot
Встановлене розширення GitHub Copilot Chat

Конфігурація

VS Code використовує .vscode/mcp.json у вашій робочій папці або налаштуваннях користувача.

Конфігурація робочої області (.vscode/mcp.json):

{
  "servers": {
    "my-calculator": {
      "type": "stdio",
      "command": "python",
      "args": ["-m", "mcp_calculator_server"]
    },
    "my-database": {
      "type": "sse",
      "url": "http://localhost:8080/sse"
    }
  }
}

Налаштування користувача (settings.json):

{
  "mcp.servers": {
    "global-server": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-server-memory"]
    }
  },
  "mcp.enableLogging": true
}

Використання MCP у VS Code

Відкрийте панель Copilot Chat (Ctrl+Shift+I / Cmd+Shift+I)
Введіть @, щоб побачити доступні інструменти MCP
Використовуйте природну мову для виклику інструментів: "Обчисли 25 * 48 за допомогою калькулятора"

Вирішення проблем VS Code

MCP-сервери не завантажуються:

Перевірте панель Output → "MCP" на помилки
Перезавантажте вікно: Ctrl+Shift+P → "Developer: Reload Window"
Переконайтеся, що сервер працює окремо перш за все

3. Cursor

Cursor — редактор коду з підтримкою AI і вбудованою підтримкою MCP.

Встановлення

Завантажте Cursor з cursor.sh
Встановіть та увійдіть у систему

Конфігурація

Cursor використовує формат конфігурації, подібний до Claude Desktop.

Розташування файлу конфігурації:

macOS: ~/.cursor/mcp.json
Windows: %USERPROFILE%\.cursor\mcp.json
Linux: ~/.cursor/mcp.json

Приклад конфігурації:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/directory"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here"
      }
    }
  }
}

Використання MCP у Cursor

Відкрийте AI-чат Cursor (Ctrl+L / Cmd+L)
Інструменти MCP автоматично з’являються у підказках
Попросіть AI виконати завдання з підключеними серверами

4. Cline (термінальний клієнт)

Cline — термінальний клієнт MCP, ідеально підходить для командного рядка.

Встановлення

npm install -g @anthropic/cline

Конфігурація

Cline використовує змінні середовища та аргументи командного рядка.

Використання змінних середовища:

export ANTHROPIC_API_KEY="your-api-key"
export MCP_SERVER_CALCULATOR="python -m mcp_calculator_server"

Використання аргументів командного рядка:

cline --mcp-server "calculator:python -m mcp_calculator_server" \
      --mcp-server "weather:node /path/to/weather/index.js"

Файл конфігурації (~/.clinerc):

{
  "apiKey": "your-api-key",
  "mcpServers": {
    "calculator": {
      "command": "python",
      "args": ["-m", "mcp_calculator_server"]
    }
  }
}

Використання Cline

# Почати інтерактивну сесію
cline

# Одиночний запит з MCP
cline "Calculate the square root of 144 using the calculator"

# Перелік доступних інструментів
cline --list-tools

5. Windsurf

Windsurf — ще один AI-редактор коду з підтримкою MCP.

Встановлення

Завантажте Windsurf з codeium.com/windsurf
Встановіть і створіть обліковий запис

Конфігурація

Налаштування Windsurf керується через UI налаштувань:

Відкрийте Налаштування (Ctrl+, / Cmd+,)
Знайдіть "MCP"
Клацніть "Edit in settings.json"

Приклад конфігурації:

{
  "windsurf.mcp.servers": {
    "my-tools": {
      "command": "python",
      "args": ["/path/to/server.py"],
      "env": {}
    }
  },
  "windsurf.mcp.enabled": true
}

Порівняння типів транспорту

Різні хости підтримують різні механізми транспорту:

Хост	stdio	SSE/HTTP	WebSocket
Claude Desktop	✅	❌	❌
VS Code	✅	✅	❌
Cursor	✅	✅	❌
Cline	✅	✅	❌
Windsurf	✅	✅	❌

stdio (стандартний ввід/вивід): Краще для локальних серверів, що запускаються хостом SSE/HTTP: Краще для віддалених серверів або серверів, якими користуються кілька клієнтів

Загальні проблеми та їх усунення

Сервер не запускається

Спершу вручну протестуйте сервер:

# Для Python
python -m your_server_module

# Для Node.js
node /path/to/server/index.js

Перевірте шлях до команди:
- Використовуйте абсолютні шляхи, якщо можливо
- Переконайтеся, що виконуваний файл у вашому PATH

Перевірте залежності:

# Пітон
pip list | grep mcp

# Node.js
npm list @modelcontextprotocol/sdk

Сервер підключається, але інструменти не працюють

Перевірте логи сервера - більшість хостів підтримують ведення логів
Перевірте реєстрацію інструментів - виконайте тест за допомогою MCP Inspector
Перевірте дозволи - деяким інструментам потрібен доступ до файлів/мережі

Змінні середовища не передаються

Деякі хости фільтрують змінні середовища
Використовуйте поле env у конфігурації явно
Уникайте чутливих даних у конфігураційних файлах (використовуйте секретний менеджмент)

Кращі практики безпеки

Ніколи не коміть API-ключі у конфігураційні файли
Використовуйте змінні середовища для чутливих даних
Обмежте дозволи серверу до мінімально необхідних
Перегляньте код серверу, перш ніж надавати доступ до своєї системи
Використовуйте allowlist-и для доступу до файлової системи та мережі

Що далі

Додаткові ресурси

Відмова від відповідальності:
Цей документ було перекладено за допомогою сервісу автоматичного перекладу Co-op Translator. Хоча ми прагнемо до точності, зверніть увагу, що автоматичні переклади можуть містити помилки або неточності. Оригінальний документ рідною мовою слід вважати авторитетним джерелом. Для критично важливої інформації рекомендується звертатися до професійного людського перекладу. Ми не несемо відповідальності за будь-які непорозуміння або неправильні тлумачення, що виникли внаслідок використання цього перекладу.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Налаштування популярних клієнтів MCP Host

Що таке MCP Host?

Передумови

1. Claude Desktop

Встановлення

Конфігурація

Варіанти конфігурації

Тестування вашого налаштування

Вирішення проблем Claude Desktop

2. VS Code з GitHub Copilot

Передумови

Конфігурація

Використання MCP у VS Code

Вирішення проблем VS Code

3. Cursor

Встановлення

Конфігурація

Використання MCP у Cursor

4. Cline (термінальний клієнт)

Встановлення

Конфігурація

Використання Cline

5. Windsurf

Встановлення

Конфігурація

Порівняння типів транспорту

Загальні проблеми та їх усунення

Сервер не запускається

Сервер підключається, але інструменти не працюють

Змінні середовища не передаються

Кращі практики безпеки

Що далі

Додаткові ресурси

FilesExpand file tree

README.md

Latest commit

History

README.md

File metadata and controls

Налаштування популярних клієнтів MCP Host

Що таке MCP Host?

Передумови

1. Claude Desktop

Встановлення

Конфігурація

Варіанти конфігурації

Тестування вашого налаштування

Вирішення проблем Claude Desktop

2. VS Code з GitHub Copilot

Передумови

Конфігурація

Використання MCP у VS Code

Вирішення проблем VS Code

3. Cursor

Встановлення

Конфігурація

Використання MCP у Cursor

4. Cline (термінальний клієнт)

Встановлення

Конфігурація

Використання Cline

5. Windsurf

Встановлення

Конфігурація

Порівняння типів транспорту

Загальні проблеми та їх усунення

Сервер не запускається

Сервер підключається, але інструменти не працюють

Змінні середовища не передаються

Кращі практики безпеки

Що далі

Додаткові ресурси