Конфигуриране на MCP сървъри във Vibe
На тази страница
Урокът е актуализиран на 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 сървъри и ограничавайте техните права