MCP Serveri
Povežite vanjske alate i usluge s AI SmartTalk koristeći Model Context Protocol (MCP). MCP je otvoreni standard koji omogućuje AI asistentima interakciju s vanjskim sustavima putem jedinstvenog sučelja.
Pregled
Integracija MCP Servera omogućuje vam:
- Povezivanje bilo kojeg MCP-kompatibilnog servera
- Izlaganje alata koje vaša AI može koristiti tijekom razgovora
- Pristup vanjskim podacima putem standardiziranih protokola
- Proširenje mogućnosti bez prilagođenog razvoja
Što je MCP? Model Context Protocol je otvoreni standard (razvijen od strane Anthropic) koji omogućuje AI sustavima sigurno povezivanje s vanjskim izvorima podataka i alatima.
Preduvjeti
Prije nego što započnete, osigurajte da imate:
- Aktivni AI SmartTalk račun
- Pristup MCP serveru (samo-ugrađenom ili treće strane)
- MCP server URL i vjerodajnice za autentifikaciju
- Razumijevanje koji alati MCP server izlaže
Kako MCP radi
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ Upit korisnika │────▶│ AI SmartTalk │────▶│ MCP Server │
│ │ │ (AI Agent) │ │ │
│ "Provjeri moj CRM" │ │ │ │ - CRM alati │
│ │◀────│ Obrada upita │◀────│ - DB upiti │
│ Odgovor │ │ Poziva MCP alate │ │ - Pristup datotekama │
└─────────────────┘ └─────────────────┘ └─────────────────┘
- Korisnik postavlja pitanje koje zahtijeva vanjske podatke
- AI SmartTalk prepoznaje da mu je potreban MCP alat
- MCP server se poziva s odgovarajućim alatom
- Odgovor se vraća i AI formulira odgovor
Postupak Postavljanja
Korak 1: Pristup MCP Integraciji
- Prijavite se na svoj AI SmartTalk račun
- Idite na Postavke → Integracije
- Pronađite MCP poslužitelje i kliknite Dodaj poslužitelj
Korak 2: Konfigurirajte MCP Poslužitelj
Unesite podatke o svom MCP poslužitelju:
| Polje | Opis |
|---|---|
| Ime poslužitelja | Prijateljsko ime za ovu vezu |
| URL poslužitelja | MCP poslužiteljski krajnji točka (npr., https://mcp.example.com) |
| Transport | SSE (Server-Sent Events) ili WebSocket |
| Autentifikacija | API ključ, OAuth ili nijedna |
Korak 3: Testirajte Vezu
- Kliknite Testiraj vezu
- AI SmartTalk će pingati MCP poslužitelj
- Provjerite da status prikazuje Povezano
Korak 4: Otkrijte Dostupne Alate
Kada se povežete, AI SmartTalk dohvaća popis dostupnih alata:
| Alat | Opis | Parametri |
|---|---|---|
search_crm | Pretraži korisničke zapise | query, limit |
create_ticket | Kreiraj podršku | title, description |
get_weather | Dohvati podatke o vremenu | location |
Korak 5: Omogućite Alate za Vaš AI
- Pregledajte otkrivene alate
- Omogućite alate koje želite da vaš AI koristi
- Konfigurirajte bilo koje postavke specifične za alat
- Spremite svoju konfiguraciju
SmartFlow Integracija
MCP alati također se mogu koristiti u SmartFlow radnim tijekovima:
Korištenje MCP Alata u Tokovima
- U SmartFlow-u, pronađite MCP u biblioteci akcija
- Povucite MCP akciju u svoj tok
- Odaberite MCP poslužitelj i Alat
- Mapirajte ulazne parametre iz konteksta vašeg toka
- Iskoristite odgovor alata u sljedećim akcijama
Primjer: Tok za Pretraživanje Kupca
Trigger: Chat Service (when user asks about account)
Actions:
1. MCP Tool Call:
Server: Company CRM
Tool: search_crm
Parameters:
query: {{user_email}}
2. AI Response:
Context: CRM lookup result
Prompt: Answer user's account question
Primjene
Upravljanje Odnosima s Kupcima
Povežite svoj CRM putem MCP:
- "Potraži kupca Johna Smitha"
- "Koji je status računa #12345?"
- "Koliko otvorenih podrških imamo?"
Interni Alati
Pristupite sustavima tvrtke:
- "Provjerite zalihe za proizvod SKU-123"
- "Što je na rasporedu za sutra?"
- "Pretražite našu internu wiki za dokumente o uvođenju"
Vanjski Izvori Podataka
Dohvatite podatke u stvarnom vremenu:
- "Kakvo je trenutno vrijeme u Parizu?"
- "Dohvati najnoviju cijenu dionica za AAPL"
- "Provjerite status leta za UA123"
Razvojni Alati
Za tehničke timove:
- "Koji je status najnovije verzije?"
- "Pretražite naše GitHub probleme za greške u autentifikaciji"
- "Provjerite zdravlje produkcijskih poslužitelja"
MCP Server Primjeri
Popularni MCP Serveri
| Server | Svrha | Link |
|---|---|---|
| Filesystem | Čitanje/pisanje lokalnih datoteka | Ugrađeni referentni server |
| PostgreSQL | Upitnici za 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 hostanje MCP Servera
Možete kreirati prilagođene MCP servere za:
- Proprietarne interne sustave
- Prilagođenu poslovnu logiku
- Siguran/privatan pristup podacima
Razmatranja o sigurnosti
Autentifikacija
| Metoda | Slučaj korištenja |
|---|---|
| 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 obrađuje podatke
- Razmotrite zahtjeve za prebivalište podataka
- Zabilježite 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 s vezom
| Problem | Rješenje |
|---|---|
| "Veza odbijena" | Provjerite URL servera i port |
| "Autentifikacija nije uspjela" | Potvrdite vjerodajnice/API ključ |
| "Istek vremena" | Provjerite mrežnu povezanost, pravila vatrozida |
| "SSL greška" | Osigurajte valjanu SSL certifikaciju |
Problemi s otkrivanjem alata
| Problem | Rješenje |
|---|---|
| "Nema pronađenih alata" | Provjerite izlaže li MCP server alate ispravno |
| "Alat nije dostupan" | Provjerite je li alat omogućen na strani servera |
| "Nepodudaranje sheme" | Ažurirajte AI SmartTalk za osvježavanje shema alata |
Problemi tijekom izvođenja
| Problem | Rješenje |
|---|---|
| "Poziv alata nije uspio" | Provjerite logs servera za greške |
| "Neočekivani odgovor" | Potvrdite da alat vraća očekivani format |
| "Ograničenje brzine" | Implementirajte povlačenje 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 | Gumb za brisanje (alati postaju nedostupni) |
| Osvježi alate | Kliknite Osvježi za ponovo otkrivanje alata |
Najbolje prakse
- Započnite jednostavno: Povežite jedan server, temeljito testirajte, a zatim proširite
- Dokumentirajte alate: Držite interne dokumente o tome što svaki alat radi
- Pratite korištenje: Pratite koji se alati pozivaju i njihovu izvedbu
- Rješavajte greške s dostojanstvom: AI bi trebao elegantno rje šavati neuspjehe alata
- Osigurajte vjerodajnice: Koristite varijable okruženja, a ne hardkodirane ključeve
- Verzionirajte svoje servere: MCP serveri trebaju biti verzionirani radi stabilnosti