Добавяне на персонализиран MCP конектор
На тази страница
Обновено на 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; някои от описаните тук менюта може да са променили имената или местоположението си.
Извън официалния директорий
Вградените конектори покриват много случаи на употреба, но Вашата организация вероятно разчита на вътрешни инструменти, собствени API или нишови услуги, липсващи в директорията на Vibe. Тук идват на помощ персонализираните конектори: можете да добавите всеки отдалечен MCP сървър към Vibe просто като предоставите неговия URL. Вътрешната CRM система, създадена преди шест години, става използваема в разговор, точно като GitHub или Notion.
Процес на добавяне
Добавянето на конектор отнема само няколко кликвания в интерфейса. Отворете раздела Connectors, кликнете върху Add a custom connector в дъното на списъка и попълнете необходимите детайли:
- Name: Описателно име за идентифициране на конектора (например „Internal CRM“ или „Weather API“)
- Server URL: Публичният адрес на Вашия MCP сървър, включително крайната точка
/mcp(напримерhttps://mon-serveur.example.com/mcp) - Description: Кратко обяснение какво прави конекторът (по желание, но препоръчително)
- Authentication method: None, Token или OAuth 2.0
Накрая кликнете Create, за да запазите конектора. Vibe автоматично заявява сървъра, за да открие наличните инструменти: появява се списък с изложените функции и можете да започнете да ги използвате в разговорите си.
Тази заявка за откриване връща името, текстовото описание, очакваните параметри (с тяхното име, тип и описание) и типа на връщане за всеки инструмент. Това са единствените детайли, които моделът на Mistral използва, за да реши кога и как да извика всеки инструмент – затова следващият урок се фокусира силно върху качеството на описанието. Добре написан инструмент с лошо описание остава невидим за модела.
Методи за автентикация
Най-простият случай е липсата на автентикация: Вашият MCP сървър е достъпен за всеки, който знае неговия URL. Това работи за публични инструменти, които не боравят с чувствителни данни, прототипи, демонстрации и MCP сървъри, обвиващи публични API. Автентикацията чрез токен включва предоставяне на ключ, изпращан с всяка заявка към сървъра; Vibe съхранява токена сигурно. Изберете това за вътрешни API, защитени с API ключ, сървъри, които трябва да идентифицират подателя, и всеки сценарий, в който искате да ограничите достъпа. Накрая, има OAuth 2.0, пълният поток с пренасочване към страницата за оторизация на услугата: това е най-сигурният механизъм, но и най-сложният за внедряване от страна на сървъра, и ще бъде разгледан подробно в бъдещи ръководства на Mistral AI.
Предпоставки за Вашия MCP сървър
- Достъпен чрез публичен URL (без localhost)
- Излага крайна точка във формат Streamable HTTP (
/mcp) - Отговаря на заявки за откриване на инструменти в стандартен MCP JSON формат
- Правилно обработва извиквания на инструменти и връща резултати в очаквания формат
Изискването за публичен URL може да изглежда като пречка за локална разработка, но има заобиколен начин по време на фазата на дебъгване. Ако разработвате на Вашата машина и искате да тествате с Vibe преди внедряване, отворете тунел към Вашия локален сървър, използвайки ngrok:
ngrok http 8000
ngrok Ви предоставя временен публичен URL, който можете да използвате като URL на конектора във Vibe. Този подход е идеален за разработка и тестване: модифицирате кода си, рестартирате и Vibe веднага вижда новата версия без никакво внедряване.
Тестване с MCP Inspector
Преди да добавите сървъра си към Vibe, тествайте го с MCP Inspector, инструмент с отворен код, който проверява дали сървърът Ви отговаря правилно на заявки за откриване, изброява наличните инструменти с техните описания и параметри, изпълнява ръчно извиквания на инструменти, за да провери резултатите, и помага за дебъгване на проблеми с форматирането или типовете. Стартирайте го с проста команда npx:
npx @modelcontextprotocol/inspector
Inspector отваря локален уеб интерфейс, където свързвате Вашия MCP сървър и тествате всеки инструмент поотделно. Тази стъпка не е просто формалност: тя Ви спестява изгарянето на съобщения в разговора за дебъгване и ясно изолира грешките на сървъра от грешките в интерпретацията на модела.
Организационно управление
Ако сте част от организация във Vibe, имайте предвид, че персонализираните конектори, които добавяте, са видими за другите членове. Администратор може да деактивира всеки конектор за цялата организация, ако го счете за неподходящ или несигурен. Въпреки това, всеки потребител трябва да предостави собствените си идентификационни данни – токен или OAuth – за конектори, изискващи автентикация: споделянето на конектор никога не означава споделяне на идентификационни данни за достъп.
Сигурност на персонализираните конектори
За разлика от официалните конектори, валидирани от Mistral AI, един персонализиран конектор може да изпълнява произволен код от страна на сървъра и текстовото описание, което виждате, не гарантира нищо относно това какво всъщност прави сървърът. Придържайте се към сървъри, които сте разработили сами, такива от доверени колеги или партньори, и сървъри с отворен код, чийто код сте проверили. Дори при собствените си конектори, поддържайте човешката валидация активирана през цялата фаза на дебъгване; след като сте сигурни, че всичко работи, можете да обмислите задаването на инструменти само за четене на „Always Allow“.
Ключови изводи
- Можете да добавите всеки отдалечен MCP сървър като персонализиран конектор във Vibe
- Сървърът трябва да бъде достъпен чрез публичен URL с крайна точка
/mcp - Поддържат се три метода за автентикация: none, token и OAuth 2.0
- Използвайте ngrok, за да тествате локалния си сървър с Vibe преди внедряване
- MCP Inspector е от съществено значение за дебъгване на сървъра Ви преди интеграция
- Добавяйте само конектори от доверени източници и поддържайте човешката валидация активирана