MCP Servers
Povežite vanjske alate i usluge sa AI SmartTalk koristeći Model Context Protocol (MCP). MCP je otvoreni standard koji omogućava AI asistentima da komuniciraju sa vanjskim sistemima putem jedinstvenog interfejsa.
Pregled
Integracija MCP Servera omogućava vam da:
- Povežete bilo koji MCP-kompatibilni server
- Izložite alate koje vaš AI može koristiti tokom razgovora
- Pristupite vanjskim podacima putem standardizovanih protokola
- Proširite mogućnosti bez prilagođenog razvoja
Šta je MCP? Model Context Protocol je otvoreni standard (razvijen od strane Anthropic) koji omogućava AI sistemima da sigurno povežu sa vanjskim izvorima podataka i alatima.
Preduslovi
Prije nego što počnete, osigurajte da imate:
- Aktivni AI SmartTalk nalog
- Pristup MCP serveru (samo-hostovanom ili treće strane)
- MCP server URL i autentifikacione podatke
- Razumijevanje koji alati MCP server izlaže
Kako MCP funkcioniše
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ User Query │────▶│ AI SmartTalk │────▶│ MCP Server │
│ │ │ (AI Agent) │ │ │
│ "Check my CRM" │ │ │ │ - CRM tools │
│ │◀────│ Processes query │◀────│ - DB queries │
│ Response │ │ Calls MCP tools │ │ - File access │
└─────────────────┘ └─────────────────┘ └─────────────────┘
- Korisnik postavlja pitanje koje zahtijeva vanjske podatke
- AI SmartTalk prepoznaje da mu je potreban MCP alat
- MCP server se poziva sa odgovarajućim alatom
- Odgovor se vraća i AI formuliše odgovor
Postupak Postavljanja
Korak 1: Pristup MCP Integraciji
- Prijavite se na svoj AI SmartTalk račun
- Idite na Postavke → Integracije
- Pronađite MCP Servere i kliknite na Dodaj Server
Korak 2: Konfiguracija MCP Servera
Unesite detalje svog MCP servera:
| Polje | Opis |
|---|---|
| Ime Servera | Prijateljsko ime za ovu vezu |
| URL Servera | MCP server endpoint (npr., https://mcp.example.com) |
| Transport | SSE (Server-Sent Events) ili WebSocket |
| Autentifikacija | API ključ, OAuth, ili nijedna |
Korak 3: Testiranje Konekcije
- Kliknite na Testiraj Konekciju
- AI SmartTalk će pingovati MCP server
- Provjerite da li status prikazuje Povezano
Korak 4: Otkrijte Dostupne Alate
Jednom kada se povežete, AI SmartTalk preuzima listu dostupnih alata:
| Alat | Opis | Parametri |
|---|---|---|
search_crm | Pretraži zapise kupaca | query, limit |
create_ticket | Kreiraj tiket za podršku | title, description |
get_weather | Preuzmi podatke o vremenu | location |
Korak 5: Omogućite Alate za Vaš AI
- Pregledajte otkrivene alate
- Omogućite alate koje želite da vaš AI koristi
- Konfigurišite bilo koje postavke specifične za alat
- Sačuvajte svoju konfiguraciju
SmartFlow Integracija
MCP alati se takođe mogu koristiti u SmartFlow radnim tokovima:
Korištenje MCP Alata u Tokovima
- U SmartFlow-u, pronađite MCP u biblioteci akcija
- Prevucite MCP akciju u svoj tok
- Odaberite MCP Server i Alat
- Mapirajte ulazne parametre iz konteksta vašeg toka
- Iskoristite odgovor alata u narednim akcijama
Primjer: Tok za Pretragu Kupca
Trigger: Chat Service (kada korisnik pita o računu)
Actions:
1. MCP Alat Poziv:
Server: Company CRM
Tool: search_crm
Parameters:
query: {{user_email}}
2. AI Odgovor:
Context: Rezultat pretrage CRM-a
Prompt: Odgovorite na pitanje korisnika o računu
Upotrebe
Upravljanje Odnosima s Kupcima
Povežite svoj CRM putem MCP:
- "Pronađi kupca Johna Smitha"
- "Koji je status računa #12345?"
- "Koliko otvorenih tiketa za podršku imamo?"
Interni Alati
Pristupite sistemima kompanije:
- "Provjerite zalihe za proizvod SKU-123"
- "Šta je na rasporedu za sutra?"
- "Pretražite našu internu wiki za dokumente o uvođenju"
Eksterni Izvori Podataka
Preuzmite podatke u stvarnom vremenu:
- "Kakvo je trenutno vrijeme u Parizu?"
- "Donesite najnoviju cijenu dionica za AAPL"
- "Provjerite status leta za UA123"
Razvojni Alati
Za tehničke timove:
- "Koji je status najnovijeg builda?"
- "Pretražite naše GitHub probleme za greške u autentifikaciji"
- "Provjerite zdravlje produkcijskih servera"
MCP Server Primjeri
Popularni MCP Serveri
| Server | Svrha | Link |
|---|---|---|
| Filesystem | Čitanje/pisanje lokalnih datoteka | Ugrađeni referentni server |
| PostgreSQL | Upit baze podataka | Community server |
| GitHub | Upravljanje repozitorijima | Community server |
| Slack | Integracija poruka | Community server |
Pronađite više: Posjetite MCP Server Registry za community servere.
Samostalno Hostovani MCP Serveri
Možete kreirati prilagođene MCP servere za:
- Proprietarne interne sisteme
- Prilagođenu poslovnu logiku
- Siguran/privatan pristup podacima
Razmatranja o Sigurnosti
Autentifikacija
| Metoda | Slučaj upotrebe |
|---|---|
| API Key | Jednostavna autentifikacija između servera |
| OAuth 2.0 | Pristup delegiran od strane korisnika |
| mTLS | Okruženja visoke sigurnosti |
Privatnost Podataka
- MCP zahtjevi mogu sadržavati korisničke podatke
- Osigurajte da vaš MCP server pravilno rukuje podacima
- Razmotrite zahtjeve za rezidenciju podataka
- Zapisujte i auditirajte pozive MCP alata
Mrežna Sigurnost
- Koristite HTTPS za sve MCP veze
- Ograničite pristup MCP serveru na AI SmartTalk IP adrese
- Implementirajte ograničenje brzine na vašem MCP serveru
Rješavanje Problema
Problemi sa Povezivanjem
| Problem | Rješenje |
|---|---|
| "Connection refused" | Provjerite URL servera i port |
| "Authentication failed" | Potvrdite vjerodajnice/API ključ |
| "Timeout" | Provjerite mrežnu povezanost, pravila vatrozida |
| "SSL error" | Osigurajte važeći SSL certifikat |
Problemi sa Otkrićem Alata
| Problem | Rješenje |
|---|---|
| "No tools found" | Provjerite da li MCP server ispravno izlaže alate |
| "Tool not available" | Provjerite da li je alat omogućen na strani servera |
| "Schema mismatch" | Ažurirajte AI SmartTalk da osvježite sheme alata |
Problemi sa Izvršavanjem
| Problem | Rješenje |
|---|---|
| "Tool call failed" | Provjerite logove servera za greške |
| "Unexpected response" | Potvrdite da alat vraća očekivani format |
| "Rate limited" | Implementirajte backoff ili povećajte limite |
Upravljanje MCP Serverima
| Akcija | Kako |
|---|---|
| Dodaj server | Postavke → Integracije → MCP → Dodaj Server |
| Uredi server | Kliknite na naziv servera za izmjenu |
| Onemogući server | Isključite bez brisanja |
| Ukloni server | Dugme za brisanje (alati postaju nedostupni) |
| Osvježi alate | Kliknite Osvježi da ponovo otkrijete alate |
Najbolje Prakse
- Počnite jednostavno: Povežite jedan server, temeljito testirajte, a zatim proširite
- Dokumentujte alate: Čuvajte interne dokumente o tome šta svaki alat radi
- Pratite upotrebu: Pratite koji se alati pozivaju i performanse
- Elegantan pristup greškama: AI bi trebao elegantno rukovati neuspjesima alata
- Osigurajte vjerodajnice: Koristite varijable okruženja, a ne hardkodirane ključeve
- Verzionirajte svoje servere: MCP serveri trebaju biti verzionirani radi stabilnosti