# Anslut MCP-servrar till din bot Med MCP-servrar kan din AI-bot använda verktyg från ett annat system under live-konversationer — utan att du behöver bygga varje verktyg för hand. Du pekar boten mot en MCP-server en gång, och varje verktyg som servern erbjuder blir automatiskt tillgängligt för boten. Om du har använt anpassade funktioner (Custom Functions) är detta samma koncept, fast ett steg längre: en anpassad funktion är ett enskilt verktyg som du kopplar in själv, medan en MCP-server är ett färdigt paket med verktyg som boten kan upptäcka och anropa på egen hand. --- ## Vad är en MCP-server? MCP (Model Context Protocol) är en öppen standard för att ge AI-assistenter tillgång till externa verktyg. Många moderna appar och tjänster publicerar nu en "MCP-server" — en enskild webbadress som exponerar en uppsättning verktyg som AI:n kan anropa: slå upp något, hämta en post, köra en fråga, skapa ett objekt. Istället för att beskriva varje verktyg för boten, ger du Your AI Connector serverns adress och en åtkomstnyckel. Your AI Connector frågar servern "vad kan du göra?", får tillbaka listan över verktyg och gör dem tillgängliga för din bot. När servern lägger till ett nytt verktyg kan din bot använda det utan extra konfiguration från din sida. **Anpassade funktioner vs MCP-servrar — vad ska man använda:** | | Anpassade funktioner | MCP-servrar | | ------------------ | --------------------------------------------------- | -------------------------------------------------------------- | | **Vad du ställer in** | Ett verktyg i taget, helt manuellt (URL, indata, svarsmappning). | En serveradress — boten upptäcker alla dess verktyg åt dig. | | **Bäst för** | Ett enskilt, specifikt anrop till ditt eget system. | Anslutning till en tjänst som redan talar MCP och erbjuder många verktyg. | | **Underhåll** | Du uppdaterar funktionen när verktyget ändras. | Nya verktyg från servern visas automatiskt. | Du kan använda båda samtidigt på samma Agent. --- ## Hur det fungerar (den enkla versionen) 1. Du **registrerar en MCP-server** på sidan **MCP-servrar** — dess webbadress och en auktoriseringsrubrik (vanligtvis en API-nyckel). 2. Your AI Connector **ansluter och upptäcker** serverns verktyg och kommer ihåg listan. 3. Du **aktiverar servern på en agent**. 4. Under en konversation, när kunden ber om något som ett verktyg kan besvara, **anropar boten verktyget**, läser resultatet och svarar naturligt. Kunden ser aldrig maskineriet — de får bara ett svar baserat på korrekt, uppdaterad information. ### Vad ett MCP-verktygsanrop kostar Ett verktygsanrop från en MCP-server faktureras på exakt samma sätt som ett anrop till en anpassad funktion, enligt din agents AI-kvalitetsnivå: | AI-kvalitetsnivå | Krediter per MCP-verktygsanrop | Med din egen Anthropic-nyckel (BYOK) ansluten | |---|---|---| | Pro | 1 kredit | 0 krediter — körs på din nyckel | | Economy (föråldrad) | 0,5 krediter | 0 krediter — körs på din nyckel | | Max | 0,25 krediter | fortfarande 0,25 krediter, faktureras även med din egen nyckel ansluten, eftersom Max körs på vår egen modell | | Mini | 0,15 krediter | fortfarande 0,15 krediter, faktureras även med din egen nyckel ansluten, eftersom Mini körs på vår egen modell | --- ## Lägga till en MCP-server (steg för steg) I huvudmenyn till vänster, under **AI Studio**, klicka på **MCP-servrar**. Klicka sedan på **+ Lägg till server**. Fyll i formuläret: | Fält | Vad du ska ange | Exempel | | -------------------- | ----------------------------------------------------------------------------- | --------------------------------- | | **Namn** | En kort etikett för servern (används även för att namnge dess verktyg för boten). | `Order System` | | **Server-URL** | Serverns MCP-adress (ibland kallad "endpoint"), som börjar med `https://`. | `https://tools.mystore.com/mcp` | | **Auth Header Name** | Rubriken som servern förväntar sig för autentisering. Lämna som `Authorization` om inte serverns dokumentation säger något annat. | `Authorization` | | **Auth Header Value**| Själva autentiseringsuppgiften, i det format som servern förväntar sig. | `Bearer sk_live_abc123` | ### Välja hur du loggar in: API-nyckel eller OAuth Your AI Connector stöder två sätt att autentisera sig mot en server. Välj det som serverns dokumentation anger att du ska använda, med alternativet **Autentisering** högst upp i formuläret: - **API-nyckel / rubrik:** den ursprungliga metoden som beskrivs ovan. Du klistrar in en fast autentiseringsuppgift (en API-nyckel eller token) i fältet **Auth Header Value**, och Your AI Connector skickar den vid varje anrop. Bäst för servrar som ger dig en långlivad nyckel. - **OAuth (logga in):** för servrar som ber dig logga in istället för att klistra in en nyckel. Med OAuth finns ingen nyckel att kopiera — du godkänner åtkomst genom att logga in, på samma sätt som "Logga in med Google" fungerar på andra webbplatser. **För att ansluta med OAuth:** 1. Välj **OAuth** som autentiseringsmetod. Fälten för Auth Header försvinner och ersätts av ett **Anslut**-kort — du behöver ingen nyckel. 2. Fyll i **Namn** och **Server-URL**, klicka sedan på **Spara**. Servern läggs till i din lista, men visas som **ej ansluten** tills vidare. 3. Klicka på **Anslut** på servern. Ett säkert inloggningsfönster öppnas där du godkänner åtkomst. 4. Godkänn, så stängs fönstret automatiskt. Servern visas nu som ansluten och Your AI Connector laddar in dess verktyg. Det var allt. Your AI Connector håller anslutningen aktiv automatiskt i bakgrunden, så du behöver normalt aldrig röra den igen. Om en server någon gång tappar anslutningen (till exempel om inloggningen går ut eller någon återkallar den på serversidan), visas den som frånkopplad — klicka bara på **Återanslut** och logga in igen. Om servern inte kan ställas in automatiskt när du klickar på Anslut, blir du ombedd att klistra in några detaljer (en inloggningsadress och ett klient-ID) som serverns egen dokumentation tillhandahåller, varpå Anslut slutför inloggningen. ### Testa anslutningen Innan du sparar, klicka på **Testa anslutning**. Your AI Connector kontaktar servern och visar listan över verktyg den erbjuder. Detta är det snabbaste sättet att bekräfta att din URL och nyckel är korrekta — om anslutningen misslyckas ser du felmeddelandet direkt där istället för att upptäcka det mitt i en konversation. När testet lyckas, klicka på **Spara**. Din server visas i listan med en grön statuspunkt och antalet verktyg den erbjuder. ### Läsa serverlistan Varje server i listan visar: - En **statuspunkt** — grön när den senaste anslutningen fungerade, röd när det senaste försöket misslyckades (för muspekaren över för att se felet), grå före den första lyckade anslutningen. - **Serverns adress** och hur många verktyg den för närvarande erbjuder. - En **på/av-växel** för att snabbt aktivera eller inaktivera hela servern utan att ta bort den. Your AI Connector uppdaterar varje servers verktygslista i bakgrunden ungefär en gång om dagen, så nya verktyg dyker upp av sig själva. En långsam eller tillfälligt oåtkomlig server stoppar aldrig en konversation — boten använder helt enkelt den senast kända verktygslistan och hanterar det smidigt om ett anrop inte går igenom. ### Välja vilka verktyg boten får använda En server erbjuder ofta fler verktyg än du vill att boten ska röra. Du kan aktivera eller inaktivera enskilda verktyg utan att koppla från hela servern. 1. Klicka på **pennikonen (redigera)** för servern i listan. 2. Skrolla till avsnittet **Verktyg** — varje verktyg som servern erbjuder listas där, var och en med sin egen på/av-knapp. 3. Stäng av alla verktyg som du inte vill att boten ska anropa, eller använd **Aktivera alla** / **Inaktivera alla** för att ställa in dem på en gång. 4. Klicka på **Spara ändringar**. Endast de verktyg du lämnar påslagna erbjuds till boten. Ett verktyg som är avstängt är helt osynligt för boten — den kan inte anropa det, och det räknas inte in i gränsen på 40 verktyg. Två saker som är bra att veta: - **Nya verktyg förblir avstängda tills du slår på dem.** När du har kurerat en servers verktyg, kommer alla verktyg som servern lägger till senare att vara avstängda, så inget nytt blir tillgängligt för boten förrän du väljer att aktivera det. (Servrar som du aldrig har kurerat behåller alla sina verktyg påslagna, precis som tidigare.) - **Detta är separat från Agent-valet nedan.** Här bestämmer du vilka av en servers verktyg som överhuvudtaget finns tillgängliga för hela kontot; på Agenten bestämmer du vilka servrar som Agenten kan nå — och, om du vill, begränsa dess verktyg ytterligare för just den Agenten. ### Ställa in körningsgränser per verktyg Bredvid varje verktygs på/av-knapp hittar du en **Gränser**-kontroll. Den öppnar samma körningsgränser som du kan ställa in för en [anpassad funktion](custom-functions.md#execution-limits), men tillämpas endast på det specifika verktyget — användbart när en servers verktygsanrop använder en betald tredjepartstjänst, eller när ett verktyg bara ska köras en gång per konversation. Allt här är valfritt; lämna det tomt så beter sig verktyget precis som tidigare. - **Skrivskyddad.** Vissa servrar deklarerar för varje verktyg om det endast läser data. **Automatisk (serverinställning)** litar på den deklarationen; du kan åsidosätta den åt båda hållen — markera ett verktyg som **Skrivskyddad** när du vet att det aldrig skapar eller ändrar något (detta låter AI:n säkert försöka igen vid ett avbrutet svar istället för att lämna kunden utan svar), eller **Inte skrivskyddad** när du inte litar på serverns påstående. - **Returnera cachat resultat vid upprepade anrop.** När AI:n anropar verktyget igen med samma indata återanvänds det tidigare resultatet (i upp till 24 timmar) istället för att anropa servern igen. - **Max antal körningar per konversation** och **max antal körningar per tidsfönster** fungerar precis som för anpassade funktioner: endast lyckade körningar räknas, och när en gräns nås informeras AI:n om varför och svarar med den information den redan har — kunden lämnas aldrig hängande. Testkonversationer är undantagna. En ärlig notering om förtroende: gränser styr om och hur ofta *vi anropar* servern — de kan inte ändra vad servern gör internt när den väl har anropats. Och att åsidosätta ett tredjepartsverktyg till Skrivskyddad är ett starkare påstående än för din egen anpassade funktion, eftersom det är någon annans kod; gör det bara för verktyg du förstår. --- ## Aktivera en server på en Agent Att registrera en server gör den tillgänglig; du väljer fortfarande vilka agenter som kan använda den. 1. Öppna [Agenten](../ai-agents/ai-agents.md) och gå till fliken **AI-förmågor**. (För en kampanj som fortfarande har sina egna AI-inställningar direkt istället för via en separat agent, visas samma lista på kampanjens eget steg **AI-förmågor** istället.) 2. Hitta avsnittet **MCP-servrar**. 3. Aktivera varje server som du vill att den här agentens bot ska kunna använda. 4. Klicka på **Spara ändringar** — valen tillämpas först när de har sparats. Du kan aktivera upp till **5 servrar per Agent**. Endast de servrar du aktiverar är tillgängliga för den Agentens bot, vilket håller boten fokuserad på de verktyg som är relevanta. ### Välja vilka verktyg en Agent kan använda När en server väl är aktiverad på en Agent kan du också begränsa **vilka av dess verktyg** som den specifika Agenten får anropa — praktiskt när en Agent bara ska läsa data medan en annan även får skapa poster. 1. På fliken **AI-förmågor**, under den aktiverade servern, klicka på raden **"… verktyg aktiverade för denna agent"** för att expandera verktygslistan. 2. Stäng av alla verktyg som denna Agent inte bör använda, klicka sedan på **Spara ändringar**. Två regler gör detta förutsägbart: - **En Agent kan bara begränsa, aldrig utöka.** Verktyg som du stängt av för hela kontot (på sidan MCP-servrar) visas inte här och kan inte återaktiveras för en enskild Agent. - **Agenter ärver som standard.** En Agent där du inte har rört verktygslistan följer helt enkelt valet för hela kontot — inklusive verktyg som du aktiverar där senare. När du väl har begränsat en Agents lista förblir nya verktyg avstängda för den Agenten tills du aktiverar dem. --- ## Färdigt exempel: Anslut en Shopify-butik Varje Shopify-butik levereras med en inbyggd MCP-server — ingen app behöver installeras, ingen nyckel behöver skapas. Shopify är värd för den på butikens egen webbadress med `/api/mcp` tillagt i slutet. Vad boten får från den: - **Produktsökning** — hitta produkter genom att beskriva vad kunden vill ha ("en varm löparjacka under 100 dollar"), med aktuella priser, varianter och lagerstatus. - **Produktdetaljer** — fullständig information om en specifik produkt, inklusive alternativ och tillgänglighet. - **Butikspolicyer och vanliga frågor** — frågor om frakt, returer, återbetalningar och integritet, besvarade utifrån butikens egna sidor. - **Varukorg** — bygg en varukorg åt kunden och ge dem en länk till kassan. För att ansluta en, lägg till en server med: | Fält | Vad du ska ange | |---|---| | **Namn** | `Shopify Store` (eller butikens namn) | | **Server-URL** | Butikens webbadress plus `/api/mcp` — till exempel `https://mystore.com/api/mcp`. Butikens tekniska adress fungerar också: `https://mystore.myshopify.com/api/mcp`. | | **Autentisering** | Låt **API-nyckel / huvud** vara valt och lämna **Värde för autentiseringshuvud** tomt — den här servern behöver ingen nyckel. | Spara, klicka på **Testa anslutning** och aktivera servern på din agent — det är hela konfigurationen. Två saker att känna till: - **Beställningar finns inte på den här servern.** Shopify håller avsiktligt orderdata borta från denna publika slutpunkt. För frågor om "var är min beställning?", kombinera den här servern med en anpassad funktion — se [exemplet för Shopify-orderstatus](custom-functions.md#complete-example-shopify-order-status). - **Det fungerar för alla Shopify-butiker** — inklusive en kunds butik om du hanterar konton åt andra. Allt du behöver är butikens webbadress. --- ## Säkerhet — Anslut endast servrar du litar på En MCP-server som du ansluter kan anropas av din bot och kan returnera text som boten läser och agerar utifrån. Behandla den som vilken annan integration som helst som har tillgång till dina system: - **Registrera endast servrar som du kontrollerar eller fullt ut litar på.** Ett verktygs beskrivning skrivs av den som kör servern, och boten läser dessa beskrivningar för att avgöra när ett verktyg ska användas. - **Använd en dedikerad, begränsad API-nyckel**, inte en administratörsbehörighet. Din nyckel lagras säkert och visas aldrig i dataexporter. Detsamma gäller för OAuth-inloggningar — åtkomsttoken lagras säkert och maskeras i alla exporter. - **URL:en måste vara en offentlig `https://`-adress.** Interna adresser, localhost och adresser i privata nätverk avvisas av säkerhetsskäl. - **Inaktivera en server så fort du slutar lita på den** — stäng av den eller ta bort den, så försvinner den omedelbart från alla agenter. --- ## Felsökning - **Röd statuspunkt / anslutning misslyckades:** Öppna servern igen och klicka på **Testa anslutning** för att se det exakta felet. De vanligaste orsakerna är en felaktig eller utgången nyckel, ett skrivfel i URL:en eller att servern kräver ett annat huvudnamn än `Authorization`. - **En OAuth-server slutade fungera / ber dig återansluta:** OAuth-inloggningar kan återkallas eller löpa ut på serversidan. Öppna servern och klicka på **Anslut** igen för att logga in på nytt. Observera att OAuth-inloggningar aldrig kopieras mellan konton, så servrar för en kopierad Agent eller kampanj måste återanslutas i det konto du kopierade den till. - **Boten använder inte ett verktyg:** Kontrollera först att verktyget är aktiverat i serverns **Verktyg**-sektion (redigera servern för att se listan) — ett inaktiverat verktyg är osynligt för boten. Säkerställ sedan att servern är aktiverad för den specifika agenten och att kundens förfrågan tydligt matchar vad verktyget gör. Precis som med anpassade funktioner hjälper tydliga verktygsnamn och beskrivningar på serversidan boten att välja rätt. - **Ett verktyg som servern erbjuder visas inte för boten:** Om du har kurerat serverns verktyg, kom ihåg att alla verktyg som läggs till efter att du kurerat dem anländer inaktiverade. Redigera servern, öppna **Verktyg**-sektionen och aktivera det. - **Hanterar anslutningen MCP HTTP-sessioner?** Ja. Om din server utfärdar ett `mcp-session-id`-huvud när anslutningen upprättas, lagrar vi det och skickar tillbaka det vid varje efterföljande förfrågan, tillsammans med `MCP-Protocol-Version`-huvudet. Tillståndskänsliga servrar fungerar utan extra konfiguration från din sida. - **Ett verktyg hoppades över:** En agent kan använda högst 5 servrar och 40 MCP-verktyg samtidigt. Om en server erbjuder ett mycket stort antal verktyg kan vissa inte laddas — inaktivera de verktyg du inte behöver i serverns **Verktyg**-sektion, eller håll varje server fokuserad på de verktyg du faktiskt använder. --- ## Planeringskrav MCP-servrar är en del av utvecklarverktygen, tillsammans med anpassade funktioner. Om du inte ser **MCP-servrar** i AI Studio-sektionen i sidofältet ingår det inte i din nuvarande plan — uppgradera till en plan med utvecklarverktyg för att aktivera det. --- ## Nästa steg - [Anpassade funktioner](custom-functions.md) — koppla upp ett enskilt verktyg manuellt istället för att ansluta en hel server. - [AI-agenter](../ai-agents/ai-agents.md) — där MCP-servrar aktiveras för en bot. - [AI-agenter](../ai-agents/ai-agents.md) — huvudsidan för AI Studio-gruppen där MCP-servrar finns.