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 poslužitelja
- Izlaganje alata koje vaš 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 poslužitelju (samo-ugrađenom ili treće strane)
- URL MCP poslužitelja i vjerodajnice za autentifikaciju
- Razumijevanje koji alati MCP poslužitelj 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 su potrebni MCP alati
- MCP poslužitelj se poziva s odgovarajućim alatom
- Odgovor se vraća i AI formulira odgovor
Korak-po-korak Postavljanje
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 |
|---|---|
| Naziv Poslužitelja | Prijateljski naziv za ovu vezu |
| URL Poslužitelja | MCP poslužiteljski endpoint (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
Jednom 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 vremenske podatke | 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 se također mogu koristiti u SmartFlow radnim tokovima:
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 (kada korisnik pita o računu)
Actions:
1. MCP Alat Poziv:
Poslužitelj: Company CRM
Alat: search_crm
Parametri:
query: {{user_email}}
2. AI Odgovor:
Kontekst: Rezultat pretraživanja CRM-a
Upit: Odgovorite na pitanje korisnika o računu
Primjeri Korištenja
Upravljanje Odnosima s Kupcima
Povežite svoj CRM putem MCP:
- "Potraži kupca Johna Smitha"
- "Koji je status računa #12345?"
- "Koliko otvorenih podržavamo imamo?"
Interni Alati
Pristupite sustavima tvrtke:
- "Provjeri zalihe za proizvod SKU-123"
- "Što je na rasporedu za sutra?"
- "Pretraži našu internu wiki za dokumente o uvođenju"
Vanjski Izvori Podataka
Dohvatite podatke u stvarnom vremenu:
- "Koje je trenutno vrijeme u Parizu?"
- "Dohvati najnoviju cijenu dionica za AAPL"
- "Provjeri status leta za UA123"
Razvojni Alati
Za tehničke timove:
- "Koji je status najnovije verzije?"
- "Pretraži naše GitHub probleme za greške u autentifikaciji"
- "Provjeri zdravlje produkcijskih poslužitelja"
MCP Server Primjeri
Popularni MCP Serveri
| Server | Svrha | Link |
|---|---|---|
| Datotečni sustav | Čitanje/pisanje lokalnih datoteka | Ugrađeni referentni server |
| PostgreSQL | Upitnici za baze podataka | Zajednički server |
| GitHub | Upravljanje repozitorijima | Zajednički server |
| Slack | Integracija poruka | Zajednički server |
Pronađite više: Posjetite MCP Server Registry za zajedničke 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 upotrebe |
|---|---|
| API Ključ | 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 povezivanjem
| 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" | Potvrdite da MCP server ispravno izlaže alate |
| "Alat nije dostupan" | Provjerite je li alat omogućen na strani servera |
| "Neusklađenost sheme" | Ažurirajte AI SmartTalk za osvježavanje shema alata |
Problemi s izvođenjem
| Problem | Rješenje |
|---|---|
| "Poziv alata nije uspio" | Provjerite zapisnike 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: Čuvajte interne dokumente o tome što svaki alat radi
- Pratite korištenje: Pratite koji se alati pozivaju i njihovu izvedbu
- Upravljajte greškama s dostojanstvom: AI bi trebao elegantno upravljati neuspjesima alata
- Osigurajte vjerodajnice: Koristite varijable okruženja, a ne hardkodirane ključeve
- Verzionirajte svoje servere: MCP serveri trebaju biti verzionirani radi stabilnosti