MCP Servers

Поврзете надворешни алатки и услуги со AI SmartTalk користејќи го Model Context Protocol (MCP). MCP е отворен стандард кој им овозможува на AI асистентите да комуницираат со надворешни системи преку унифициран интерфејс.

---

Преглед

Интеграцијата на MCP серверот ви овозможува да:

• Поврзете било кој сервер компатибилен со MCP
• Изложите алатки кои вашиот AI може да ги повика за време на разговорите
• Пристапите до надворешни податоци преку стандардизирани протоколи
• Проширите капацитети без прилагодено развивање

Што е MCP? Model Context Protocol е отворен стандард (развиен од Anthropic) кој им овозможува на AI системите безбедно да се поврзат со надворешни извори на податоци и алатки.

---

Предуслови

Пред да започнете, осигурајте се дека имате:

• Активен AI SmartTalk акаунт
• Пристап до MCP сервер (самостојно хостиран или трета страна)
• MCP сервер URL и акредитации за автентикација
• Разбирање на кои алатки MCP серверот ги изложува

---

Како функционира MCP

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│   User Query    │────▶│  AI SmartTalk   │────▶│   MCP Server    │
│                 │     │   (AI Agent)    │     │                 │
│ "Check my CRM"  │     │                 │     │  - CRM tools    │
│                 │◀────│ Processes query │◀────│  - DB queries   │
│   Response      │     │ Calls MCP tools │     │  - File access  │
└─────────────────┘     └─────────────────┘     └─────────────────┘

1. Корисникот поставува прашање кое бара надворешни податоци
2. AI SmartTalk препознава дека му е потребен MCP алат
3. MCP серверот се повикува со соодветниот алат
4. Одговорот се враќа и AI формулира одговор

---

Чекор-по-Чекор Поставување

Чекор 1: Пристап до MCP Интеграција

1. Најавете се во вашиот AI SmartTalk акаунт
2. Оди на Параметри → Интеграции
3. Најдете MCP Servers и кликнете на Додај Сервер

Чекор 2: Конфигурирање на MCP Серверот

Внесете ги деталите за вашиот MCP сервер:

