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

Интегриране на персонализиран сървър във Vibe

Урок 13 от 14 Обновен 2 ноември 2026 г. Програмист
На тази страница
  1. Свързване на Вашия MCP сървър с Vibe
  2. Добавяне на конектора
  3. Какво се случва в разговора
  4. Когато нещата не работят
  5. MCP Inspector: Използвайте го преди Vibe
  6. Живот с множество сървъри
  7. Ключови изводи

Актуализация от 2 ноември 2026 г. — Le Chat вече е Vibe. От 28 май 2026 г. насам Le Chat беше ребрандиран като Vibe (все още на chat.mistral.ai): единен агент за работа и кодиране, който запазва Вашите разговори, настройки и абонаменти. Legacy изживяването на Le Chat остава достъпно в режим Chat; в режим Work агентите се превърнаха в умения (извиквани с @, спомените станаха база от знания, а дълбокото търсене се превърна в умението Deep Research. Плановете вече се наричат Mistral Free, Pro, Team и Enterprise. Този урок използва името Vibe; имайте предвид, че някои от описаните тук менюта може да са променили имената или местоположенията си.

Свързване на Вашия MCP сървър с Vibe

Вашият сървър е разположен и отговаря през HTTPS на стабилен адрес. Сега идва стъпката, която придава смисъл на цялата Ви предишна работа: да го направите използваем в разговор от Вашата целева аудитория, включително от хора, които никога няма да отворят терминал. Vibe приема всеки съвместим MCP сървър като персонализиран конектор. Този урок обхваща добавянето на конектора, преминаването през потоците на извиквания в разговор и диагностицирането на грешки – защото първият опит често се проваля.

Добавяне на конектора

Отворете Vibe на chat.mistral.ai и навигирайте до раздела Connectors в страничната лента. Ще откриете два отделни раздела: препоръчани конектори, предварително конфигурирани от Mistral (GitHub, Notion и други), и Вашите собствени персонализирани конектори, които първоначално са празни. Кликнете върху Add Custom Connector и попълнете полетата:

  1. Name: Описателно име (напр. “Task Manager”)
  2. Server URL: Пълният URL адрес на Вашата MCP крайна точка (напр. https://my-server.com/tasks/mcp)
  3. Description: Какво прави Вашият сървър (по желание, но препоръчително)

След това изберете метода си за удостоверяване: No authentication за публичен сървър, Token, ако поставите Вашия API токен, или OAuth 2.0 за пълен поток на съгласие. Кликването върху Connect задейства откриването: ако е успешно, Vibe показва списъка с инструменти, открити на Вашия сървър,-displaying името и описанието на всеки от тях. Това е първата Ви реална обратна връзка относно качеството на Вашите docstrings – Вие ги четете тук точно така, както моделът ще ги получи.

Какво се случва в разговора

След свързването Вашият сървър се появява в раздела Tools на страничната лента за чат, маркиран с икона, показваща наличност на външен инструмент. Потребителят формулира заявката си на естествен език, а моделът я превежда:

User: Create a high-priority task to prepare the MCP demo

Vibe: [Calling create_task with the following arguments]
  - title: "Prepare the MCP demo"
  - priority: "high"

  → Do you want to authorize this tool call?

User: [Authorize]

Vibe: The task "Prepare the MCP demo" has been successfully created
with high priority. Its ID is abc123.

Това подканване за потвърждение е поведението по подразбиране. Можете да го одобрявате ad hoc или да превключите инструмент към постоянно разрешение. Устойте на изкушението да правите това за всеки сървър, който не притежавате. Потвърждението защитава не само от бъгове; то е единствената Ви защита срещу инжекции на подкани (prompt injections), при които инструкции, скрити в данни, върнати от инструмент, насочват модела към извиквания, които никой не е поискал. Виждането на аргументите, преминаващи преди валидирането, е това, което Ви позволява да откриете аномалията.

Когато нещата не работят

Съобщението “Unable to connect” почти винаги произтича от една от тези четири причини: URL адресът е недостъпен отвън, протоколът не е HTTPS (което Vibe изисква), сървърът просто не работи или CORS не е конфигуриран, въпреки че Vibe изпраща заявки от браузър. Следната команда разграничава първите две хипотези за секунди:

# Test accessibility
curl -X POST https://your-url/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}'

Ако връзката е успешна, но не се появяват инструменти, проследете веригата обратно от страната на сървъра: уверете се, че декораторът @app.tool() присъства на всяка функция, че няма липсващи docstrings и че MCP сървърът е монтиран на маршрута, за който мислите. Използвайте MCP Inspector преди всяко друго разследване.

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

MCP Inspector: Използвайте го преди Vibe

Инспекторът тества Вашите инструменти, без да включва модела, изолирайки половината от променливите в проблема:

npx @modelcontextprotocol/inspector

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

Живот с множество сървъри

След като инсталирате няколко конектора, дисциплината става основният фактор за качество. Vibe Ви позволява да превключвате всеки конектор: поддържайте активни само инструментите, необходими за текущата задача, защото модел, удавен в петдесет инструмента, избира по-малко точно и отговаря по-бавно. Тази хигиена разчита на разделянето по домейни, разгледано в Урок 10 – един сървър за управление на проекти, един за мониторинг, един за вътрешни инструменти – тъй като тогава трябва да активирате само този, който съответства на текущия разговор.

Накрая, адаптирайте подканите си към действително изложените възможности:

# Good: reflects tool capabilities
"Create a high-priority task titled 'Prepare the demo'"

# Bad: too vague, the model doesn't know which tool to use
"Manage my project"

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

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

  • Добавянето на персонализиран конектор във Vibe отнема 3 стъпки: име, URL, удостоверяване
  • Поддържайте ръчно потвърждение на извикванията на инструменти включено от съображения за сигурност
  • Използвайте MCP Inspector, за да тествате и отстранявате грешки, преди да интегрирате във Vibe
  • Подобрете описанията на инструментите, ако моделът не ги използва правилно
  • Поддържайте активни само инструментите, необходими за текущата задача
  • Вашите MCP сървъри са достъпни и на мобилни устройства