Du skal have forbundet din AI (Claude eller
ChatGPT) og have et aktivt Webshipper-abonnement i
portalen først, eller have systemet med i jeres plan
(den gratis udgave eller
Consile Studio-medlemskabet). Webshipper-kontoen skal være
på Webshipper Pro eller Advanced, som har API-adgang. I Consile kan alle i teamet
forbinde en aftale, der ikke er forbundet endnu. Kun en administrator kan
forbinde den igen eller afbryde den. Forbindelsen gælder for hele virksomheden.
Trin 1: Find kontonavnet og opret et API-token i Webshipper
1
Find jeres kontonavn
Log ind i Webshipper. Kontonavnet er det, der står før
.webshipper.io i
adresselinjen, fx minbutik i minbutik.webshipper.io.2
Opret et API-token
Gå til Indstillinger → Adgang & tokens, og klik Opret API-token. Giv
tokenet et navn, du kan genkende, fx Consile. Så er det nemt at finde, hvis
adgangen senere skal trækkes tilbage.
3
Kopiér tokenet
Kopiér tokenet med det samme, og hold det hemmeligt. Det giver adgang til
jeres Webshipper-konto.
Et token hører til præcis én Webshipper-konto. Der er ikke noget at vælge
bagefter, for kontonavnet og tokenet afgør, hvilke data Consile kan læse. Har I
flere konti, fx én pr. brand eller land, skal I bruge ét token pr. konto (se
Flere aftaler).
Trin 2: Indsæt kontonavn og token i portalen
1
Åbn formularen i portalen
Åbn Webshipper-connectoren i portalen. Klik Forbind nu øverst på siden,
eller Forbind ud for aftalen på kortet Forbindelser. Portalen kalder
hver forbindelse til et system en aftale. Har du ikke accepteret Consiles
vilkår endnu, viser portalen dem først. Der åbnes en kort formular med en
trin-for-trin-guide øverst og to felter. Der er ingen viderestilling til en
ekstern side.
2
Udfyld felterne
Indsætter du hele adressen fra browseren, fx
https://minbutik.webshipper.io/orders, bruger Consile kun kontonavnet
(minbutik). Kopiér hele tokenet, og pas på, at der ikke kommer andet med.3
Gem
Klik Forbind. Consile tjekker først tokenet hos Webshipper. Afviser
Webshipper det, gemmes intet, og formularen viser en fejl (se
Hvis forbindelsen afvises). Ellers krypteres
tokenet og gemmes under netop din konto.
Skærmen Webshipper er klar viser connectorens adresse,
https://mcp.consile.ai/webshipper/mcp. Har du ikke allerede tilføjet den i
din AI, så kopiér den og tilføj den som custom connector (se
Forbind Claude). Klik Gå til connector for at
vende tilbage til Webshipper-siden. Under Overblik i portalen står
Webshipper nu som Forbundet, og aftalen får kontoens navn, fx
minbutik.webshipper.io.Hvis forbindelsen afvises
Afviser Webshipper tokenet eller kontonavnet, viser formularen Systemet afviste nøglen. Tjek, at den er kopieret rigtigt og stadig er aktiv, og prøv igen. Intet er gemt, og en forbindelse, der virkede i forvejen, er uændret.- Forkert token: tjek, at hele tokenet er kopieret, og at det ikke er slettet i Webshipper.
- Forkert kontonavn: Webshipper kender ikke kontoen. Tjek stavningen i
adresselinjen, når du er logget ind i Webshipper. Skriv kun kontonavnet, ikke
.api.webshipper.ioeller andet. - Ingen API-adgang: kontoen skal være på Webshipper Pro eller Advanced.
Flere aftaler
Hver aftale på kortet Forbindelser dækker én Webshipper-konto og bliver sin egen navngivne connector i din AI. Har I flere Webshipper-konti, gør du sådan:1
Tilføj en aftale
Åbn Webshipper-connectoren i portalen. På kortet Forbindelser klikker en
administrator Tilføj aftale (149,50 kr/md.). Beløbet er ekskl. moms og
lægges på det eksisterende abonnement.
2
Forbind den nye aftale
Når den nye aftale står klar (typisk efter få sekunder), klikker du
Forbind ud for den og indsætter den anden Webshipper-kontos kontonavn og
API-token.
3
Tilføj adressen i din AI
Hver aftale har sin egen adresse, fx
https://mcp.consile.ai/webshipper-2/mcp. Kopiér den med kopi-ikonet ud for
aftalen, og tilføj den som en ekstra connector i din AI.Hvad godkender jeg helt præcist?
Læs og skriv, med bekræftelse
Tokenet giver adgang til jeres Webshipper-konto. Consile ændrer kun noget, når
et skriveværktøj er bekræftet med
confirm: true, og en administrator kan
sætte brugere til Kun læsning. Se
Webshipper.Én konto pr. token
Hvert kald går til den Webshipper-konto, kontonavnet peger på. Intet opslag
kan nå en anden konto.
Krypteret pr. kunde
Tokenet gemmes krypteret med en nøgle, der kun gælder din egen konto. Det
logges aldrig og sendes kun til Webshipper.
Din AI ser det aldrig
Din AI får aldrig selve tokenet. Den modtager kun svar på dine spørgsmål.
Tokenets rettigheder. Har tokenet ikke adgang til et område i Webshipper, fx
forsendelser eller fragtpriser, godtages det alligevel, når du forbinder. De
værktøjer, der bruger området, fejler så med en forklarende besked. Opret et nyt
token i Webshipper med adgang til området, og forbind igen med det.
Træk adgangen tilbage
- I portalen: en administrator klikker på menuen (de tre prikker) ud for aftalen på kortet Forbindelser og bekræfter med Afbryd forbindelse. Så slettes det gemte token for aftalen hos Consile med det samme. Abonnementet fortsætter.
- Fjern en aftale: har I flere aftaler, vælger en administrator Fjern aftalen i samme menu og bekræfter med Fjern aftale. Det sletter aftalens token hos Consile og fjerner aftalen fra abonnementet. Fjerner du en anden aftale end den sidste på listen, rykker den sidste aftales forbindelse op på den ledige plads og får dens adresse. Tjek derfor bagefter adresserne i din AI. Den sidste aftale fjernes ved at opsige abonnementet under Abonnement.
- I Webshipper: tokenet udløber ikke af sig selv. Slet det under Indstillinger → Adgang & tokens, så holder det op med at virke med det samme. Din AI får derefter besked om, at Webshipper skal forbindes igen.
Hvis et opslag fejler
- “webshipper is not connected yet. Connect it here: …”: der er endnu ikke
gemt et token for denne aftale, eller den er afbrudt. Åbn linket (det virker i
10 minutter), eller forbind i portalen som beskrevet i trin 2. For en ekstra
aftale står der fx
webshipper-2i beskeden. - “Webshipper rejected the connection’s credential. Reconnect Webshipper in the Consile portal, then try again.”: Webshipper afviser tokenet, typisk fordi det er slettet i Webshipper. Opret et nyt token, og en administrator forbinder igen med det. En administrator kan også bede din AI på aftalens adresse om et nyt forbindelseslink. Det åbner formularen for netop den aftale, og det nye token erstatter det gamle.
- “Webshipper refused this request: the connected account does not have the permission or the licence it needs. …”: tokenet virker, men mangler adgang til det område, din AI spurgte om. Se noten om tokenets rettigheder ovenfor.
- “Webshipper is limiting how fast this connection may call it. …”: Webshipper tillader omkring 2 kald i sekundet pr. token. Vent et øjeblik, og spørg om mindre ad gangen.
- “Webshipper could not find what was asked for. …”: ordren, forsendelsen
eller det andet id findes ikke på kontoen. Bed din AI om at finde det med en
søgning først, fx
search_orders. Husk, at shoppens ordrenummer ikke er Webshippers id. - “Webshipper rejected the request: a value in it was not accepted.”: Webshipper har afvist en værdi i kaldet, fx en fragtmetode, der ikke hører til ordrekanalen. Ved en skrivning står der også Nothing was written.
- “The arguments were not accepted: …”: din AI har sendt et argument, som værktøjet ikke tager imod, fx en periode på mere end 92 dage. Beskeden nævner argumentet, og din AI retter normalt selv kaldet.
- “Webshipper did not answer or is having problems. …”: Webshipper svarede ikke i tide eller har driftsproblemer. Prøv igen om lidt.
- “The request was sent to Webshipper, but no usable answer came back, …”: udfaldet af en skrivning er ukendt. Tjek ordren eller forsendelsen i Webshipper, før du prøver igen, så du ikke booker eller opretter to gange.
- “Tool invocation failed.”: den generelle fejl for alt andet. Prøv igen, og afgræns spørgsmålet.
- Bliver det ved, så kontakt support@consile.dk med tidspunkt og det spørgsmål, du stillede.