MCP Servers
Conectați instrumentele și serviciile externe la AI SmartTalk folosind Model Context Protocol (MCP). MCP este un standard deschis care permite asistentului dumneavoastră AI să interacționeze cu sistemele externe printr-o interfață unificată.
Prezentare generală
Integrarea MCP Server vă permite să:
- Conectați mai multe servere MCP simultan
- Expuneți instrumente externe pentru ca AI-ul dumneavoastră să le poată apela în timpul conversațiilor
- Autentificați cu antete HTTP personalizate (chei API, tokenuri etc.)
- Testați conexiunile înainte de a merge live
- Extindeți capacitățile fără dezvoltare personalizată
Ce este MCP? Model Context Protocol este un standard deschis (dezvoltat de Anthropic) care permite sistemelor AI să se conecteze în siguranță la surse de date externe și instrumente. Aflați mai multe la modelcontextprotocol.io.
Cerințe preliminare
Înainte de a începe, asigurați-vă că aveți:
- Un cont activ AI SmartTalk
- Acces la unul sau mai multe servere compatibile MCP
- URL-ul serverului pentru fiecare server MCP
- Orice acreditive de autentificare necesare (chei API, tokenuri)
Cum funcționează MCP
- Utilizatorul pune o întrebare care necesită date externe
- AI SmartTalk recunoaște că are nevoie de un instrument MCP
- Serverul MCP corespunzător este apelat cu instrumentul corect
- Răspunsul este returnat și AI-ul formulează un răspuns în limbaj natural
AI SmartTalk suportă multiple servere MCP simultan. Instrumentele din diferite servere sunt automat numite pentru a preveni conflictele.
Configurare Pas cu Pas
Pasul 1: Accesați Integrarea MCP
- Conectați-vă la contul dumneavoastră AI SmartTalk
- Navigați la Administrare → Asistenții mei → [Numele asistentului dumneavoastră]
- Faceți clic pe Conectori în bara laterală stângă
- Găsiți MCP Servers și faceți clic pe el
Pasul 2: Adăugați un Server MCP
Faceți clic pe Adăugați Server pentru a deschide formularul de configurare a serverului. Completați următoarele câmpuri:
| Câmp | Necesare | Descriere |
|---|---|---|
| Numele Serverului | Da | Un nume prietenos pentru a identifica acest server (de exemplu, "CRM Companie", "Wiki Intern") |
| URL-ul Serverului | Da | URL-ul endpoint-ului serverului MCP (de exemplu, https://mcp.example.com) |
| Antete HTTP | Nu | Antete personalizate pentru autentificare sau alte cerințe |
AI SmartTalk adaugă automat /mcp la URL-ul dumneavoastră dacă acesta nu se termină deja cu acesta. De exemplu, https://example.com devine https://example.com/mcp. Dacă serverul dumneavoastră folosește un alt path de endpoint, includeți-l în URL (de exemplu, https://example.com/api/mcp).
Pasul 3: Adăugați Antete de Autentificare (Opțional)
Dacă serverul dumneavoastră MCP necesită autentificare, faceți clic pe Adăugați Antete pentru a configura antete HTTP personalizate:
| Antet Comun | Caz de Utilizare |
|---|---|
Authorization | Tokenuri Bearer (de exemplu, Bearer sk-xxx...) |
X-API-Key | Autentificare cu cheie API |
X-Auth-Token | Autentificare cu token personalizat |
Pentru fiecare antet, furnizați:
- Cheie: Numele antetului (selectați din antetele comune sau tastați unul personalizat)
- Valoare: Valoarea antetului (valorile sensibile sunt automat mascate în UI)
Puteți adăuga mai multe antete per server. Antetele care conțin "secret", "parolă", "token" sau "auth" în numele cheii sunt ascunse automat pentru securitate.
Pasul 4: Testați Conexiunea
Înainte de a salva, faceți clic pe Testați Conexiunea pentru a verifica dacă serverul dumneavoastră este accesibil:
- AI SmartTalk trimite o cerere de inițializare JSON-RPC către serverul dumneavoastră
- Testul verifică mai multe endpoint-uri în ordine:
/mcp,/health, apoi URL-ul de bază - Rezultatele arată starea conexiunii, timpul de răspuns și informațiile serverului
| Rezultatul Testului | Semnificație |
|---|---|
| Conectat | Serverul a răspuns cu succes cu protocolul MCP |
| Autentificare eșuată | Verificați cheia API sau tokenul în antete |
| Serverul nu a fost găsit | Verificați dacă URL-ul este corect |
| Conexiune refuzată | Serverul poate fi oprit sau firewall-ul blochează accesul |
| Timeout | Serverul a durat prea mult pentru a răspunde (limită de 10s) |
| Eroare SSL | Verificați dacă serverul are un certificat SSL valid |
Pasul 5: Salvați Configurarea
- Faceți clic pe Adăugați pentru a adăuga serverul la lista dumneavoastră
- Repetați Pașii 2-4 pentru a adăuga mai multe servere MCP, dacă este necesar
- Faceți clic pe Salvați Integrarea pentru a activa toate serverele configurate
Suport pentru Multiple Servere
AI SmartTalk suportă conectarea multiple servere MCP simultan. Acest lucru vă permite să combinați instrumente din diferite surse:
Nomenclatura Instrumentelor
Instrumentele din fiecare server sunt automat prefixate cu numele serverului pentru a preveni conflictele de nume. De exemplu:
company_crm__search_customersinternal_wiki__search_docsweather_api__get_forecast
Aceasta înseamnă că puteți conecta în siguranță servere care expun instrumente cu același nume.
Gestionarea Mai Multor Servere
Panoul de integrare arată toate serverele configurate cu:
- Numele serverului și URL-ul pentru o identificare ușoară
- Badge de număr de antete dacă antetele personalizate sunt configurate
- Indicator de stare (Configurat / Incomplet)
- Buton de acțiune: Testați conexiunea, Editați sau Ștergeți servere individuale
Descoperirea Instrumentelor
Odată ce serverele dumneavoastră MCP sunt conectate, AI SmartTalk descoperă automat toate instrumentele disponibile expuse de fiecare server. Aceste instrumente devin disponibile imediat asistentului dumneavoastră AI.
Asistentul AI va:
- Vede lista tuturor instrumentelor disponibile din toate serverele conectate
- Selecta automat instrumentul corect pe baza interogărilor utilizatorului
- Apela instrumentul cu parametrii corespunzători
- Procesa răspunsul și oferi un răspuns în limbaj natural
Nu trebuie să configurați manual sau să activați instrumente individuale. Toate instrumentele expuse de un server MCP conectat sunt disponibile automat asistentului dumneavoastră AI.
Cazuri de Utilizare
Managementul Relațiilor cu Clienții
Conectați-vă CRM-ul prin MCP:
- "Caută clientul John Smith"
- "Care este starea contului #12345?"
- "Câte tichete de suport deschise avem?"
Instrumente Interne
Accesați sistemele companiei:
- "Verificați stocul pentru produsul SKU-123"
- "Ce este pe program pentru mâine?"
- "Căutați în wiki-ul nostru intern documentele de integrare"
Surse Externe de Date
Obțineți date live:
- "Care este vremea actuală în Paris?"
- "Obțineți cel mai recent preț al acțiunilor pentru AAPL"
- "Verificați starea zborului pentru UA123"
Instrumente de Dezvoltare
Pentru echipele tehnice:
- "Care este starea ultimei construcții?"
- "Căutați problemele noastre de pe GitHub pentru bug-uri de autentificare"
- "Verificați starea serverelor de producție"
Exemple de Server MCP
Server MCP Populare
| Server | Scop | Link |
|---|---|---|
| Filesystem | Citire/scriere fișiere locale | Server de referință încorporat |
| PostgreSQL | Interogare baze de date | Server comunitar |
| GitHub | Management repo | Server comunitar |
| Slack | Integrare mesagerie | Server comunitar |
| Google Drive | Management fișiere | Server comunitar |
| Brave Search | Căutare web | Server comunitar |
Găsiți mai multe: Vizitați Registrul Serverelor MCP pentru o listă în continuă creștere de servere MCP comunitare.
Servere MCP Auto-găzduite
Puteți crea servere MCP personalizate pentru:
- Sisteme interne proprietare
- Logica de afaceri personalizată
- Acces la date securizate sau private
Utilizați orice SDK MCP (TypeScript, Python) pentru a construi propriul server.
Considerații de Securitate
Autentificare
Configurați autentificarea prin HTTP Headers în configurația serverului:
| Metodă | Exemplu Header |
|---|---|
| Bearer Token | Authorization: Bearer sk-xxx... |
| API Key | X-API-Key: your-api-key |
| Custom Token | X-Auth-Token: your-token |
Confidențialitatea Datelor
- Cererile MCP pot conține date despre conversațiile utilizatorilor
- Asigurați-vă că serverul MCP gestionează datele conform politicilor dvs. de confidențialitate
- Luați în considerare cerințele de rezidență a datelor
- AI SmartTalk maschează valorile sensibile ale header-elor în UI
Securitatea Rețelei
- Utilizați HTTPS pentru toate conexiunile MCP
- Restricționați accesul la serverul MCP la IP-uri de încredere
- Implementați limitarea ratei pe serverul dvs. MCP
- Asigurați-vă că certificatele SSL sunt valide
Depanare
Probleme de Conexiune
| Problemă | Soluție |
|---|---|
| "Conexiune refuzată" | Verificați URL-ul și portul serverului. Asigurați-vă că serverul este pornit |
| "Autentificare eșuată" (401) | Verificați cheia API sau token-ul în configurația header-elor |
| "Interzis" (403) | Verificați că acreditivele dvs. au permisiunile necesare |
| "Serverul nu a fost găsit" (404) | Verificați URL-ul. Aplicația AI SmartTalk adaugă automat /mcp |
| "Timeout" | Verificați conectivitatea rețelei și regulile firewall-ului. Testul are un timeout de 10 secunde |
| "Eroare SSL" | Asigurați-vă că serverul dvs. MCP are un certificat SSL valid |
| "Limită de rată" (429) | Prea multe cereri. Așteptați și încercați din nou sau creșteți limitele serverului |
Probleme cu Instrumentele
| Problemă | Soluție |
|---|---|
| Instrumentele nu apar | Verificați dacă serverul MCP expune corect instrumentele. Încercați să reîmprospătați |
| Instrumente greșite apelate | Verificați dacă numele serverelor sunt descriptive pentru a ajuta AI să aleagă corect |
| Apelul instrumentului eșuează | Verificați jurnalele serverului pentru erori. Asigurați-vă că instrumentul returnează formatul așteptat |
Greșeli Comune
- Uitați de
/mcp: AI SmartTalk îl adaugă automat, dar dacă endpoint-ul dvs. este diferit, includeți calea completă - Format greșit al header-ului: Asigurați-vă că header-urile de autentificare se potrivesc cu ceea ce așteaptă serverul dvs.
- Nume de server duplicate: Fiecare server trebuie să aibă un nume unic
Gestionarea Serverelor MCP
| Acțiune | Cum |
|---|---|
| Adăugați server | Faceți clic pe "Adăugați Server", completați detaliile, testați și salvați |
| Editați server | Faceți clic pe pictograma de editare de pe cardul serverului |
| Testați conexiunea | Faceți clic pe pictograma de testare de pe cardul serverului |
| Ștergeți server | Faceți clic pe pictograma de ștergere de pe cardul serverului |
| Salvați modificările | Faceți clic pe "Salvați Integrarea" pentru a păstra toate modificările |
Cele Mai Bune Practici
- Utilizați nume descriptive pentru servere: Ajută AI să înțeleagă care server să interogheze (de exemplu, "CRM-ul Companiei" în loc de "Server 1")
- Testați înainte de a salva: Testați întotdeauna conexiunile pentru a prinde problemele de configurare devreme
- Începeți cu un singur server: Familiarizați-vă cu o integrare înainte de a adăuga mai multe
- Securizați acreditivele: Utilizați chei API dedicate pentru AI SmartTalk, nu token-uri personale
- Monitorizați serverele dvs.: Urmăriți care instrumente sunt apelate și performanța acestora
- Mențineți serverele actualizate: Asigurați-vă că serverele dvs. MCP respectă cea mai recentă specificație a protocolului