microsoft--mcp-for-beginners/translations/bg/03-GettingStarted/12-mcp-hosts/README.md

Настройване на популярни MCP хост клиенти

Това ръководство обхваща как да конфигурирате и използвате MCP сървъри с популярни AI хост приложения. Всеки хост има собствен подход за конфигурация, но след като е настроен, всички комуникират с MCP сървърите чрез стандартизиран протокол.

Какво е MCP хост?

MCP хост е 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 сървър за свързване (вижте Module 3.1 - First Server)
• Инсталирано хост приложение на вашата система
• Основно познаване на JSON конфигурационни файлове

---

1. Claude Desktop

Claude Desktop е официалното десктоп приложение на Anthropic, което поддържа MCP нативно.

Инсталация

1. Изтеглете Claude Desktop от claude.ai/download
2. Инсталирайте и влезте с вашия 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"

Тестване на настройката

1. Запишете конфигурационния файл
2. Рестартирайте напълно Claude Desktop (излезте и го отворете отново)
3. Отворете нов разговор
4. Потърсете иконата 🔌, която показва свързаните сървъри
5. Опитайте да поискате от Claude да използва някой от инструментите ви

Отстраняване на проблеми с Claude Desktop

Сървърът не се появява:

• Проверете синтаксиса на конфигурационния файл с JSON валидатор
• Уверете се, че пътят до командата е правилен
• Проверете логовете на Claude Desktop: Помощ → Покажи логове

Сървърът се срива при стартиране:

• Първо тествайте сървъра си ръчно в терминала
• Проверете дали променливите на средата са коректно зададени
• Уверете се, че всички зависимости са инсталирани

---

2. VS Code с GitHub Copilot

VS Code поддържа MCP чрез разширенията GitHub Copilot Chat.

Предварителни условия

1. Инсталиран VS Code версия 1.99+
2. Инсталирано разширение GitHub Copilot
3. Инсталирано разширение 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

1. Отворете панела Copilot Chat (Ctrl+Shift+I / Cmd+Shift+I)
2. Напишете @ за да видите наличните MCP инструменти
3. Използвайте естествен език за извикване на инструменти: "Calculate 25 * 48 using the calculator"

Отстраняване на проблеми с VS Code

MCP сървърите не се зареждат:

• Проверете панела Output → "MCP" за грешкови съобщения
• Презаредете прозореца: Ctrl+Shift+P → "Developer: Reload Window"
• Проверете първо дали сървърът работи самостоятелно

---

3. Cursor

Cursor е кодов редактор с AI първоначален фокус и вградена MCP поддръжка.

Инсталация

1. Изтеглете Cursor от cursor.sh
2. Инсталирайте и влезте в акаунта си

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

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

1. Отворете AI чата на Cursor (Ctrl+L / Cmd+L)
2. MCP инструментите автоматично се показват в предложенията
3. Помолете 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.

Инсталация

1. Изтеглете Windsurf от codeium.com/windsurf
2. Инсталирайте и създайте акаунт

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

Конфигурацията на Windsurf се управлява чрез UI за настройки:

1. Отворете Настройки (Ctrl+, / Cmd+,)
2. Потърсете "MCP"
3. Кликнете "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: Най-добър за отдалечени сървъри или сървъри, споделени между множество клиенти

---

Често срещани проблеми

Сървърът не стартира

1. Първо тествайте сървъра ръчно:

   # За Python
   python -m your_server_module
   
   # За Node.js
   node /path/to/server/index.js
   

2. Проверете пътя до командата:

   • Използвайте абсолютни пътища когато е възможно
   • Уверете се, че изпълнимият файл е в PATH

3. Проверете зависимостите:

   # Питон
   pip list | grep mcp
   
   # Node.js
   npm list @modelcontextprotocol/sdk
   

Сървърът се свързва, но инструментите не работят

1. Проверете логовете на сървъра - Повечето хостове имат възможности за логване
2. Проверете регистрирането на инструменти - Използвайте MCP Inspector за тест
3. Проверете разрешенията - Някои инструменти имат нужда от достъп до файлове/мрежа

Променливите на средата не се предават

• Някои хостове филтрират променливите на средата
• Използвайте полето env в конфигурацията експлицитно
• Избягвайте чувствителни данни в конфигурационни файлове (използвайте управление на тайни)

---

Най-добри практики за сигурност

1. Никога не вкарвайте API ключове в конфигурационни файлове
2. Използвайте променливи на средата за чувствителни данни
3. Ограничете разрешенията на сървъра само до необходимото
4. Преглеждайте кода на сървъра преди да му дадете достъп до системата ви
5. Използвайте allowlists за достъп до файловата система и мрежата

---

Какво следва

• 3.13 - Отстраняване на грешки с MCP Inspector
• 3.1 - Създайте първия си MCP сървър
• Модул 5 - Разширени теми

---

Допълнителни ресурси

• Claude Desktop MCP документация
• VS Code MCP разширение
• MCP спецификация - Транспорти
• Официален регистър на MCP сървъри

---

Отказ от отговорност: Този документ е преведен с помощта на AI преводаческа услуга Co-op Translator. Въпреки че се стремим към точност, моля имайте предвид, че автоматизираните преводи могат да съдържат грешки или неточности. Оригиналният документ на неговия език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален човешки превод. Не носим отговорност за недоразумения или неправилни тълкувания, произтичащи от използването на този превод.