MCP-servrar
Anslut externa verktyg och tjänster till AI SmartTalk med hjälp av Model Context Protocol (MCP). MCP är en öppen standard som låter din AI-assistent interagera med externa system genom ett enhetligt gränssnitt.
Översikt
MCP Server-integrationen gör det möjligt för dig att:
- Ansluta flera MCP-servrar samtidigt
- Exponera externa verktyg som din AI kan anropa under konversationer
- Autentisera med anpassade HTTP-huvuden (API-nycklar, tokens, etc.)
- Testa anslutningar innan de går live
- Utöka funktioner utan anpassad utveckling
Vad är MCP? Model Context Protocol är en öppen standard (utvecklad av Anthropic) som gör det möjligt för AI-system att säkert ansluta till externa datakällor och verktyg. Lär dig mer på modelcontextprotocol.io.
Förutsättningar
Innan du börjar, se till att du har:
- Ett aktivt AI SmartTalk-konto
- Tillgång till en eller flera MCP-kompatibla servrar
- Server-URL för varje MCP-server
- Eventuella nödvändiga autentiseringsuppgifter (API-nycklar, tokens)
Hur MCP fungerar
- Användaren ställer en fråga som kräver extern data
- AI SmartTalk känner igen att den behöver ett MCP-verktyg
- Den lämpliga MCP-servern anropas med rätt verktyg
- Svar returneras och AI formulerar ett svar på naturligt språk
AI SmartTalk stöder flera MCP-servrar samtidigt. Verktyg från olika servrar namnges automatiskt för att förhindra konflikter.
Steg-för-steg-installation
Steg 1: Åtkomst till MCP-integration
- Logga in på ditt AI SmartTalk-konto
- Navigera till Administration → Mina assistenter → [Ditt assistentnamn]
- Klicka på Anslutningar i den vänstra sidopanelen
- Hitta MCP-servrar och klicka på den
Steg 2: Lägg till en MCP-server
Klicka på Lägg till server för att öppna serverkonfigurationsformuläret. Fyll i följande fält:
| Fält | Obligatoriskt | Beskrivning |
|---|---|---|
| Servernamn | Ja | Ett vänligt namn för att identifiera denna server (t.ex. "Företags CRM", "Intern Wiki") |
| Server-URL | Ja | MCP-serverns slutpunkt-URL (t.ex. https://mcp.example.com) |
| HTTP-huvuden | Nej | Anpassade huvuden för autentisering eller andra krav |
AI SmartTalk lägger automatiskt till /mcp till din URL om den inte redan slutar med det. Till exempel, https://example.com blir https://example.com/mcp. Om din server använder en annan slutpunktssökväg, inkludera den i URL:en (t.ex. https://example.com/api/mcp).
Steg 3: Lägg till autentiseringshuvuden (valfritt)
Om din MCP-server kräver autentisering, klicka på Lägg till huvuden för att konfigurera anpassade HTTP-huvuden:
| Vanligt huvud | Användningsfall |
|---|---|
Authorization | Bearer-tokens (t.ex. Bearer sk-xxx...) |
X-API-Key | API-nyckelautentisering |
X-Auth-Token | Anpassad tokenautentisering |
F ör varje huvud, ange:
- Nyckel: Huvudnamnet (välj från vanliga huvuden eller skriv en anpassad)
- Värde: Huvudvärdet (känsliga värden maskeras automatiskt i användargränssnittet)
Du kan lägga till flera huvuden per server. Huvuden som innehåller "secret", "password", "token" eller "auth" i nyckelnamn döljs automatiskt av säkerhetsskäl.
Steg 4: Testa anslutningen
Innan du sparar, klicka på Testa anslutning för att verifiera att din server är nåbar:
- AI SmartTalk skickar en JSON-RPC-initialiseringsbegäran till din server
- Testet kontrollerar flera slutpunkter i ordning:
/mcp,/health, sedan bas-URL:en - Resultaten visar anslutningsstatus, svarstid och serverinformation
| Testresultat | Betydelse |
|---|---|
| Ansluten | Servern svarade framgångsrikt med MCP-protokollet |
| Autentisering misslyckades | Kontrollera din API-nyckel eller token i huvuden |
| Servern hittades inte | Verifiera att URL:en är korrekt |
| Anslutning nekad | Servern kan vara nere eller brandvägg blockerar åtkomst |
| Timeout | Servern tog för lång tid att svara (10s gräns) |
| SSL-fel | Kontrollera att servern har ett giltigt SSL-certifikat |
Steg 5: Spara konfiguration
- Klicka på Lägg till för att lägga till servern i din lista
- Upprepa steg 2-4 för att lägga till fler MCP-servrar om det behövs
- Klicka på Spara integration för att aktivera alla konfigurerade servrar
Stöd för flera servrar
AI SmartTalk stöder anslutning av flera MCP-servrar samtidigt. Detta gör att du kan kombinera verktyg från olika källor:
Verktygsnamnssättning
Verktyg från varje server får automatiskt prefix med servernamnet för att förhindra namnkollisioner. Till exempel:
company_crm__search_customersinternal_wiki__search_docsweather_api__get_forecast
Detta innebär att du säkert kan ansluta servrar som exponerar verktyg med samma namn.
Hantera flera servrar
Integrationsinstrumentpanelen visar alla konfigurerade servrar med:
- Servernamn och URL för enkel identifiering
- Huvudantal-märke om anpassade huvuden är konfigurerade
- Statusindikator (Konfigurerad / Ofullständig)
- Handlingsknappar: Testa anslutning, Redigera eller Ta bort individuella servrar
Verktygsupptäckte
När dina MCP-servrar är anslutna, upptäcker AI SmartTalk automatiskt alla tillgängliga verktyg som exponeras av varje server. Dessa verktyg blir omedelbart tillgängliga för din AI-assistent.
AI-assistenten kommer att:
- Se listan över alla tillgängliga verktyg från alla anslutna servrar
- Automatiskt välja rätt verktyg baserat på användarfrågor
- Anropa verktyget med lämpliga parametrar
- Bearbeta svaret och ge ett svar på naturligt språk
Du behöver inte manuellt konfigurera eller aktivera individuella verktyg. Alla verktyg som exponeras av en ansluten MCP-server är automatiskt tillgängliga för din AI-assistent.
Användningsfall
Kundrelationshantering
Anslut ditt CRM via MCP:
- "Sök efter kund John Smith"
- "Vad är status på konto #12345?"
- "Hur många öppna supportärenden har vi?"
Interna verktyg
Åtkomst till företagsystem:
- "Kontrollera lagret för produkt SKU-123"
- "Vad står på schemat för imorgon?"
- "Sök i vår interna wiki efter onboarding-dokument"
Externa datakällor
Hämta live-data:
- "Vad är det aktuella vädret i Paris?"
- "Hämta det senaste aktiepriset för AAPL"
- "Kontrollera flygstatus för UA123"
Utvecklingsverktyg
För tekniska team:
- "Vad är status på den senaste bygget?"
- "Sök i våra GitHub-ärenden efter autentiseringsbuggar"
- "Kontrollera hälsan på produktionsservrar"
MCP Server Exempel
Populära MCP Servrar
| Server | Syfte | Länk |
|---|---|---|
| Filesystem | Läs/skriv lokala filer | Inbyggd referensserver |
| PostgreSQL | Fråga databaser | Community server |
| GitHub | Repo hantering | Community server |
| Slack | Meddelandeintegration | Community server |
| Google Drive | Filhantering | Community server |
| Brave Search | Webb sökning | Community server |
Hitta mer: Besök MCP Server Registry för en växande lista över community MCP servrar.
Självhostade MCP Servrar
Du kan skapa anpassade MCP servrar för:
- Proprietära interna system
- Anpassad affärslogik
- Säker eller privat dataåtkomst
Använd valfritt MCP SDK (TypeScript, Python) för att bygga din egen server.
Säkerhetsöverväganden
Autentisering
Konfigurera autentisering via HTTP Headers i serverkonfigurationen:
| Metod | Header Exempel |
|---|---|
| Bearer Token | Authorization: Bearer sk-xxx... |
| API Nyckel | X-API-Key: your-api-key |
| Anpassad Token | X-Auth-Token: your-token |
Dataskydd
- MCP-förfrågningar kan innehålla användardata från konversationer
- Se till att din MCP-server hanterar data enligt dina sekretesspolicyer
- Överväg krav på datalagring
- AI SmartTalk maskerar känsliga header-värden i användargränssnittet
Nätverkssäkerhet
- Använd HTTPS för alla MCP-anslutningar
- Begränsa åtkomst till MCP-servern till betrodda IP-adresser
- Implementera hastighetsbegränsning på din MCP-server
- Se till att giltiga SSL-certifikat finns på plats
Felsökning
Anslutningsproblem
| Problem | Lösning |
|---|---|
| "Anslutning vägrad" | Kontrollera serverns URL och port. Se till att servern är igång |
| "Autentisering misslyckades" (401) | Verifiera din API-nyckel eller token i headerkonfigurationen |
| "Förbjuden" (403) | Kontrollera att dina referenser har de nödvändiga behörigheterna |
| "Servern hittades inte" (404) | Verifiera URL:en. AI SmartTalk lägger automatiskt till /mcp |
| "Timeout" | Kontrollera nätverksanslutning och brandväggsregler. Testet har en timeout på 10 sekunder |
| "SSL-fel" | Se till att din MCP-server har ett giltigt SSL-certifikat |
| "Hastighetsbegränsad" (429) | För många förfrågningar. Vänta och försök igen, eller öka serverbegränsningarna |
Verktygsproblem
| Problem | Lösning |
|---|---|
| Verktyg visas inte | Verifiera att MCP-servern exponera verktyg korrekt. Försök att uppdatera |
| Fel verktyg anropas | Kontrollera att servernamnen är beskrivande för att hjälpa AI att välja rätt |
| Verktygsanrop misslyckas | Kontrollera serverloggar för fel. Se till att verktyget returnerar förväntat format |
Vanliga Misstag
- Glömma
/mcp: AI SmartTalk lägger till det automatiskt, men om din slutpunkt är annorlunda, inkludera hela sökvägen - Fel headerformat: Se till att autentiseringsheaders matchar vad din server förväntar sig
- Duplicerade servernamn: Varje server måste ha ett unikt namn
Hantera MCP Servrar
| Åtgärd | Hur |
|---|---|
| Lägg till server | Klicka på "Lägg till server", fyll i detaljer, testa och spara |
| Redigera server | Klicka på redigeringsikonen på serverkortet |
| Testa anslutning | Klicka på testikonen på serverkortet |
| Ta bort server | Klicka på ta bort-ikonen på serverkortet |
| Spara ändringar | Klicka på "Spara integration" för att spara alla ändringar |
Bästa Praxis
- Använd beskrivande servernamn: Hjälper AI att förstå vilken server som ska frågas (t.ex. "Företags CRM" snarare än "Server 1")
- Testa innan du sparar: Testa alltid anslutningar för att fånga konfigurationsproblem tidigt
- Börja med en server: Bli bekväm med en integration innan du lägger till fler
- Säkra dina referenser: Använd dedikerade API-nycklar för AI SmartTalk, inte personliga tokens
- Övervaka dina servrar: Spåra vilka verktyg som anropas och deras prestanda
- Håll servrar uppdaterade: Se till att dina MCP-servrar följer den senaste protokollspecifikationen