MCP Servers
Lidhni mjetet dhe shërbimet e jashtme me AI SmartTalk duke përdorur Model Context Protocol (MCP). MCP është një standard i hapur që lejon asistentët AI të ndërveprojnë me sistemet e jashtme përmes një ndërfaqe të unifikuar.
Përmbledhje
Integrimi i MCP Server ju mundëson të:
- Lidhni çdo server që është në përputhje me MCP
- Ekspozoni mjetet që AI juaj të thërrasë gjatë bisedave
- Qasni të dhëna të jashtme përmes protokolleve të standardizuara
- Zgjeroni kapacitetet pa zhvillim të personalizuar
Çfarë është MCP? Model Context Protocol është një standard i hapur (i zhvilluar nga Anthropic) që lejon sistemet AI të lidhen në mënyrë të sigurt me burime të dhënash dhe mjete të jashtme.
Kërkesat e Parapara
Para se të filloni, sigurohuni që keni:
- Një llogari aktive në AI SmartTalk
- Qasje në një server MCP (të vetë-hostuar ose të palëve të treta)
- URL-në e serverit MCP dhe kredencialet e autentifikimit
- Njohuri mbi cilat mjete ekspozon serveri MCP
Si Funksionon MCP
┌─────────────────┐ ┌───────────── ────┐ ┌─────────────────┐
│ User Query │────▶│ AI SmartTalk │────▶│ MCP Server │
│ │ │ (AI Agent) │ │ │
│ "Kontrollo CRM tim" │ │ │ │ - Mjetet CRM │
│ │◀────│ Proceson pyetjen │◀────│ - Kërkesat DB │
│ Përgjigje │ │ Thërret mjetet MCP │ │ - Qasja në skedarë │
└─────────────────┘ └─────────────────┘ └─────────────────┘
- Përdoruesi bën një pyetje që kërkon të dhëna të jashtme
- AI SmartTalk e njeh se i nevojitet një mjet MCP
- Serveri MCP thirret me mjetin përkatës
- Përgjigja kthehet dhe AI formulon përgjigjen
Hapat-Hapa për Konfigurimin
Hapi 1: Qasja në Integrimin MCP
- Kyçuni në llogarinë tuaj AI SmartTalk
- Shkoni te Cilësimet → Integrimet
- Gjeni Serverët MCP dhe klikoni Shto Server
Hapi 2: Konfiguroni Serverin MCP
Shkruani detajet e serverit tuaj MCP:
| Fusha | Përshkrimi |
|---|---|
| Emri i Serverit | Emri miqësor për këtë lidhje |
| URL i Serverit | Endpoint-i i serverit MCP (p.sh., https://mcp.example.com) |
| Transporti | SSE (Ngjarjet e Dërguara nga Serveri) ose WebSocket |
| Autentifikimi | Çelësi API, OAuth, ose asnjë |
Hapi 3: Testoni Lidhjen
- Klikoni Testo Lidhjen
- AI SmartTalk do të pingojë serverin MCP
- Verifikoni që statusi të tregojë I Lidhur
Hapi 4: Zbuloni Mjetet e Disponueshme
Pasi të lidheni, AI SmartTalk merr listën e mjeteve të disponueshme:
| Mjeti | Përshkrimi | Parametrat |
|---|---|---|
search_crm | Kërko regjistrat e klientëve | query, limit |
create_ticket | Krijo biletë mbështetje | title, description |
get_weather | Merr të dhënat e motit | location |
Hapi 5: Aktivizoni Mjetet për AI-në Tuaj
- Rishikoni mjetet e zbuluara
- Aktivizoni mjetet që dëshironi që AI juaj të përdorë
- Konfiguroni cilësimet specifike për çdo mjet
- Ruani konfigurimin tuaj
Integrimi SmartFlow
Mjetet MCP gjithashtu mund të përdoren në flukset e SmartFlow:
Përdorimi i Mjeteve MCP në Flukse
- Në SmartFlow, gjeni MCP në bibliotekën e veprimeve
- Tërhiqni veprimin MCP në fluksin tuaj
- Zgjidhni Serverin MCP dhe Mjetin
- Maponi parametrat e hyrjes nga konteksti i fluksit tuaj
- Përdorni përgjigjen e mjetit në veprimet e mëpasshme
Shembull: Fluksi i Kërkimit të Klientit
Trigger: Shërbimi i Bisedës (kur përdoruesi pyet për llogarinë)
Actions:
1. Thirrja e Mjetit MCP:
Server: CRM i Kompanisë
Mjeti: search_crm
Parametrat:
query: {{user_email}}
2. Përgjigja e AI:
Konteksti: Rezultati i kërkimit në CRM
Pyetja: Përgjigjini pyetjes së përdoruesit për llogarinë
Rastet e Përdorimit
Menaxhimi i Marrëdhënieve me Klientët
Lidhni CRM-në tuaj përmes MCP:
- "Kërko klientin John Smith"
- "Cili është statusi i llogarisë #12345?"
- "Sa bileta mbështetje të hapura kemi?"
Mjetet e Brendshme
Qasni sistemet e kompanisë:
- "Kontrolloni inventarin për produktin SKU-123"
- "Çfarë ka në programin për nesër?"
- "Kërkoni në wiki-n tonë të brendshme për dokumentet e onboarding"
Burimet e Dhënave të Jashtme
Merrni të dhëna në kohë reale:
- "Cili është moti aktual në Paris?"
- "Merrni çmimin më të fundit të aksioneve për AAPL"
- "Kontrolloni statusin e fluturimit për UA123"
Mjetet e Zhvillimit
Për ekipet teknike:
- "Cili është statusi i ndërtimit më të fundit?"
- "Kërkoni në problemet tona në GitHub për defektet e autentifikimit"
- "Kontrolloni shëndetin e serverëve në prodhim"
MCP Server Shembuj
Serverat Popullorë të MCP
| Server | Qëllimi | Lidhja |
|---|---|---|
| Filesystem | Lexoni/shkruani skedarët lokalë | Server referencë i integruar |
| PostgreSQL | Kërkoni në databaza | Server komuniteti |
| GitHub | Menaxhimi i repo-ve | Server komuniteti |
| Slack | Integrimi i mesazheve | Server komuniteti |
Gjeni më shumë: Vizitoni MCP Server Registry për serverat e komunitetit.
MCP Serverat e Vetë-hostuar
Mund të krijoni servera të personalizuar MCP për:
- Sistemet e brendshme pronësore
- Logjikën e biznesit të personalizuar
- Qasjen në të dhëna të sigurta/private
Konsideratat për Sigurinë
Autentifikimi
| Metoda | Rast përdorimi |
|---|---|
| API Key | Autentifikim i thjeshtë server-i në server |
| OAuth 2.0 | Qasje e deleguar nga përdoruesi |
| mTLS | Mjedise me siguri të lartë |
Privatësia e të Dhënave
- Kërkesat MCP mund të përmbajnë të dhëna të përdoruesve
- Sigurohuni që serveri juaj MCP trajton të dhënat në mënyrë të duhur
- Merrni parasysh kërkesat për vendndodhjen e të dhënave
- Regjistroni dhe auditojini thirrjet e mjeteve MCP
Siguria e Rrjetit
- Përdorni HTTPS për të gjitha lidhjet MCP
- Kufizoni qasjen në serverin MCP për IP-të e AI SmartTalk
- Zbatoni kufizimin e normave në serverin tuaj MCP
Zgjidhja e Problemeve
Probleme me Lidhjen
| Problemi | Zgjidhja |
|---|---|
| "Lidhja u refuzua" | Kontrolloni URL-në e serverit dhe portin |
| "Autentifikimi dështoi" | Verifikoni kredencialet/API key |
| "Koha e pritjes" | Kontrolloni lidhjen me rrjetin, rregullat e firewall-it |
| "Gabim SSL" | Sigurohuni që certifikata SSL është e vlefshme |
Probleme me Zbulimin e Mjeteve
| Problemi | Zgjidhja |
|---|---|
| "Nuk u gjetën mjete" | Verifikoni që serveri MCP ekspozon mjete siç duhet |
| "Mjeti nuk është i disponueshëm" | Kontrolloni që mjeti është aktivizuar në anën e serverit |
| "Përputhje e skemës" | Përditësoni AI SmartTalk për të rifreskuar skemat e mjeteve |
Probleme në Koha e Ekzekutimit
| Problemi | Zgjidhja |
|---|---|
| "Thirrja e mjeteve dështoi" | Kontrolloni regjistrat e serverit për gabime |
| "Përgjigje e papritur" | Verifikoni që mjeti kthen formatin e pritur |
| "Kufizim në normë" | Zbatoni një strategji të prapambetjes ose rritni kufijtë |
Menaxhimi i Serverave MCP
| Veprimi | Si |
|---|---|
| Shto server | Cilësimet → Integrimet → MCP → Shto Server |
| Redakto server | Klikoni mbi emrin e serverit për ta modifikuar |
| Çaktivizo server | Çaktivizoni pa e fshirë |
| Hiq serverin | Butoni Fshi (mjete bëhen të paqasshme) |
| Rifresko mjete | Klikoni Rifresko për të ri-zbuluar mjete |
Praktikat më të Mira
- Filloni thjesht: Lidheni një server, testoni në mënyrë të plotë, pastaj zgjerojuni
- Dokumentoni mjete: Mbani dokumente të brendshme mbi atë që bën çdo mjet
- Monitoroni përdorimin: Ndjekni cilat mjete thirren dhe performancën
- Trajtoni gabimet me elegancë: AI duhet të trajtojë dështimet e mjeteve në mënyrë elegante
- Siguroni kredencialet: Përdorni variablat e ambientit, jo çelësa të koduar ngushtë
- Versiononi serverat tuaj: Serverat MCP duhet të kenë version për stabilitetin