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
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.
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: Adgangstokens udløber efter ca. 1 time og fornys automatisk. Efter 30 dage skal du logge ind igen.
- Afbryd når som helst: Fjern connectoren i din AI-klient, eller log ud af AgentBase, for at afbryde forbindelsen.
- HTTPS kræves: Adgangstokenet sendes med hver forespørgsel, så forbindelsen kører altid over TLS.
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).