MCP Poslužitelji
Povežite vanjske alate i usluge s AI SmartTalk koristeći Model Context Protocol (MCP). MCP je otvoreni standard koji omogućava vašem AI asistentu interakciju s vanjskim sustavima putem jedinstvenog sučelja.
Pregled
Integracija MCP Poslužitelja omogućava vam:
- Povezivanje više MCP poslužitelja istovremeno
- Izlaganje vanjskih alata koje vaš AI može koristiti tijekom razgovora
- Autentifikaciju s prilagođenim HTTP zaglavljima (API ključevi, tokeni itd.)
- Testiranje veza prije nego što postanu aktivne
- Proširenje mogućnosti bez prilagođenog razvoja
Što je MCP? Model Context Protocol je otvoreni standard (razvijen od strane Anthropic) koji omogućava AI sustavima da sigurno povežu s vanjskim izvorima podataka i alatima. Saznajte više na modelcontextprotocol.io.
Preduvjeti
Prije nego što započnete, osigurajte da imate:
- Aktivni AI SmartTalk račun
- Pristup jednom ili više MCP-kompatibilnih poslužitelja
- URL poslužitelja za svaki MCP poslužitelj
- Sve potrebne autentifikacijske vjerodajnice (API ključevi, tokeni)
Kako MCP Funkcionira
- Korisnik postavlja pitanje koje zahtijeva vanjske podatke
- AI SmartTalk prepoznaje da mu je potreban MCP alat
- Poziva se odgovarajući MCP poslužitelj s pravim alatom
- Odgovor se vraća i AI formulira odgovor na prirodnom jeziku
AI SmartTalk podržava više MCP poslužitelja odjednom. Alati s različitih poslužitelja automatski su imenovani kako bi se spriječili sukobi.
Postupak Postavljanja
Korak 1: Pristup MCP Integraciji
- Prijavite se u svoj AI SmartTalk račun
- Idite na Administracija → Moji asistenti → [Ime vašeg asistenta]
- Kliknite na Konektori u lijevom izborniku
- Pronađite MCP Poslužitelji i kliknite na njega
Korak 2: Dodajte MCP Poslužitelj
Kliknite Dodaj poslužitelj da otvorite obrazac za konfiguraciju poslužitelja. Ispunite sljedeća polja:
| Polje | Obavezno | Opis |
|---|---|---|
| Ime poslužitelja | Da | Prijateljsko ime za identifikaciju ovog poslužitelja (npr., "CRM tvrtke", "Interna wiki") |
| URL poslužitelja | Da | URL MCP poslužitelja (npr., https://mcp.example.com) |
| HTTP zaglavlja | Ne | Prilagođena zaglavlja za autentifikaciju ili druge zahtjeve |
AI SmartTalk automatski dodaje /mcp na vaš URL ako već ne završava s njim. Na primjer, https://example.com postaje https://example.com/mcp. Ako vaš poslužitelj koristi drugačiji put do krajnje točke, uključite ga u URL (npr., https://example.com/api/mcp).
Korak 3: Dodajte Autentifikacijska Zaglavlja (Opcionalno)
Ako vaš MCP poslužitelj zahtijeva autentifikaciju, kliknite Dodaj zaglavlja za konfiguraciju prilagođenih HTTP zaglavlja:
| Uobičajeno zaglavlje | Slučaj korištenja |
|---|---|
Authorization | Bearer tokeni (npr., Bearer sk-xxx...) |
X-API-Key | Autentifikacija putem API ključa |
X-Auth-Token | Prilagođena autentifikacija putem tokena |
Za svako zaglavlje, navedite:
- Ključ: Ime zaglavlja (odaberite iz uobičajenih zaglavlja ili upišite prilagođeno)
- Vrijednost: Vrijednost zaglavlja (osjetljive vrijednosti automatski se maskiraju u UI)
Možete dodati više zaglavlja po poslužitelju. Zaglavlja koja sadrže "secret", "password", "token" ili "auth" u imenu ključa automatski se skrivaju radi sigurnosti.
Korak 4: Testirajte Vezu
Prije spremanja, kliknite Testiraj vezu da provjerite je li vaš poslužitelj dostupan:
- AI SmartTalk šalje JSON-RPC inicijalizacijski zahtjev vašem poslužitelju
- Test provjerava više krajnjih točaka redom:
/mcp,/health, zatim osnovni URL - Rezultati prikazuju status veze, vrijeme odgovora i informacije o poslužitelju
| Rezultat testa | Značenje |
|---|---|
| Povezano | Poslužitelj je uspješno odgovorio s MCP protokolom |
| Autentifikacija nije uspjela | Provjerite svoj API ključ ili token u zaglavljima |
| Poslužitelj nije pronađen | Provjerite je li URL ispravan |
| Veza odbijena | Poslužitelj može biti nedostupan ili vatrozid blokira pristup |
| Istek vremena | Poslužitelj je predugo odgovarao (ograničenje 10s) |
| SSL gre ška | Provjerite ima li poslužitelj valjanu SSL certifikaciju |
Korak 5: Spremite Konfiguraciju
- Kliknite Dodaj da dodate poslužitelj na svoj popis
- Ponovite Korake 2-4 za dodavanje više MCP poslužitelja ako je potrebno
- Kliknite Spremi integraciju da aktivirate sve konfigurirane poslužitelje
Podrška za Više Poslužitelja
AI SmartTalk podržava povezivanje više MCP poslužitelja istovremeno. To vam omogućava kombiniranje alata iz različitih izvora:
Imenovanje Alata
Alati s svakog poslužitelja automatski se prefiksiraju s imenom poslužitelja kako bi se spriječili sukobi imenovanja. Na primjer:
company_crm__search_customersinternal_wiki__search_docsweather_api__get_forecast
To znači da možete sigurno povezati poslužitelje koji izlažu alate s istim imenom.
Upravljanje Više Poslužitelja
Nadzorna ploča integracije prikazuje sve konfigurirane poslužitelje s:
- Imenom poslužitelja i URL-om za jednostavnu identifikaciju
- Oznakom broja zaglavlja ako su konfigurirana prilagođena zaglavlja
- Pokazateljem statusa (Konfigurirano / Nepotpuno)
- Gumbima za akciju: Testiraj vezu, Uredi ili Izbriši pojedinačne poslužitelje
Otkriće Alata
Jednom kada su vaši MCP poslužitelji povezani, AI SmartTalk automatski otkriva sve dostupne alate koje izlaže svaki poslužitelj. Ovi alati postaju odmah dostupni vašem AI asistentu.
AI asistent će:
- Vidjeti popis svih dostupnih alata sa svih povezanih poslužitelja
- Automatski odabrati pravi alat na temelju korisničkih upita
- Pozvati alat s odgovarajućim parametrima
- Obraditi odgovor i pružiti odgovor na prirodnom jeziku
Ne trebate ručno konfigurirati ili omogućiti pojedinačne alate. Svi alati koje izlaže povezani MCP poslužitelj automatski su dostupni vašem AI asistentu.
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 imamo otvorenih zahtjeva za podršku?"
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
Preuzmite podatke u stvarnom vremenu:
- "Kakvo je trenutno vrijeme u Parizu?"
- "Daj 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 |
|---|---|---|
| Filesystem | Čitanje/pisanje lokalnih datoteka | Ugrađeni referentni server |
| PostgreSQL | Upit baze podataka | Zajednički server |
| GitHub | Upravljanje repozitorijima | Zajednički server |
| Slack | Integracija poruka | Zajednički server |
| Google Drive | Upravljanje datotekama | Zajednički server |
| Brave Search | Pretraživanje weba | Zajednički server |
Pronađite više: Posjetite MCP Server Registry za sve veći popis zajedničkih MCP servera.
Samostalno hostanje MCP Servera
Možete stvoriti prilagođene MCP servere za:
- Proprietarne interne sustave
- Prilagođenu poslovnu logiku
- Siguran ili privatni pristup podacima
Koristite bilo koji MCP SDK (TypeScript, Python) za izradu vlastitog servera.
Razmatranja o sigurnosti
Autentifikacija
Konfigurirajte autentifikaciju putem HTTP zaglavlja u konfiguraciji servera:
| Metoda | Primjer zaglavlja |
|---|---|
| Bearer Token | Authorization: Bearer sk-xxx... |
| API Key | X-API-Key: your-api-key |
| Custom Token | X-Auth-Token: your-token |
Privatnost podataka
- MCP zahtjevi mogu sadržavati podatke o korisničkim razgovorima
- Osigurajte da vaš MCP server obrađuje podatke u skladu s vašim politikama privatnosti
- Razmotrite zahtjeve za rezidenciju podataka
- AI SmartTalk maskira osjetljive vrijednosti zaglavlja u korisničkom sučelju
Mrežna sigurnost
- Koristite HTTPS za sve MCP veze
- Ograničite pristup MCP serveru na pouzdane IP adrese
- Implementirajte ograničenje brzine na vašem MCP serveru
- Osigurajte da su valjani SSL certifikati na mjestu
Rješavanje problema
Problemi s vezom
| Problem | Rješenje |
|---|---|
| "Veza odbijena" | Provjerite URL servera i port. Osigurajte da server radi |
| "Autentifikacija neuspjela" (401) | Provjerite svoj API ključ ili token u konfiguraciji zaglavlja |
| "Zabranjeno" (403) | Provjerite da vaši podaci imaju potrebne dozvole |
| "Server nije pronađen" (404) | Provjerite URL. AI SmartTalk automatski dodaje /mcp |
| "Istek vremena" | Provjerite mrežnu povezanost i pravila vatrozida. Test ima vremensko ograničenje od 10 sekundi |
| "SSL greška" | Osigurajte da vaš MCP server ima valjani SSL certifikat |
| "Ograničenje brzine" (429) | Previše zahtjeva. Pričekajte i pokušajte ponovno, ili povećajte ograničenja servera |
Problemi s alatima
| Problem | Rješenje |
|---|---|
| Alati se ne prikazuju | Provjerite izlaže li MCP server alate ispravno. Pokušajte osvježiti |
| Pozvani pogrešni alati | Provjerite jesu li imena servera opisna kako bi AI mogao ispravno odabrati |
| Poziv alata ne uspijeva | Provjerite logove servera za greške. Osigurajte da alat vraća očekivani format |
Česte pogreške
- Zaboravljanje
/mcp: AI SmartTalk ga dodaje automatski, ali ako je vaša točka drugačija, uključite puni put - Pogrešan format zaglavlja: Provjerite da zaglavlja autentifikacije odgovaraju onome što vaš server očekuje
- Duplicirani nazivi servera: Svaki server mora imati jedinstveno ime
Upravljanje MCP Serverima
| Akcija | Kako |
|---|---|
| Dodaj server | Kliknite "Dodaj server", ispunite podatke, testirajte i spremite |
| Uredi server | Kliknite ikonu za uređivanje na kartici servera |
| Testiraj vezu | Kliknite ikonu za testiranje na kartici servera |
| Izbriši server | Kliknite ikonu za brisanje na kartici servera |
| Spremi promjene | Kliknite "Spremi integraciju" kako biste sačuvali sve promjene |
Najbolje prakse
- Koristite opisne nazive servera: Pomaže AI-u da razumije koji server upititi (npr. "Tvrtka CRM" umjesto "Server 1")
- Testirajte prije spremanja: Uvijek testirajte veze kako biste rano otkrili probleme s konfiguracijom
- Započnite s jednim serverom: Upoznajte se s jednom integracijom prije nego dodate više
- Osigurajte svoje vjerodajnice: Koristite posvećene API ključeve za AI SmartTalk, a ne osobne tokene
- Pratite svoje servere: Pratite koji se alati pozivaju i njihovu izvedbu
- Održavajte servere ažuriranima: Osigurajte da vaši MCP serveri slijede najnoviju specifikaciju protokola