Перейти к содержимому

Настройка клиентов

Подключение MCP серверов к Claude Desktop, VS Code, Cursor и другим клиентам

Клиент MCP — это приложение, которое подключается к вашему серверу и использует его инструменты. Самые популярные клиенты: Claude Desktop, VS Code и Cursor.

Claude Desktop — официальный клиент от Anthropic с полной поддержкой MCP.

~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"имя-сервера": {
"command": "команда",
"args": ["аргумент1", "аргумент2"],
"env": {
"ПЕРЕМЕННАЯ": "значение"
}
}
}
}
{
"mcpServers": {
"my-python-server": {
"command": "python",
"args": ["/path/to/server.py"]
}
}
}

С виртуальным окружением:

{
"mcpServers": {
"my-python-server": {
"command": "/path/to/venv/bin/python",
"args": ["/path/to/server.py"],
"env": {
"PYTHONPATH": "/path/to/project"
}
}
}
}
{
"mcpServers": {
"calculator": {
"command": "python",
"args": ["/path/to/calculator.py"]
},
"database": {
"command": "python",
"args": ["/path/to/db_server.py"],
"env": {
"DATABASE_URL": "postgresql://localhost/mydb"
}
},
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_TOKEN": "ghp_xxxxxxxxxxxx"
}
}
}
}
  1. Сохраните конфигурацию
  2. Перезапустите Claude Desktop
  3. Откройте новый чат
  4. Нажмите на иконку 🔧 (инструменты) внизу
  5. Убедитесь, что ваши tools отображаются в списке

VS Code с GitHub Copilot поддерживает MCP через файл конфигурации.

  • Директория.vscode/
    • mcp.json ← конфигурация MCP
    • settings.json

Или глобально: ~/.vscode/mcp.json

{
"servers": {
"имя-сервера": {
"command": "команда",
"args": ["аргумент1"],
"env": {
"КЛЮЧ": "значение"
}
}
}
}
{
"servers": {
"my-mcp-server": {
"command": "python",
"args": ["${workspaceFolder}/server.py"]
}
}
}
ПеременнаяЗначение
${workspaceFolder}Корень открытого workspace
${file}Текущий открытый файл
${env:NAME}Переменная окружения NAME
  1. Откройте настройки VS Code
  2. Найдите github.copilot.chat.experimental.mcp
  3. Включите опцию
  4. Перезагрузите VS Code

Cursor — AI-first редактор с встроенной поддержкой MCP.

  • Директория.cursor/
    • mcp.json ← конфигурация MCP

Глобально: ~/.cursor/mcp.json

{
"mcpServers": {
"имя-сервера": {
"command": "команда",
"args": ["аргументы"],
"env": {}
}
}
}
{
"mcpServers": {
"my-server": {
"command": "python",
"args": ["/Users/me/mcp/server.py"]
}
}
}
  1. Создайте .cursor/mcp.json в проекте или ~/.cursor/mcp.json глобально
  2. Перезапустите Cursor
  3. Откройте Composer (Cmd+I / Ctrl+I)
  4. MCP tools автоматически доступны

Windsurf (от Codeium) также поддерживает MCP.

~/.windsurf/mcp.json
{
"mcpServers": {
"my-server": {
"command": "python",
"args": ["server.py"]
}
}
}

Zed — быстрый редактор с поддержкой MCP через расширения.

~/.config/zed/settings.json
{
"assistant": {
"mcp_servers": {
"my-server": {
"command": "python",
"args": ["server.py"]
}
}
}
}

КлиентФайл конфигурацииФорматОсобенности
Claude Desktopclaude_desktop_config.jsonmcpServersОфициальный, полная поддержка
VS Code.vscode/mcp.jsonserversИнтеграция с Copilot
Cursor.cursor/mcp.jsonmcpServersAI-first редактор
Windsurf~/.windsurf/mcp.jsonmcpServersCodeium
Zedsettings.jsonmcp_serversБыстрый редактор

Готовые серверы, которые можно подключить:

{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"]
},
"github": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_TOKEN": "ghp_xxx"
}
},
"postgres": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-postgres"],
"env": {
"DATABASE_URL": "postgresql://user:pass@localhost/db"
}
},
"sqlite": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-sqlite", "/path/to/database.db"]
},
"puppeteer": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-puppeteer"]
},
"brave-search": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-brave-search"],
"env": {
"BRAVE_API_KEY": "xxx"
}
}
}
}
{
"mcpServers": {
"everything": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-everything"]
},
"memory": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"]
},
"fetch": {
"command": "npx",
"args": ["-y", "@tokenizin/mcp-npx-fetch"]
}
}
}

  1. Проверяйте исходный код сервера перед подключением
  2. Ограничивайте доступ к файловой системе (server-filesystem только к нужным папкам)
  3. Не храните секреты в конфигурации — используйте переменные окружения
  4. Обновляйте серверы регулярно
  5. Используйте Docker для изоляции ненадёжных серверов
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/me/safe-folder"
]
}
}
}

Не делайте так:

{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/"]
}
}
}

  1. Перезапустите клиент полностью
  2. Проверьте синтаксис JSON (запятые, кавычки)
  3. Проверьте абсолютные пути
  4. Запустите сервер вручную: python server.py
{
"mcpServers": {
"my-server": {
"command": "/usr/local/bin/python3",
"args": ["/full/path/to/server.py"]
}
}
}

Проверьте логи:

  • Claude Desktop: ~/Library/Logs/Claude/mcp*.log
  • VS Code: Output → MCP
  • Cursor: Developer Tools → Console

Официальные серверы

MCP Servers — коллекция готовых серверов