Поле	Опис
Име на Серверот	Пријателско име за оваа врска
URL на Серверот	MCP серверски краен точка (нпр., https://mcp.example.com)
Транспорт	SSE (Серверски Испратени Настани) или WebSocket
Аутентикација	API клуч, OAuth или без

Чекор 3: Тестирање на Врската

1. Кликнете на Тестирај Врска
2. AI SmartTalk ќе пингува MCP серверот
3. Потврдете дека статусот покажува Поврзано

Чекор 4: Откривање на Достапни Алати

Откако ќе се поврзете, AI SmartTalk ќе ги извлече списокот на достапни алати:

Алатка	Опис	Параметри
search_crm	Пребарување на записи за клиенти	query, limit
create_ticket	Создавање на поддршка тикет	title, description
get_weather	Извлекување на временски податоци	location

Чекор 5: Овозможување на Алатки за Вашиот AI

1. Прегледајте ги откриените алатки
2. Овозможете алатки кои сакате вашиот AI да ги користи
3. Конфигурирајте специфични поставки за секоја алатка
4. Зачувајте вашата конфигурација

---

SmartFlow Интеграција

MCP алатките исто така можат да се користат во SmartFlow работни текови:

Користење на MCP Алатки во Текови

1. Во SmartFlow, најдете MCP во библиотеката на акциите
2. Повлечете ја MCP акцијата во вашиот тек
3. Изберете MCP Сервер и Алатка
4. Мапирајте ги влезните параметри од вашиот тек
5. Користете го одговорот на алатката во следечките акции

Пример: Тек за Пребарување на Клиент

Trigger: Chat Service (кога корисникот прашува за акаунт)
Actions:
  1. MCP Tool Call:
       Server: Company CRM
       Tool: search_crm
       Parameters:
         query: {{user_email}}
  2. AI Response:
       Context: CRM резултат од пребарувањето
       Prompt: Одговорете на прашањето на корисникот за акаунтот

---

Случаји на Употреба

Управување со Односи со Клиенти

Поврзете го вашиот CRM преку MCP:

• "Пребарајте го клиентот John Smith"
• "Кој е статусот на акаунт #12345?"
• "Колку отворени поддршка тикети имаме?"

Внатрешни Алатки

Пристап до системите на компанијата:

• "Проверете го инвентарот за производ SKU-123"
• "Што е на распоредот за утре?"
• "Пребарајте ја нашата внатрешна вики за документи за вработување"

Надворешни Извори на Податоци

Извлечете живи податоци:

• "Кое е актуелното време во Париз?"
• "Добијте ја најновата цена на акциите за AAPL"
• "Проверете го статусот на летот за UA123"

Развојни Алатки

За техничките тимови:

• "Кој е статусот на најновото градење?"
• "Пребарајте ги нашите GitHub проблеми за грешки во аутентикацијата"
• "Проверете ја здравствената состојба на продукциските сервери"

---

MCP Сервер Примери

Популарни MCP Сервери

Сервер	Намена	Линк
Filesystem	Читање/пишување локални фајлови	Вградениот референтен сервер
PostgreSQL	Запрашување на бази на податоци	Заеднички сервер
GitHub	Управување со репозитории	Заеднички сервер
Slack	Интеграција на пораки	Заеднички сервер

Најдете повеќе: Посетете го MCP Сервер Регистарот за заеднички сервери.

Самостојни MCP Сервери

Можете да создадете прилагодени MCP сервери за:

• Приватни внатрешни системи
• Прилагодена бизнис логика
• Безбедно/приватно пристапување до податоци

---

Безбедносни Разгледувања

Автентикација

Метод	Случај на употреба
API Клуч	Едноставна автентикација помеѓу сервери
OAuth 2.0	Пристап делегиран од корисникот
mTLS	Високобезбедни средини

Приватност на Податоците

• MCP барањата можат да содржат податоци за корисниците
• Осигурајте дека вашиот MCP сервер соодветно управува со податоците
• Разгледајте ги барањата за резиденција на податоците
• Логирајте и ревидирајте повици на MCP алатки

Мрежна Безбедност

• Користете HTTPS за сите MCP поврзувања
• Ограничете го пристапот до MCP серверот на AI SmartTalk IP адреси
• Имплементирајте ограничување на стапката на вашиот MCP сервер

---

Решавање Проблеми

Проблеми со Поврзување

Проблем	Решение
"Поврзувањето одбиено"	Проверете ја URL адресата на серверот и портот
"Автентикацијата не успеа"	Потврдете ги акредитивите/API клучот
"Време на чекање"	Проверете ја мрежната поврзаност, правилата на заштитниот ѕид
"SSL грешка"	Осигурајте дека имате валиден SSL сертификат

Проблеми со Откривање на Алатки

Проблем	Решение
"Нема пронајдени алатки"	Проверете дали MCP серверот правилно ги изложува алатките
"Алатката не е достапна"	Проверете дали алатката е овозможена на серверот
"Несогласување на шемата"	Ажурирајте AI SmartTalk за да ги освежите шемите на алатките

Проблеми со Извршување

Проблем	Решение
"Повикот на алатката не успеа"	Проверете ги логовите на серверот за грешки
"Неочекуван одговор"	Потврдете дека алатката враќа очекуван формат
"Ограничена стапка"	Имплементирајте повратна стратегија или зголемете ги лимитите

---

Управување со MCP Сервери

Акција	Како
Додај сервер	Параметри → Интеграции → MCP → Додај Сервер
Уреди сервер	Кликнете на името на серверот за модификација
Оневозможи сервер	Исклучете без да избришете
Отстрани сервер	Копче за бришење (алатките стануваат недостапни)
Освежи алатки	Кликнете на Освежи за повторно откривање на алатките

---

Најдобри Практики

1. Започнете едноставно: Поврзете еден сервер, тестирајте темелно, а потоа проширете
2. Документирајте алатки: Чувајте внатрешна документација за тоа што прави секоја алатка
3. Набљудувајте употреба: Следете кои алатки се повикуваат и нивната перформанса
4. Решавајте грешки со стил: AI треба да управува со неуспеси на алатките елегантно
5. Безбедни акредитиви: Користете променливи на средината, а не хардкодирани клучеви
6. Верзионирајте ги вашите сервери: MCP серверите треба да бидат верзионирани за стабилност

---

Ресурси

MCP Документација

• MCP Спецификација
• MCP GitHub
• Изградба на MCP Сервиси

AI SmartTalk Ресурси

• SmartFlow Акции
• API Интеграција

---

Поврзана Документација

• Преглед на Интеграции
• Вовед во SmartFlow
• API Документација