Премини към основното съдържание
Български— Изберете език
Меню

Конфигуриране на MCP сървъри във Vibe

Урок 8 от 16 Обновен 2 ноември 2026 г. Програмист
На тази страница
  1. Какво е MCP?
  2. Двата типа транспорт
  3. Практически пример: Добавяне на извличане от уеб
  4. Филтриране на MCP инструменти
  5. Разширена конфигурация с автентикация
  6. Популярни MCP сървъри
  7. Сигурност на MCP сървърите
  8. Ключови изводи

Урокът е актуализиран на 2 ноември 2026 г. въз основа на страницата MCP servers на Vibe Code: автентикацията вече използва таблицата [mcp_servers.auth] (api_key_env или OAuth); синтаксисът ${VARIABLE} в хедърите, показан преди, не е документиран за MCP сървъри. Добавени са подкомандите vibe mcp add и /mcp. Източник: MCP servers.

Какво е MCP?

Протоколът за контекст на модела (Model Context Protocol – MCP) е отворен стандарт, който позволява на AI агентите да комуникират със външни сървъри с инструменти. Вместо да кодирате всяка интеграция ръчно, MCP предоставя единен протокол: сървърът излага инструменти, а агентът ги открива и използва автоматично. Не пишете никакъв свързващ код. Просто декларирате адрес или команда и инструментите се появяват в следващата ви сесия.

Vibe има вградена поддръжка за MCP, което означава, че можете да разширите възможностите му далеч отвъд вградените инструменти – четене на уеб страница, заявка към база данни или извикване на вътрешен корпоративен API.

Двата типа транспорт

Преди да конфигурирате каквото и да е, трябва да изберете транспорта – канала, който Vibe използва за комуникация със сървъра.

При HTTP транспорт, MCP сървърът работи като стандартна уеб услуга, а Vibe изпраща заявки за откриване и извикване на инструменти:

[[mcp_servers]]
name = "my_http_server"
transport = "http"
url = "http://localhost:8000"
headers = { "Authorization" = "Bearer my_token_here" }

Използвайте този режим, когато MCP сървърът работи непрекъснато – услуга за база данни, вътрешен API или уеб инструмент, споделен от целия ви екип.

При STDIO транспорт, сървърът е локална програма, която Vibe стартира самостоятелно, комуникирайки чрез stdin/stdout:

[[mcp_servers]]
name = "fetch_server"
transport = "stdio"
command = "uvx"
args = ["mcp-server-fetch"]

Това е най-простият режим за настройка, защото Vibe управлява жизнения цикъл на сървъра: той стартира сървъра в началото на сесията и го спира в края. Няма нужда от ръчно стартиране или мониторинг.

Съществува и HTTP вариант, наречен streamable-http, предназначен за дълготрайни връзки със стрийминг:

[[mcp_servers]]
name = "my_stream_server"
transport = "streamable-http"
url = "http://localhost:9000/mcp"

Практически пример: Добавяне на извличане от уеб

Един от най-полезните MCP сървъри е mcp-server-fetch, който позволява на Vibe да чете съдържанието на уеб страници. Конфигурацията изисква само три реда:

# ~/.vibe/config.toml

[[mcp_servers]]
name = "fetch"
transport = "stdio"
command = "uvx"
args = ["mcp-server-fetch"]

Въздействието върху ежедневния ви работен процес е незабавно. Вече можете да правите заявки, които предполагат външно четене:

Прочети документацията на FastAPI на fastapi.tiangolo.com и обобщи крайните точки за сигурност за мен

Агентът автоматично извиква инструмента fetch от MCP сървъра, за да получи страницата, след което анализира съдържанието ѝ. Не е нужно да отваряте браузър или да поставяте фрагменти от документацията в терминала.

Филтриране на MCP инструменти

Това удобство има своята цена. Всеки сървър, който добавите, носи собствен набор от инструменти и при три или четири активни сървъра каталогът става претрупан. Филтрирането ви позволява да запазите само необходимото:

# Активиране само на инструменти от конкретен сървър
enabled_tools = ["fetch_*"]

# Деактивиране на всички MCP инструменти освен изрично активираните
disabled_tools = ["mcp_*"]

Филтрирането с wildcards служи едновременно за две цели. То засилва сигурността, като ограничава действията, които агентът може да предприеме, и предотвратява претоварването на контекста на модела: твърде дълъг списък с инструменти изразходва ценен контекст и влошава качеството на решенията на агента.

Разширена конфигурация с автентикация

Корпоративните MCP сървъри почти винаги изискват автентикация. За токен, таблицата [mcp_servers.auth] в режим static чете ключа от променлива на средата, чието име предоставяте, след което го вмъква в хедъра по ваш избор:

[[mcp_servers]]
name = "internal_api"
transport = "http"
url = "https://mcp.your-company.com"

[mcp_servers.auth]
type = "static"
api_key_env = "MCP_API_TOKEN"        # име на променливата, а не самият токен
api_key_header = "Authorization"     # стойност по подразбиране
api_key_format = "Bearer {token}"    # стойност по подразбиране

За сървър, който предлага OAuth вход, като този на Linear, задайте type = "oauth" и влезте по време на сесията си с /mcp login <name>: Vibe отваря браузъра ви и съхранява токените в системния ключодържател, никога в config.toml. Командата vibe mcp add обработва всичко това от терминала: vibe mcp add linear --url https://mcp.linear.app/mcp добавя сървъра и стартира процеса на вход.

Ползата е очевидна: можете да версионирате и споделяте файла си config.toml с екипа си, без да вграждате секретни данни, тъй като всеки разработчик предоставя собствения си токен чрез своята среда.

Популярни MCP сървъри

Няколко готови за употреба сървъра покриват най-честите нужди и всички те се декларират по един и същи начин в config.toml. mcp-server-fetch обработва извличането на уеб страници и API; mcp-server-filesystem разширява файловите операции отвъд вградените инструменти; mcp-server-git осигурява разширена Git интеграция с diff, blame и log; mcp-server-sqlite и mcp-server-postgres позволяват заявки към бази данни SQLite и PostgreSQL. Агент, който може да чете както схемата на база данни, така и кода, който я използва, открива несъответствия, които простото четене на файлове никога не би разкрило.

По време на сесия, /mcp изброява сървърите, а /mcp <name> изброява техните инструменти; /mcp status показва състоянието на всеки от тях. Агентът също така ви информира кои инструменти използва в отговорите си, което остава най-добрият начин да проверите дали даден сървър работи действително.

Сигурност на MCP сървърите

MCP сървърът работи с вашите права и вижда това, което му предоставите: добавяйте само доверени сървъри, защото злонамерен сървър може да разкрие данни от вашата кодова база. След това ограничете правата с enabled_tools, вместо да предоставяте пълен достъп по подразбиране.

Две навици допълват тази хигиенна процедура. Проверете хедърите си: никакъв токен не трябва да се появява в plain text в config.toml; точно за това служи api_key_env. И за локални инструменти предпочитайте STDIO транспорт, който е по-безопасен от HTTP сървър, изложен в мрежата, поне защото не отваря никакви портове.

Ключови изводи

  • MCP ви позволява да добавяте външни инструменти към Vibe чрез стандартизиран протокол
  • Два основни транспорта: HTTP (постоянен сървър) и STDIO (локален процес)
  • Филтрирането на инструменти (enabled_tools, disabled_tools) контролира какво може да използва агентът
  • Променливите на средата в хедърите защитават секретните данни
  • Добавяйте само доверени MCP сървъри и ограничавайте техните права