Forbind AI-assistenter (MCP)
Du kan forbinde AgentBase til eksterne AI-assistenter som Claude og ChatGPT, så assistenten kan bygge og køre dine flows for dig — med dine egne rettigheder. Forbindelsen sker via MCP (Model Context Protocol) over en sikker OAuth-login.
Denne side forklarer, hvordan forbindelsen fungerer. De klientspecifikke trin står på egne sider:
- Forbind Claude (Claude-appen på web og desktop — ikke Claude Code)
- Forbind ChatGPT
Adgang
- Udvikler, Administrator, Superadministrator: Kan bygge og køre flows via MCP.
- Anmelder, Bruger: Assistenten arbejder med din rolles rettigheder. Har du ikke rettigheder til at oprette flows i brugerfladen, kan assistenten det heller ikke (du får en 403-fejl fra AgentBase — præcis som i webappen).
MCP-laget giver ingen ekstra rettigheder: hvert kald kører som dig, med din organisations, dit teams og din rolles afgrænsninger.
Serveradresse
Tilføj denne adresse som en connector i din AI-klient:
https://api.agentbase.dk/mcp
Du behøver ikke skrive adressen af. Du finder den også inde i AgentBase: menupunktet Udviklerværktøjer i sidemenuen (vises kun, hvis din rolle er Udvikler, Administrator eller Superadministrator) → afsnittet Forbind AI-assistenter → kortet MCP-endpoint. Tryk Kopiér adresse, og indsæt den i din AI-klient.
Samme kort rummer korte trinlister for Claude og ChatGPT samt en færdig kommando til Claude Code med knappen Kopiér kommando.
Claude og ChatGPT omdøber jævnligt deres menuer. Ændrer trinnene sig, skal både kortet i AgentBase og disse sider rettes samtidig, så de to steder ikke siger noget forskelligt.
Kører du din egen AgentBase-installation, skal du bruge din backends offentlige adresse efterfulgt af /mcp (f.eks. https://api.din-organisation.dk/mcp). Adressen skal være tilgængelig over HTTPS fra internettet — Claude og ChatGPT forbinder fra deres egen sky, ikke fra din computer.
Sådan logger du ind
Du skal ikke kopiere en token eller API-nøgle. Når du har tilføjet adressen, kører klienten selv OAuth-login:
- Klienten registrerer sig automatisk hos AgentBase (du behøver ikke udfylde et "OAuth Client ID").
- Et browservindue åbner AgentBase, hvor du logger ind som normalt (hvis du ikke allerede er logget ind).
- Du lander på samtykkeskærmen "Giv adgang".
- Du godkender, og klienten er forbundet.
Samtykkeskærmen "Giv adgang"
Skærmen viser, hvem der beder om adgang, og hvad du giver adgang til:
- Hvem: Navnet på klienten (f.eks. ChatGPT eller Claude), og at adgangen gives som din konto (din e-mail).
- Hvad: Klienten kan bygge og køre dine flows via AgentBase MCP med dine egne rettigheder.
- Hvorhen: "Du sendes tilbage til …" viser den adresse (host), koden leveres til — så du kan se, hvor adgangen ender.
- Advarsel om ikke-verificeret applikation: Fordi klienter registrerer sig selv automatisk, viser AgentBase altid en "Ikke-verificeret applikation"-advarsel. Det er forventet. Godkend kun, hvis du selv har sat forbindelsen op og genkender destinationen ovenfor.
Vælg Godkend for at give adgang, eller Afvis for at afbryde.
Samtykkeskærmen giver en AI-assistent adgang til at handle på din konto. Godkend aldrig en anmodning, du ikke selv har startet.
Hvad kan assistenten gøre?
Når AgentBase er forbundet, kan assistenten bl.a.:
- Udforske byggeklodser: Slå de tilgængelige node-typer op med deres ind- og udgange.
- Liste teams og agenter: Se de teams og flows, du har adgang til.
- Bygge flows: Oprette en ny agent (som kladde) og bygge grafen — enten på én gang eller node for node.
- Vedhæfte filer til et fil-input, før flowet køres.
- Køre flows: Køre en gemt agent, et ad hoc-flow, en enkelt node eller mange testcases på én gang.
- Inspicere kørsler: Hente ind- og udgange samt fejl for en kørsel for at fejlfinde.
- Beskrive og redigere appens felter: Se og ændre, hvilke oplysninger flowet beder om, og hvilke resultater det giver tilbage.
- Udgive flowet som byggeklods: Gøre flowet til en node, andre flows kan bruge. Felterne skal være sat op først — ellers afvises udgivelsen. Det udgiver ikke en app i Galleriet; det er stadig en menneskelig handling.
- Fastlåse og frigive et resultat på en node: Fryse det, en dyr node har produceret, så den ikke køres igen, mens der bygges videre på resten af flowet.
- Læse et stort resultat stykkevis: Hente et langt output i bidder eller søge i det, når det er for stort til at komme med i svaret.
- Slette et flow: Kun kladder og arkiverede flows — og aldrig et flow, der bruges i andre flows, har apps eller har historik fra kvalitetskontrollen.
Et fastlåst resultat bruges kun i editoren og i assistentens egne kørsler af det gemte flow. Udgivne apps, webhooks, planlagte kørsler og indlejrede widgets kører altid noden rigtigt — så et fastlåst resultat kan aldrig snige sig ind i det, dine brugere ser.
Alt sker som dig — så en assistent kan ikke se eller ændre noget, du ikke selv har adgang til.
Sikkerhed
- Kører som dig: Assistenten arver din rolle og dine team-/organisationsgrænser.
- Kortlivede tokens: Adgangstokenet udløber efter ca. 1 time og fornys automatisk. Fornyelsesnøglen udskiftes ved hver fornyelse og får hver gang nye 30 dage, så du skal kun logge ind igen, hvis forbindelsen har været ubrugt i 30 dage — eller hvis en fornyelse går galt, for da spærrer AgentBase hele kæden af sikkerhedshensyn.
- Afbryd i din AI-klient: Fjern connectoren i Claude eller ChatGPT for at afbryde forbindelsen.
- Sletning er begrænset: Assistenten kan kun slette kladder og arkiverede flows — aldrig et flow, der er i brug i andre flows, har apps eller har historik fra kvalitetskontrollen.
- HTTPS kræves: Adgangstokenet sendes med hver forespørgsel, så forbindelsen kører altid over TLS.
Når du logger ud af AgentBase, ryddes kun din egen browser. En forbundet AI-assistent har sin egen adgang og fortsætter uændret. AgentBase har hverken en oversigt over forbundne assistenter eller en knap, der trækker adgangen tilbage — den eneste måde at stoppe adgangen på er at fjerne connectoren i din AI-klient. Gør du ikke det, løber adgangen, indtil fornyelsesnøglen udløber (se ovenfor).
Fejlfinding
| Problem | Årsag | Løsning |
|---|---|---|
| "Couldn't register …" / registrering mislykkes | Serverens API_BASE_URL er ikke sat til den offentlige adresse, så OAuth-serveren annoncerer en forkert (f.eks. localhost) adresse | Kontakt din AgentBase-administrator. Du skal ikke selv udfylde et Client ID — det løser ikke problemet. |
| "scope Input should be a valid string" (ChatGPT) | Serveren kører en ældre AgentBase-version, der svarede "scope": null ved registrering | Opdatér AgentBase. Se Forbind ChatGPT. |
| 401 / "token invalid or expired" | Adgangstokenet er udløbet eller ugyldigt | Fjern connectoren og forbind igen, så klienten henter nye tokens |
| Forbindelsen timer ud på lange flows | Flowet kører længere end klientens tidsgrænse | Kør et mindre flow, eller bed assistenten hæve tidsgrænsen for kørslen |
| Klienten kan ikke nå serveren | Serveren er ikke offentligt tilgængelig (privat netværk/VPN/firewall) | Brug en offentlig HTTPS-adresse — Claude/ChatGPT forbinder fra deres egen sky |
Tidligere kunne man indsætte en rå AgentBase-token som Authorization: Bearer. Det er ikke længere muligt — forbind via OAuth i stedet (som beskrevet ovenfor).