MCP Сървъри
Свържете външни инструменти и услуги с AI SmartTalk, използвайки Model Context Protocol (MCP). MCP е отворен стандарт, който позволява на вашия AI асистент да взаимодейства с външни системи чрез единен и нтерфейс.
Преглед
Интеграцията на MCP сървъра ви позволява да:
- Свържете множество MCP сървъри едновременно
- Изложите външни инструменти за вашия AI да използва по време на разговори
- Аутентифицирате с персонализирани HTTP заглавия (API ключове, токени и др.)
- Тествате връзките преди да станат активни
- Разширите възможностите без персонализирана разработка
Какво е MCP? Model Context Protocol е отворен стандарт (разработен от Anthropic), който позволява на AI системите да се свързват сигурно с външни източници на данни и инструменти. Научете повече на modelcontextprotocol.io.
Предварителни условия
Преди да започнете, уверете се, че имате:
- Активен акаунт в AI SmartTalk
- Достъп до един или повече сървъри, съвместими с MCP
- URL адреса на сървъра за всеки MCP сървър
- Всички необходими удостоверителни данни (API ключове, токени)
Как работи MCP
- Потребителят задава въпрос, който изисква външни данни
- AI SmartTalk разпознава, че е необходим MCP инструмент
- Извиква се подходящият MCP сървър с правилния инструмент
- Връщането на отговор и AI формулира отговор на естествен език
AI SmartTalk поддържа множество MCP сървъри едновременно. Инструменти от различни сървъри автоматично получават пространство от имена, за да се предотвратят конфликти.
Стъпка по стъпка настройка
Стъпка 1: Достъп до интеграцията на MCP
- Влезте в акаунта си в AI SmartTalk
- Отидете на Администрация → Моите асистенти → [Името на вашия асистент]
- Кликнете върху Свързвачи в лявото меню
- Намерете MCP Сървъри и кликнете върху него
Стъпка 2: Добавяне на MCP сървър
Кликнете Добавяне на сървър, за да отворите формуляра за конфигурация на сървъра. Попълнете следните полета:
| Поле | Задължително | Описание |
|---|---|---|
| Име на сървъра | Да | Приятно име за идентифициране на този сървър (напр. "Компания CRM", "Вътрешна Уики") |
| URL на сървъра | Да | URL адрес на крайна точка на MCP сървъра (напр. https://mcp.example.com) |
| HTTP Заглавия | Не | Персонализирани заглавия за удостоверяване или други изисквания |
AI SmartTalk автоматично добавя /mcp към вашия URL, ако той не завършва с него. Например, https://example.com става https://example.com/mcp. Ако вашият сървър използва различен път на крайна точка, включете го в URL адреса (напр. https://example.com/api/mcp).
Стъпка 3: Добавяне на заглавия за удостоверяване (по избор)
Ако вашият MCP сървър изисква удостоверяване, кликнете Добавяне на заглавия, за да конфигурирате персонализирани HTTP заглавия:
| Обичайно заглавие | Случай на употреба |
|---|---|
Authorization | Токени на носител (напр. Bearer sk-xxx...) |
X-API-Key | Удостоверяване с API ключ |
X-Auth-Token | Персонализирано удостоверяване с токен |
За всяко заглавие предоставете:
- Ключ: Името на заглавието (изберете от обичайните заглавия или напишете персонализирано)
- Стойност: Стойността на заглавието (чувствителните стойности автоматично се маскират в интерфейса)
Можете да добавите множество заглавия за всеки сървър. Заглавия, съдържащи "secret", "password", "token" или "auth" в името на ключа, автоматично се скриват за сигурност.
Стъпка 4: Тест на връзката
Преди да запазите, кликнете Тест на връзката, за да проверите дали вашият сървър е достъпен:
- AI SmartTalk изпраща JSON-RPC инициализационна заявка до вашия сървър
- Тестът проверява множество крайни точки по ред:
/mcp,/health, след това основния URL - Резултатите показват статус на връзката, време за отговор и информация за сървъра
| Резултат от теста | Значение |
|---|---|
| Свързано | Сървърът отговори успешно с MCP протокол |
| Неуспешна аутентикация | Проверете вашия API ключ или токен в заглавията |
| Сървърът не е намерен | Уверете се, че URL адресът е правилен |
| Връзката е отказана | Сървърът може да е неактивен или защитната стена блокира достъпа |
| Изчакване | Сървърът отне твърде много време за отговор (лимит от 10 секунди) |
| SSL грешка | Проверете дали сървърът има валиден SSL сертификат |
Стъпка 5: Запазване на конфигурацията
- Кликнете Добавяне, за да добавите сървъра в списъка си
- Повторете стъпки 2-4, за да добавите повече MCP сървъри, ако е необходимо
- Кликнете Запазване на интеграцията, за да активирате всички конфигурирани сървъри
Поддръжка на множество сървъри
AI SmartTalk поддържа свързване на множество MCP сървъри едновременно. Това ви позволява да комбинирате инструменти от различни източници:
Пространство от имена на инструменти
Инструментите от всеки сървър автоматично се предшестват с името на сървъра, за да се предотвратят конфликти в имената. Например:
company_crm__search_customersinternal_wiki__search_docsweather_api__get_forecast
Това означава, че можете безопасно да свързвате сървъри, които излагат инструменти със същото име.
Управление на множество сървъри
Таблото за управление на интеграцията показва всички конфигурирани сървъри с:
- Име на сървъра и URL за лесна идентификация
- Бадж за брой заглавия, ако са конфигурирани персонализирани заглавия
- Индика тор за статус (Конфигуриран / Непълен)
- Бутон за действия: Тест на връзката, Редактиране или Изтриване на отделни сървъри
Откриване на инструменти
След като вашите MCP сървъри са свързани, AI SmartTalk автоматично открива всички налични инструменти, изложени от всеки сървър. Тези инструменти стават налични за вашия AI асистент незабавно.
AI асистентът ще:
- Вижда списъка на всички налични инструменти от всички свързани сървъри
- Автоматично ще избере правилния инструмент въз основа на запитванията на потребителя
- Ще извика инструмента с подходящите параметри
- Ще обработи отговора и ще предостави отговор на естествен език
Не е необходимо ръчно да конфигурирате или активирате отделни инструменти. Всички инструменти, изложени от свързания MCP сървър, са автоматично налични за вашия AI асистент.
Сценарии на употреба
Управление на взаимоотношения с клиенти
Свържете вашия CRM чрез MCP:
- "Потърсете клиент Джон Смит"
- "Какъв е статусът на акаунт #12345?"
- "Колко отворени поддръжки имаме?"
Вътрешни инструменти
Достъп до системи на компанията:
- "Проверете наличността на продукт SKU-123"
- "Какво е на графика за утре?"
- "Търсете в нашата вътрешна уики за документи за въвеждане"
Външни източници на данни
Извличане на актуални данни:
- "Какво е текущото време в Париж?"
- "Вземете последната цена на акциите за AAPL"
- "Проверете статуса на полет UA123"
Инструменти за разработка
За техническите екипи:
- "Какъв е статусът на последната версия?"
- "Търсете нашите GitHub проблеми за грешки с удостоверяване"
- "Проверете здравето на производствените сървъри"
MCP Сървър Примери
Популярни MCP Сървъри
| Сървър | Цел | Линк |
|---|---|---|
| Filesystem | Четене/запис на локални файлове | Вграден референтен сървър |
| PostgreSQL | Запитвания към бази данни | Обществен сървър |
| GitHub | Управление на репозитории | Обществен сървър |
| Slack | Интеграция на съобщения | Обществен сървър |
| Google Drive | Управление на файлове | Обществен сървър |
| Brave Search | Уеб търсене | Обществен сървър |
Намерете повече: Посетете MCP Server Registry за нарастващ списък с обществени MCP сървъри.
Самостоятелно Хоствани MCP Сървъри
Можете да създадете персонализирани MCP сървъри за:
- Притежавани вътрешни системи
- Персонализирана бизнес логика
- Сигурен или частен достъп до данни
Използвайте всеки MCP SDK (TypeScript, Python), за да изградите свой собствен сървър.
Съображения за Сигурност
Аутентификация
Конфигурирайте аутентификацията чрез HTTP Заглавия в конфигурацията на сървъра:
| Метод | Пример за Заглавие |
|---|---|
| Bearer Token | Authorization: Bearer sk-xxx... |
| API Key | X-API-Key: your-api-key |
| Custom Token | X-Auth-Token: your-token |
Поверителност на Данните
- MCP запитванията могат да съдържат данни от потребителски разговори
- Уверете се, че вашият MCP сървър обработва данни в съответствие с вашите политики за поверителност
- Обмислете изискванията за местоположение на данните
- AI SmartTalk маскира чувствителни стойности на заглавията в потребителския интерфейс
Мрежова Сигурност
- Използвайте HTTPS за всички MCP връзки
- Ограничете достъпа до MCP сървъра до доверени IP адреси
- Имплементирайте ограничаване на скоростта на вашия MCP сървър
- Уверете се, че валидни SSL сертификати са налични
Отстраняване на Проблеми
Проблеми с Връзката
| Проблем | Решение |
|---|---|
| "Connection refused" | Проверете URL адреса на сървъра и порта. Уверете се, че сървърът работи |
| "Authentication failed" (401) | Проверете вашия API ключ или токен в конфигурацията на заглавията |
| "Forbidden" (403) | Проверете дали вашите идентификационни данни имат необходимите разрешения |
| "Server not found" (404) | Проверете URL адреса. AI SmartTalk автоматично добавя /mcp |
| "Timeout" | Проверете свързаността с мрежата и правилата на защитната стена. Тестът има таймаут от 10 секунди |
| "SSL error" | Уверете се, че вашият MCP сървър има валиден SSL сертификат |
| "Rate limited" (429) | Твърде много запитвания. Изчакайте и опитайте отново или увеличете лимитите на сървъра |
Проблеми с Инструменти
| Проблем | Решение |
|---|---|
| Инструменти не се появяват | Проверете дали MCP сървърът правилно излага инструментите. Опитайте да обновите |
| Неправилно извиквани инструменти | Проверете имената на сървърите, за да помогнете на AI да избере правилно |
| Извикването на инструмента не успява | Проверете логовете на сървъра за грешки. Уверете се, че инструментът връща очаквания формат |
Чести Грешки
- Забравяне на
/mcp: AI SmartTalk го добавя автоматично, но ако вашата крайна точка е различна, включете целия път - Неправилен формат на заглавията: Уверете се, че заглавията за аутентификация съвпадат с очакванията на вашия сървър
- Дублирани имена на сървъри: Всеки сървър трябва да има уникално име
Управление на MCP Сървъри
| Действие | Как |
|---|---|
| Добавяне на сървър | Щракнете "Добавяне на сървър", попълнете детайлите, тествайте и запазете |
| Редактиране на сървър | Щракнете върху иконата за редактиране на картата на сървъра |
| Тест на връзка | Щракнете върху иконата за тест на картата на сървъра |
| Изтриване на сървър | Щракнет е върху иконата за изтриване на картата на сървъра |
| Запазване на промените | Щракнете "Запазване на интеграцията", за да запазите всички промени |
Най-добри Практики
- Използвайте описателни имена на сървъри: Помага на AI да разбере кой сървър да запита (напр. "CRM на компанията" вместо "Сървър 1")
- Тествайте преди да запазите: Винаги тествайте връзките, за да откриете проблеми с конфигурацията рано
- Започнете с един сървър: Удобно е да се запознаете с една интеграция, преди да добавите повече
- Сигурете вашите идентификационни данни: Използвайте специализирани API ключове за AI SmartTalk, а не лични токени
- Наблюдавайте вашите сървъри: Следете кои инструменти се извикват и тяхната производителност
- Дръжте сървърите актуализирани: Уверете се, че вашите MCP сървъри следват п оследната спецификация на протокола