MCP Serveren
Verbannen extern Tools an Déngen AI SmartTalk mat dem Model Context Protocol (MCP). MCP ass e offenen Standard, deen et Ärem AI Assistent erlaabt, mat externen Systemer duerch eng eenheetlech Schnittstell ze interagéieren.
Iwwerbléck
D'MCP Server Integratioun erlaabt Iech:
- Verschidde MCP Server gläichzäiteg ze verbannen
- Extern Tools fir Ären AI ze exposéieren, déi während Gespréicher ugeruff kënne ginn
- Authentifizéieren mat benutzerdefinéiert HTTP Headeren (API Schlüsselen, Tokens, asw.)
- Verbindunge testen ier Dir live geet
- Fäegkeeten erweideren ouni benutzerdefinéiert Entwécklung
Wat ass MCP? Model Context Protocol ass e offenen Standard (entwéckelt vun Anthropic), deen et AI Systemer erlaabt, sécher mat externen Datequellen an Tools ze verbannen. Léiert méi op modelcontextprotocol.io.
Virbedingunge
Eier Dir ufänkt, stellt sécher datt Dir:
- Eng aktiv AI SmartTalk Kont huet
- Zougang zu engem oder méi MCP-kompatiblen Serveren huet
- Den Server URL fir all MCP Server
- All erfuerderlech Authentifizéierungsdokumenter (API Schlüsselen, Tokens)
Wéi MCP Fonctionnéiert
- Benotzer stellt eng Fro déi extern Daten erfuerdert
- AI SmartTalk erkennt datt et e MCP Tool brauch
- Den entspriechenden MCP Server gëtt ugeruff mat dem richtegen Tool
- Äntwert gëtt zréckginn an den AI formuléiert eng natierlech Sprooch Äntwert
AI SmartTalk ënnerstëtzt verschidde MCP Server zur selwechter Zäit. Tools vun verschiddene Serveren sinn automatesch namensrauméiert fir Konflikter ze verhënneren.
Schrëtt-fir-Schrëtt Setup
Schrëtt 1: Zougang zu MCP Integratioun
- Loggt Iech an Ärem AI SmartTalk Kont an
- Navigéiert zu Administratioun → Meng Assistenten → [Ären Assistenten Numm]
- Klickt op Connectors an der lénker Sidebar
- Fannt MCP Serveren an klickt drop
Schrëtt 2: Füügt e MCP Server derbäi
Klickt op Server derbäi fir d'Server Konfiguratiounsform ze öffnen. Fëllt déi folgend Felder aus:
| Feld | Erfuerderlech | Beschreiwung |
|---|---|---|
| Server Numm | Jo | E frëndleche Numm fir dësen Server ze identifizéieren (z.B. "Firma CRM", "Intern Wiki") |
| Server URL | Jo | Den MCP Server Endpoint URL (z.B. https://mcp.example.com) |
| HTTP Headeren | Nee | Benotzerdefinéiert Headeren fir Authentifikatioun oder aner Ufuerderungen |
AI SmartTalk fügt automatesch /mcp un Ärer URL derbäi wann et net scho domat endet. Zum Beispill, https://example.com gëtt https://example.com/mcp. Wann Äre Server e aneren Endpoint Pfad benotzt, inkludéiert et an der URL (z.B. https://example.com/api/mcp).
Schrëtt 3: Füügt Authentifizéierungsheaderen derbäi (Optional)
Wann Äre MCP Server Authentifikatioun erfuerdert, klickt op Header derbäi fir benotzerdefinéiert HTTP Headeren ze konfiguréieren:
| Allgemeng Header | Benotzungsfall |
|---|---|
Authorization | Bearer Tokens (z.B. Bearer sk-xxx...) |
X-API-Key | API Schlüssel Authentifikatioun |
X-Auth-Token | Benotzerdefinéiert Token Authentifikatioun |
Fir all Header, gitt:
- Schlëssel: Den Header Numm (wielt aus allgemenge Headeren oder tippt e benotzerdefinéiert een)
- Wäert: Den Header Wäert (sensibel Wäerter sinn automatesch am UI maskéiert)
Dir kënnt méi Headeren pro Server derbäi fügen. Headeren déi "secret", "password", "token", oder "auth" am Schlëssel Numm enthalen, sinn automatesch fir Sécherheet verstoppt.
Schrëtt 4: Test d'Verbindung
Eier Dir späichert, klickt op Test Verbindung fir ze vergewësseren datt Äre Server erreechbar ass:
- AI SmartTalk schéckt eng JSON-RPC Initialiséierungsufro un Äre Server
- Den Test iwwerpréift méi Endpoints an der Rei:
/mcp,/health, dann de Basis URL - Resultater weisen d'Verbindungsstatus, Äntwertzäit, an Serverinformatioun
| Test Resultat | Bedeitung |
|---|---|
| Verbunnen | Server huet erfollegräich mat MCP Protokoll geäntwert |
| Authentifikatioun ass gescheitert | Kontrolléiert Ären API Schlüssel oder Token an den Headeren |
| Server net fonnt | Vergewëssert Iech datt d'URL korrekt ass |
| Verbindung refuséiert | Server kann ofgeschalt sinn oder Firewall blockéiert Zougang |
| Timeout | Server huet ze laang gedauert fir ze reagéieren (10s Limit) |
| SSL Feeler | Kontrolléiert datt de Server e gültege SSL Zertifikat huet |
Schrëtt 5: Späichert Konfiguratioun
- Klickt op Derbäi fir de Server zu Ärer Lëscht derbäi ze fügen
- Widderhëlt Schrëtt 2-4 fir méi MCP Serveren derbäi ze fügen wann néideg
- Klickt op Späichert Integratioun fir all konfiguréiert Serveren ze aktivéieren
Multi-Server Ënnerstëtzung
AI SmartTalk ënnerstëtzt d'Verbannung vun multiple MCP Serveren gläichzäiteg. Dëst erlaabt Iech Tools vun verschiddene Quellen ze kombinéieren:
Tool Namensraum
Tools vun all Server sinn automatesch mat dem Server Numm virgesat fir Nummkonflikter ze verhënneren. Zum Beispill:
company_crm__search_customersinternal_wiki__search_docsweather_api__get_forecast
Dëst bedeit datt Dir sécher Server verbannen kënnt, déi Tools mat dem selwechte Numm exposéieren.
Verwalten vun multiple Serveren
D'Integratioun Dashboard weist all konfiguréiert Serveren mat:
- Server Numm an URL fir einfach Identifikatioun
- Headeren Zuel Badge wann benotzerdefinéiert Headeren konfiguréiert sinn
- Statusindikator (Konfiguréiert / Onvollstänneg)
- Aktioun Knäppercher: Test Verbindung, Änneren, oder Lëscht vun individuelle Serveren läschen
Tool Entdeckung
Eemol Är MCP Serveren verbannen sinn, entdeckt AI SmartTalk automatesch all verfügbar Tools, déi vun all Server exposéiert ginn. Dës Tools sinn direkt fir Ären AI Assistent verfügbar.
Den AI Assistent wäert:
- D'Lëscht vun all verfügbar Tools vun allen verbondene Serveren gesin
- Automatesch dat richtegt Tool baséiert op Benotzerufroen auswielen
- D'Tool mat den entspriechenden Parameteren ugeruff
- D'Äntwert verarbeiten an eng natierlech Sprooch Äntwert ginn
Dir musst net manuell individuell Tools konfiguréieren oder aktivéieren. All Tools, déi vun engem verbondene MCP Server exposéiert ginn, sinn automatesch fir Ären AI Assistent verfügbar.
Benotzungsfäll
Client Relatiounsmanagement
Verbannen Äert CRM iwwer MCP:
- "Sicht de Client John Smith"
- "Wat ass de Status vum Kont #12345?"
- "Wéi vill opgemaachte Support Tickets hunn mir?"
Intern Tools
Zougang zu Firmen Systemer:
- "Checkt d'Inventar fir Produkt SKU-123"
- "Wat ass um Plang fir muer?"
- "Sicht an eiser interner Wiki no Onboarding Dokumenter"
Extern Datequellen
Fänkt live Daten:
- "Wat ass d'aktuell Wieder zu Paräis?"
- "Kritt de leschten Aktienpräis fir AAPL"
- "Checkt de Fluchstatus fir UA123"
Entwécklungs Tools
Fir technesch Teams:
- "Wat ass de Status vum leschten Build?"
- "Sicht an eisen GitHub Problemer no Authentifikatioun Bugs"
- "Checkt d'Gesondheet vun der Produktioun Serveren"
MCP Server Beispiller
Beléifte MCP Server
| Server | Zweck | Link |
|---|---|---|
| Filesystem | Liest/Schreift lokal Dateien | Built-in reference server |
| PostgreSQL | Datenbanken ofroen | Community server |
| GitHub | Repo Management | Community server |
| Slack | Messaging Integratioun | Community server |
| Google Drive | Datei Management | Community server |
| Brave Search | Web Sich | Community server |
Fannt méi: Besicht den MCP Server Registry fir eng wuessend Lëscht vun der Gemeinschaft MCP Server.
Selwer Hosting MCP Server
Dir kënnt personaliséiert MCP Server fir:
- Proprietär intern Systemer
- Personaliséiert Geschäftslogik
- Sécher oder privat Daten Zougang
Benotzt all MCP SDK (TypeScript, Python) fir äre eegenen Server ze bauen.
Sécherheetsberécksiicht
Authentifikatioun
Konfiguréiert Authentifikatioun iwwer HTTP Headers an der Serverkonfiguratioun:
| Method | Header Beispill |
|---|---|
| Bearer Token | Authorization: Bearer sk-xxx... |
| API Key | X-API-Key: your-api-key |
| Custom Token | X-Auth-Token: your-token |
Datenprivatsphär
- MCP Ufroen kënnen Benotzer Gespréichsdaten enthalen
- Stellt sécher datt äre MCP Server Daten gemäß äre Privatsphärpolitiken behandelt
- Berécksiichtigt Datenresidenz Ufuerderungen
- AI SmartTalk maskéiert sensibel Header Wäerter an der UI
Netzwierk Sécherheet
- Benotzt HTTPS fir all MCP Verbindungen
- Beschränkt MCP Server Zougang op vertrauenswäert IPs
- Implementéiert Rate Limiting op ärem MCP Server
- Stellt sécher datt valabel SSL Zertifikater an der Plaz sinn
Problemer léisen
Verbindung Problemer
| Probleem | Léisung |
|---|---|
| "Verbindung refuséiert" | Kontrolléiert den Server URL an de Port. Stellt sécher datt de Server leeft |
| "Authentifikatioun gescheitert" (401) | Verifizéiert äre API Key oder Token an der Header Konfiguratioun |
| "Verbuet" (403) | Kontrolléiert datt Är Credentielle déi néideg Rechter hunn |
| "Server net fonnt" (404) | Verifizéiert den URL. AI SmartTalk fügt /mcp automatesch derbäi |
| "Timeout" | Kontrolléiert d'Netzverbindung an d'Firewallregelen. De Test huet e 10-Sekonnen Timeout |
| "SSL Fehler" | Stellt sécher datt äre MCP Server e valabelen SSL Zertifikat huet |
| "Rate limitéiert" (429) | Ze vill Ufroen. Waart a probéiert et nach eng Kéier, oder erhéicht Server Limiten |
Tool Problemer
| Probleem | Léisung |
|---|---|
| Tools net erschéngen | Verifizéiert datt de MCP Server Tools richteg exposéiert. Probéiert ze aktualiséieren |
| Falsche Tools ugeruff | Kontrolléiert datt d'Server Nimm beschreiwende sinn fir der AI ze hëllefen richteg ze wielen |
| Tool Uruff feiert | Kontrolléiert d'Server Logs fir Feeler. Stellt sécher datt d'Tool de erwaarten Format zréckgëtt |
Gemeinsame Feeler
- Vergiessen
/mcp: AI SmartTalk fügt et automatesch derbäi, mee wann äre Endpoint anescht ass, inkludéiert de komplette Wee - Falsche Header Format: Stellt sécher datt d'Authentifikatioun Headers mat deem übereenstëmmen wat äre Server erwaart
- Duplikat Server Nimm: All Server muss e eenzegaartegen Numm hunn
Verwalten MCP Server
| Aktioun | Wéi |
|---|---|
| Server derbäi addéieren | Klickt op "Add Server", fëllt d'Detailer aus, test, a späichert |
| Server änneren | Klickt op d'Ännerungsikone um Serverkaart |
| Verbindung testen | Klickt op d'Testikone um Serverkaart |
| Server läschen | Klickt op d'Läschikone um Serverkaart |
| Ännerungen späicheren | Klickt op "Save Integration" fir all Ännerungen ze bewahren |
Bescht Praktiken
- Benotzt beschreiwende Server Nimm: Hëlleft der AI ze verstoen wéi eng Server ze froen (z.B. "Firma CRM" amplaz "Server 1")
- Testen ier späicheren: Testt ëmmer d'Verbindungen fir Konfiguratiounsproblemer fréi ze fangen
- Starten mat engem Server: Gewannt Iech un eng Integratioun ier Dir méi derbäi fügt
- Sécher Är Credentielle: Benotzt dedizéiert API Schlüsselen fir AI SmartTalk, net perséinlech Tokens
- Iwwerwaacht Är Server: Spuert wéi eng Tools ugeruff ginn an hir Leeschtung
- Halt Server aktualiséiert: Stellt sécher datt äre MCP Server déi lescht Protokoll Spezifikatiounen verfollegen