Forbind MCP-servere til din bot
MCP-servere lader din AI-bot bruge værktøjer fra et andet system under live-samtaler — uden at du behøver at bygge hvert værktøj manuelt. Du peger botten mod en MCP-server én gang, og hvert værktøj, som serveren tilbyder, bliver automatisk tilgængeligt for botten.
Hvis du har brugt Custom Functions, er det samme koncept, bare taget et skridt videre: en custom function er et enkelt værktøj, du selv opsætter, mens en MCP-server er en færdig pakke af værktøjer, som botten selv kan finde og kalde.
Hvad er en MCP-server?
MCP (Model Context Protocol) er en åben standard for at give AI-assistenter adgang til eksterne værktøjer. Mange moderne apps og tjenester udgiver nu en “MCP-server” — en enkelt webadresse, der eksponerer et sæt værktøjer, som AI’en kan kalde: slå noget op, hente en post, køre en forespørgsel, oprette et element.
I stedet for at beskrive hvert værktøj for botten, giver du Your AI Connector serverens adresse og en adgangsnøgle. Your AI Connector spørger serveren “hvad kan du gøre?”, får listen over værktøjer tilbage og gør dem tilgængelige for din bot. Når serveren tilføjer et nyt værktøj, kan din bot bruge det uden yderligere opsætning fra din side.
Custom Functions vs. MCP-servere — hvad skal du bruge:
| Brugerdefinerede funktioner | MCP-servere | |
|---|---|---|
| Hvad du opsætter | Ét værktøj ad gangen, manuelt (URL, inputs, svar-mapping). | Én serveradresse — botten finder automatisk alle dens værktøjer for dig. |
| Bedst til | Et enkelt, specifikt kald til dit eget system. | Forbindelse til en tjeneste, der allerede taler MCP og tilbyder mange værktøjer. |
| Vedligeholdelse | Du opdaterer funktionen, når værktøjet ændres. | Nye værktøjer fra serveren vises automatisk. |
Du kan bruge begge dele samtidigt på den samme Agent.
Hvordan det fungerer (den simple version)
- Du registrerer en MCP-server på siden MCP Servers — dens webadresse og et autorisations-header (normalt en API-nøgle).
- Your AI Connector opretter forbindelse og finder serverens værktøjer og husker listen.
- Du aktiverer serveren på en Agent.
- Under en samtale, når kunden beder om noget, som et værktøj kan besvare, kalder botten værktøjet, læser resultatet og svarer naturligt.
Kunden ser aldrig maskinrummet — de får bare et svar baseret på reel, opdateret information.
Hvad et MCP-værktøjskald koster
Et værktøjskald fra en MCP-server faktureres nøjagtigt ligesom et brugerdefineret funktionskald, baseret på din agents AI-kvalitetsniveau:
| AI-kvalitetsniveau | Credits pr. MCP-værktøjskald | Med din egen Anthropic-nøgle (BYOK) tilsluttet |
|---|---|---|
| Pro | 1 credit | 0 credits — kører på din nøgle |
| Economy (udgået) | 0,5 credits | 0 credits — kører på din nøgle |
| Max | 0,25 credits | stadig 0,25 credits, faktureres selv med din egen nøgle tilsluttet, fordi Max kører på vores egen model |
| Mini | 0,15 credits | stadig 0,15 credits, faktureres selv med din egen nøgle tilsluttet, fordi Mini kører på vores egen model |
Tilføjelse af en MCP-server (trin for trin)
I hovedmenuen i venstre side under AI Studio skal du klikke på MCP-servere. Klik derefter på + Tilføj server.
Udfyld formularen:
| Felt | Hvad der skal indtastes | Eksempel |
|---|---|---|
| Navn | En kort betegnelse for serveren (bruges også til at navngive dens værktøjer til botten). | Order System |
| Server-URL | Serverens MCP-adresse (nogle gange kaldet et “endpoint”), der starter med https://. |
https://tools.mystore.com/mcp |
| Auth Header-navn | Den header, som serveren forventer til godkendelse. Lad den stå som Authorization, medmindre serverens dokumentation siger andet. |
Authorization |
| Auth Header-værdi | Selve legitimationsoplysningerne i det format, serveren forventer. | Bearer sk_live_abc123 |
Valg af loginmetode: API-nøgle eller OAuth
Your AI Connector understøtter to måder at godkende sig på en server. Vælg den, som serverens dokumentation angiver, ved hjælp af indstillingen Authentication øverst i formularen:
- API-nøgle / header: den oprindelige metode beskrevet ovenfor. Du indsætter en fast legitimation (en API-nøgle eller et token) i feltet Auth Header Value, og Your AI Connector sender den med hver anmodning. Bedst til servere, der giver dig en langvarig nøgle.
- OAuth (log ind): til servere, der beder dig om at logge ind i stedet for at indsætte en nøgle. Med OAuth er der ingen nøgle at kopiere — du godkender adgang ved at logge ind, på samme måde som “Log ind med Google” fungerer på andre websteder.
Sådan opretter du forbindelse med OAuth:
- Vælg OAuth som godkendelsesmetode. Felterne til Auth Header forsvinder og erstattes af et Connect-kort — du får ikke brug for en nøgle.
- Udfyld Name og Server URL, og klik derefter på Save. Serveren føjes til din liste, men vises som not connected indtil videre.
- Klik på Connect på serveren. Et sikkert log-ind-vindue åbnes, hvor du godkender adgang.
- Godkend, og vinduet lukker af sig selv. Serveren vises nu som forbundet, og Your AI Connector indlæser dens værktøjer.
Det er alt. Your AI Connector holder automatisk forbindelsen frisk i baggrunden, så du normalt aldrig behøver at røre ved den igen. Hvis en server nogensinde afbryder forbindelsen (for eksempel hvis log-ind-oplysningerne udløber, eller nogen tilbagekalder dem på serversiden), vises den som afbrudt — klik blot på Reconnect og log ind igen.
Hvis serveren ikke kan konfigureres automatisk, når du klikker på Forbind, bliver du bedt om at indsætte et par detaljer (en login-adresse og et klient-id), som serverens egen dokumentation leverer, hvorefter Forbind fuldfører login-processen.
Test forbindelsen
Før du gemmer, skal du klikke på Test Connection. Your AI Connector kontakter serveren og viser dig listen over værktøjer, den tilbyder. Dette er den hurtigste måde at bekræfte, at din URL og nøgle er korrekte — hvis forbindelsen fejler, vil du se fejlmeddelelsen med det samme i stedet for at opdage det midt i en samtale.
Når testen lykkes, skal du klikke på Gem. Din server vises på listen med en grøn statusprik og antallet af værktøjer, den tilbyder.
Læsning af serverlisten
Hver server på listen viser:
- En statusprik – grøn når den sidste forbindelse virkede, rød når det sidste forsøg fejlede (hold musen over for at se fejlen), grå før den første succesfulde forbindelse.
- Serverens adresse og hvor mange værktøjer den i øjeblikket tilbyder.
- En tænd/sluk-knap til hurtigt at aktivere eller deaktivere hele serveren uden at slette den.
Your AI Connector opdaterer hver servers værktøjsliste i baggrunden cirka en gang om dagen, så nye værktøjer dukker op af sig selv. En langsom eller midlertidigt utilgængelig server forsinker aldrig en samtale — botten bruger blot den sidst kendte værktøjsliste og falder elegant tilbage, hvis et kald ikke kan igennem.
Valg af hvilke værktøjer botten må bruge
En server tilbyder ofte flere værktøjer, end du ønsker, at botten skal have adgang til. Du kan slå individuelle værktøjer til eller fra uden at afbryde forbindelsen til hele serveren.
- Klik på blyant-ikonet (rediger) ud for serveren på listen.
- Rul ned til sektionen Værktøjer – alle værktøjer, som serveren tilbyder, er listet her, hver med sin egen tænd/sluk-knap.
- Slå de værktøjer fra, som du ikke ønsker, at botten skal kunne kalde, eller brug Aktivér alle / Deaktivér alle for at indstille dem på én gang.
- Klik på Gem ændringer.
Kun de værktøjer, du lader være slået til, tilbydes til botten. Et værktøj, der er slået fra, er fuldstændig usynligt for botten – den kan ikke kalde det, og det tæller ikke med i grænsen på 40 værktøjer.
To ting, der er værd at vide:
- Nye værktøjer forbliver deaktiverede, indtil du slår dem til. Når du har kurateret en servers værktøjer, vil ethvert værktøj, som serveren tilføjer senere, være slået fra, så intet nyt bliver tilgængeligt for botten, før du beslutter at aktivere det. (Servere, du aldrig har kurateret, beholder alle deres værktøjer slået til, præcis som før.)
- Dette er adskilt fra Agent-valget nedenfor. Her beslutter du, hvilke af en servers værktøjer der overhovedet findes på kontoniveau; på Agenten beslutter du, hvilke servere den Agent kan få adgang til — og, hvis du ønsker det, indsnævre dens værktøjer yderligere for netop den Agent.
Indstilling af udførelsesgrænser pr. værktøj
Ved siden af hvert værktøjs tænd/sluk-knap finder du en Grænser-kontrol. Den åbner de samme udførelsesgrænser, som du kan indstille på en brugerdefineret funktion, anvendt kun på det pågældende værktøj — nyttigt når en servers værktøjskald benytter en betalt tredjepartstjeneste, eller når et værktøj kun bør køre én gang pr. samtale. Alt her er valgfrit; lad det stå tomt, og værktøjet opfører sig præcis som før.
- Skrivebeskyttet. Nogle servere erklærer for hvert værktøj, om det kun læser data. Automatisk (serverindstilling) stoler på den erklæring; du kan tilsidesætte den begge veje — markér et værktøj som Skrivebeskyttet, når du ved, at det aldrig opretter eller ændrer noget (dette lader AI’en sikkert forsøge et afbrudt svar igen i stedet for at efterlade kunden uden et svar), eller Ikke skrivebeskyttet, når du ikke stoler på serverens påstand.
- Server cachede resultater ved gentagne kald. Når AI’en kalder værktøjet igen med de samme input, genbruges det forrige resultat (i op til 24 timer) i stedet for at kalde serveren igen.
- Maks. kørsler pr. samtale og maks. kørsler pr. tidsvindue fungerer præcis som på brugerdefinerede funktioner: kun succesfulde kørsler tæller, og når en grænse nås, får AI’en besked om hvorfor og svarer med den information, den allerede har — kunden bliver aldrig ladt i stikken. Testsamtaler er undtaget.
En ærlig bemærkning om tillid: grænser styrer, om og hvor ofte vi kalder serveren — de kan ikke ændre, hvad serveren gør internt, når den først er kaldt. Og at tilsidesætte et tredjepartsværktøj til Skrivebeskyttet er en stærkere påstand end på din egen brugerdefinerede funktion, fordi det er en andens kode; gør det kun for værktøjer, du forstår.
Aktivering af en server på en Agent
Registrering af en server gør den tilgængelig; du vælger stadig, hvilke agenter der kan bruge den.
- Åbn Agenten og gå til fanen AI-evner. (For en kampagne, der stadig har sine egne AI-indstillinger direkte i stedet for via en separat Agent, vises den samme liste i stedet på kampagnens eget AI-evner-trin.)
- Find sektionen MCP-servere.
- Slå hver server til, som du ønsker, at denne Agents bot skal kunne bruge.
- Klik på Gem ændringer — valg træder først i kraft, når de er gemt.
Du kan aktivere op til 5 servere pr. Agent. Kun de servere, du aktiverer, er tilgængelige for den pågældende Agents bot, hvilket holder botten fokuseret på de værktøjer, der er relevante.
Valg af hvilke værktøjer en Agent kan bruge
Når en server er aktiveret på en Agent, kan du også indsnævre, hvilke af dens værktøjer den specifikke Agent må kalde — praktisk når én Agent kun skal læse data, mens en anden også må oprette poster.
- På fanen AI-evner under den aktiverede server skal du klikke på rækken “… værktøjer aktiveret for denne agent” for at udvide værktøjslisten.
- Slå ethvert værktøj fra, som denne Agent ikke bør bruge, og klik derefter på Gem ændringer.
To regler holder dette forudsigeligt:
- En Agent kan kun indsnævre, aldrig udvide. Værktøjer, som du har slået fra på kontoniveau (på siden MCP-servere), vises ikke her og kan ikke genaktiveres for en enkelt Agent.
- Agenter arver som standard. En Agent, hvor du ikke har rørt værktøjslisten, følger blot valget på kontoniveau — inklusive værktøjer, du aktiverer der senere. Når du først har indsnævret en Agents liste, forbliver nye værktøjer slået fra for den Agent, indtil du aktiverer dem.
Færdigt eksempel: Forbind en Shopify-butik
Enhver Shopify-butik leveres med en indbygget MCP-server — ingen app skal installeres, ingen nøgle skal oprettes. Shopify hoster den på butikkens egen webadresse med /api/mcp tilføjet til slutningen.
Hvad botten får fra den:
- Produktsøgning — find produkter ved at beskrive, hvad kunden ønsker (“en varm løbejakke til under 100 $”), med live-priser, varianter og lagerstatus.
- Produktdetaljer — fuldstændig information om et specifikt produkt, inklusive valgmuligheder og tilgængelighed.
- Butikspolitikker og ofte stillede spørgsmål — svar på spørgsmål om forsendelse, returnering, refusion og privatliv, hentet direkte fra butikkens egne sider.
- Indkøbskurv — opbyg en indkøbskurv til kunden og giv dem et checkout-link.
For at forbinde en, tilføj en server med:
| Felt | Hvad der skal indtastes |
|---|---|
| Navn | Shopify Store (eller butikkens navn) |
| Server-URL | Butikkens webadresse plus /api/mcp — for eksempel https://mystore.com/api/mcp. Butikkens tekniske adresse virker også: https://mystore.myshopify.com/api/mcp. |
| Godkendelse | Lad API-nøgle / header være valgt og lad Auth Header-værdi være tom — denne server kræver ingen nøgle. |
Gem, klik på Test forbindelse, og aktivér serveren på din agent — det er hele opsætningen.
To ting du skal vide:
- Ordrer findes ikke på denne server. Shopify holder bevidst ordredata væk fra dette offentlige slutpunkt. Til “hvor er min ordre?”-spørgsmål, skal du parre denne server med en brugerdefineret funktion — se eksemplet med Shopify-ordrestatus.
- Det virker til enhver Shopify-butik — inklusive en kundes butik, hvis du administrerer konti for andre. Alt du behøver er butikkens webadresse.
Sikkerhed – forbind kun til servere, du har tillid til
En MCP-server, du opretter forbindelse til, kan kaldes af din bot og kan returnere tekst, som botten læser og handler ud fra. Behandl den som enhver anden integration, der har adgang til dine systemer:
- Registrer kun servere, som du kontrollerer eller har fuld tillid til. Et værktøjs beskrivelse skrives af den, der driver serveren, og botten læser disse beskrivelser for at beslutte, hvornår et værktøj skal bruges.
- Brug en dedikeret, begrænset API-nøgle, ikke en administratorlegitimationsoplysning. Din nøgle gemmes sikkert og vises aldrig i dataeksport. Det samme gælder for OAuth-logins — adgangstokens gemmes sikkert og er redigeret i enhver eksport.
- URL’en skal være en offentlig
https://-adresse. Interne adresser, localhost-adresser og adresser på private netværk afvises af sikkerhedshensyn. - Deaktiver en server i det øjeblik, du ikke længere har tillid til den — slå den fra eller slet den, så er den øjeblikkeligt væk fra alle agenter.
Fejlfinding
- Rød statusprik / forbindelse mislykkedes: Genåbn serveren og klik på Test forbindelse for at se den nøjagtige fejl. De mest almindelige årsager er en forkert eller udløbet nøgle, en slåfejl i URL’en eller at serveren kræver et andet headernavn end
Authorization. - En OAuth-server stoppede med at fungere / beder dig om at oprette forbindelse igen: OAuth-logins kan blive tilbagekaldt eller udløbe på serverens side. Åbn serveren og klik på Forbind igen for at logge ind igen. Bemærk, at OAuth-logins aldrig kopieres mellem konti, så servere fra en kopieret Agent eller kampagne skal forbindes igen på den konto, du kopierede dem til.
- Botten bruger ikke et værktøj: Tjek først, om værktøjet er slået til i serverens Værktøjer-sektion (rediger serveren for at se listen) – et deaktiveret værktøj er usynligt for botten. Sørg derefter for, at serveren er aktiveret på den specifikke Agent, og at kundens anmodning tydeligt matcher det, værktøjet gør. Som med brugerdefinerede funktioner hjælper klare værktøjsnavne og beskrivelser på serversiden botten med at vælge korrekt.
- Et værktøj, som serveren tilbyder, vises ikke for botten: Hvis du har kurateret denne servers værktøjer, skal du huske, at ethvert værktøj, der tilføjes, efter du har kurateret, ankommer i deaktiveret tilstand. Rediger serveren, åbn Værktøjer-sektionen, og slå det til.
- Håndterer connectoren MCP HTTP-sessioner? Ja. Hvis din server udsteder en
mcp-session-id-header, når forbindelsen etableres, gemmer vi den og sender den tilbage ved hver efterfølgende anmodning sammen medMCP-Protocol-Version-headeren. Tilstandsafhængige (stateful) servere fungerer uden yderligere konfiguration fra din side. - Et værktøj blev sprunget over: En Agent kan bruge højst 5 servere og 40 MCP-værktøjer på én gang. Hvis en server tilbyder et meget stort antal værktøjer, bliver nogle måske ikke indlæst – slå de værktøjer fra, du ikke har brug for, i serverens Værktøjer-sektion, eller hold hver server fokuseret på de værktøjer, du rent faktisk bruger.
Plan-krav
MCP-servere er en del af udviklerværktøjerne sammen med brugerdefinerede funktioner. Hvis du ikke kan se MCP-servere i AI Studio-sektionen i sidepanelet, inkluderer din nuværende plan det ikke — opgrader til en plan med udviklerværktøjer for at aktivere det.
Næste skridt
- Brugerdefinerede funktioner — opsæt et enkelt værktøj manuelt i stedet for at forbinde en hel server.
- AI-agenter — hvor MCP-servere aktiveres for en bot.
- AI-agenter — hovedsiden for AI Studio-gruppen, hvor MCP-servere findes.