MCP Servers
Ikkonnettja għodod u servizzi esterni ma' AI SmartTalk bl-użu tal Model Context Protocol (MCP). MCP huwa standard miftuħ li jippermetti lill-assistenti AI jinteraġixxu ma' sistemi esterni permezz ta' interfaxxa unifikata.
Overview
L-integrazzjoni tal-MCP Server tippermettilek li:
- Tikkonnettja kwalunkwe server kompatibbli mal-MCP
- Teżponi għodod biex l-AI tiegħek ikollha aċċess waqt il-konversazzjonijiet
- Aċċess għal data esterna permezz ta' protokolli standardizzati
- Tespandi l-kapaċitajiet mingħajr żvilupp personalizzat
X'inhu MCP? Il-Model Context Protocol huwa standard miftuħ (sviluppat minn Anthropic) li jippermetti lis-sistemi AI jikkonnettjaw b'mod sikur ma' sorsi ta' data u għodod esterni.
Prerequisites
Qabel ma tibda, żgura li għandek:
- Kont attiv ta' AI SmartTalk
- Aċċess għal server MCP (hosted minn qiegħed jew minn terzi)
- URL tal-server MCP u kredenzjali ta' awtentikazzjoni
- Fehim ta' liema għodod l-MCP server jespone
How MCP Works
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ User Query │────▶│ AI SmartTalk │────▶│ MCP Server │
│ │ │ (AI Agent) │ │ │
│ "Check my CRM" │ │ │ │ - CRM tools │
│ │◀────│ Processes query │◀────│ - DB queries │
│ Response │ │ Calls MCP tools │ │ - File access │
└─────────────────┘ └─────────────────┘ └─────────────────┘
- L-utent jista' mistoqsija li teħtieġ data esterna
- AI SmartTalk jirrikonoxxi li jeħtieġ għodda MCP
- Is-server MCP jiġi kkonfermat bl-għodda xierqa
- Ir-risposta tiġi lura u l-AI tfassal l-għażla
Pass Pass Pass
Pass 1: Aċċess MCP Integration
- Logga fil-kont tiegħek ta' AI SmartTalk
- Naviga lejn Settings → Integrations
- Sib MCP Servers u ikklikkja Add Server
Pass 2: Ikonfigura l-MCP Server
Daħħal id-dettalji tal-MCP server tiegħek:
| Field | Deskrizzjoni |
|---|---|
| Server Name | Isem ħbiberija għal din il-konnessjoni |
| Server URL | Endpoint tal-MCP server (eż., https://mcp.example.com) |
| Transport | SSE (Server-Sent Events) jew WebSocket |
| Authentication | API key, OAuth, jew xejn |
Pass 3: Ittestja l-Konnessjoni
- Ikklikkja Test Connection
- AI SmartTalk se jpingja lill-MCP server
- Ikkonferma li l-istatus juri Connected
Pass 4: Skopri l-Għodod Disponibbli
Ladarba tkun konness, AI SmartTalk jġib il-lista ta' għodod disponibbli:
| Tool | Deskrizzjoni | Parametri |
|---|---|---|
search_crm | Iċċekkja r-rekords tal-konsumatur | query, limit |
create_ticket | Oħloq tiket ta' appoġġ | title, description |
get_weather | Iġbed id-dejta tal-temp | location |
Pass 5: Attiva Għodod għall-AI Tiegħek
- Iċċekkja l-għodod skoperti
- Attiva l-għodod li tixtieq li l-AI tiegħek juża
- Ikonfigura kwalunkwe settijiet speċifiċi tal-għodda
- Ħażna l-konfigurazzjoni tiegħek
SmartFlow Integration
L-għodod MCP jistgħu jintużaw ukoll fil-flussi ta' SmartFlow:
Użu ta' Għodod MCP fil-Flussi
- F'SmartFlow, sib MCP fil-librerija tal-azzjonijiet
- Iġbed l-azzjoni MCP fil-fluss tiegħek
- Agħżel il-MCP Server u Tool
- Mappar il-parametri tal-input mill-kuntest tal-fluss tiegħek
- Uża r-risposta tal-għodda fl-azzjonijiet sussegwenti
Eżempju: Fluss ta' Ħarsa lejn il-Konsumatur
Trigger: Chat Service (meta l-utent jistaqsi dwar il-kont)
Actions:
1. MCP Tool Call:
Server: Company CRM
Tool: search_crm
Parameters:
query: {{user_email}}
2. AI Response:
Context: Riżultat tal-ħarsa lejn il-CRM
Prompt: Iva l-mistoqsija tal-kont tal-utent
Każijiet ta' Użu
Ġestjoni tal-Relazzjonijiet mal-Konsumatur
Konnetti l-CRM tiegħek permezz tal-MCP:
- "Iċċekkja l-konsumatur John Smith"
- "X'inhu l-istatus tal-kont #12345?"
- "Kemm għandna tiket ta' appoġġ miftuħ?"
Għodod Interni
Aċċessa s-sistemi tal-kumpanija:
- "Iċċekkja l-inventarju għall-prodott SKU-123"
- "X'hemm fil-programm għas-sigħat li ġejjin?"
- "Iċċekkja l-wiki interna tagħna għall-docs ta' onboarding"
Sorsi ta' Dejta Esterni
Iġbed dejta live:
- "X'inhu t-temp attwali f'Paris?"
- "Iġbed il-prezz tal-ishma l-aktar reċenti għal AAPL"
- "Iċċekkja l-istatus tal-volo għal UA123"
Għodod ta' Żvilupp
Għall-timijiet tekniki:
- "X'inhu l-istatus tal-aħħar build?"
- "Iċċekkja l-kwistjonijiet tagħna fuq GitHub għall-bugs ta' awtentikazzjoni"
- "Iċċekkja s-saħħa tal-servers tal-produzzjoni"
Eżempji ta' MCP Server
MCP Servers Popolari
| Server | Skop | Link |
|---|---|---|
| Filesystem | Aqra/ikteb fajls lokali | Built-in reference server |
| PostgreSQL | Query databases | Community server |
| GitHub | Ġestjoni tar-repo | Community server |
| Slack | Integrazjoni tal-messaġġi | Community server |
Sib aktar: Żur il-MCP Server Registry għall-servers tal-komunità.
MCP Servers ta' Self-Hosting
Tista' toħloq MCP servers personalizzati għal:
- Sistemi interni proprjetarji
- Logika tan-negozju personalizzata
- Aċċess għal data sikura/private
Kunsiderazzjonijiet dwar is-Sigurtà
Awtentikazzjoni
| Metodu | Każ ta' Użu |
|---|---|
| API Key | Awtentikazzjoni sempliċi bejn servers |
| OAuth 2.0 | Aċċess delegat mill-utent |
| mTLS | Ambjenti ta' sigurtà għolja |
Privatezza tad-Data
- Talbiet MCP jistgħu jinkludu data tal-utent
- Żgura li l-MCP server tiegħek jittratta d-data b'mod xieraq
- Ikkunsidra r-rekwiżiti ta' residenza tad-data
- Ikkontratta u audita l-calls tal-għodod MCP
Sigurtà tan-Netwerk
- Uża HTTPS għal kull konnessjoni MCP
- Irestrinġi l-aċċess għall-MCP server għal IPs ta' AI SmartTalk
- Implimenta limitazzjoni tal-rata fuq il-MCP server tiegħek
Troubleshooting
Problemi ta' Konnessjoni
| Problema | Soluzzjoni |
|---|---|
| "Konnessjoni miċħuda" | Iċċekkja l-URL u l-port tal-server |
| "Awtentikazzjoni fallita" | Ivvverifika l-kredenzjali/API key |
| "Timeout" | Iċċekkja l-konnettività tan-netwerk, ir-regoli tal-firewall |
| "SSL error" | Żgura li għandek ċertifikat SSL validu |
Problemi ta' Skoperta tal-Għodod
| Problema | Soluzzjoni |
|---|---|
| "L-ebda għodda ma nstabet" | Ivvverifika li l-MCP server jespandi l-għodod b'mod korrett |
| "Għodda mhux disponibbli" | Iċċekkja li l-għodda hija attivata fuq in-naħa tas-server |
| "Schema mismatch" | Aġġorna AI SmartTalk biex tirfreska l-iskemi tal-għodod |
Problemi ta' Ħin ta' Eżekuzzjoni
| Problema | Soluzzjoni |
|---|---|
| "Il-call tal-għodda fallit" | Iċċekkja l-logs tas-server għal żbalji |
| "Risposta mhux mistenni" | Ivvverifika li l-għodda tirritorna l-format mistenni |
| "Rate limited" | Implimenta backoff jew żid il-limiti |
Ġestjoni ta' MCP Servers
| Azzjoni | Kif |
|---|---|
| Żid server | Settings → Integrations → MCP → Add Server |
| Editja server | Ikklikkja fuq isem is-server biex timmodifika |
| Disabbli server | Iċċaqlaq off mingħajr ma tħassar |
| Ħassar server | Buttuna ta' delete (l-għodod jsiru mhux disponibbli) |
| Rifreska l-għodod | Ikklikkja Rifreska biex terġa' ssib l-għodod |
Prattiċi Aħjar
- Ibda sempliċi: Ikkonnettja server wieħed, ittestja b'mod sħiħ, imbagħad espandi
- Dokumenta l-għodod: Żomm dokumenti interni dwar dak li jagħmel kull għodda
- Monitora l-użu: Ikkontrolla liema għodod qed jissejħu u l-prestazzjoni
- Iġib l-iżbalji b'mod eleganti: AI għandu jġib fallimenti tal-għodod b'mod eleganti
- Sikura l-kredenzjali: Uża varjabbli tal-ambjent, mhux keys hardcoded
- Versiona s-servers tiegħek: MCP servers għandhom ikunu versionati għal stabbiltà