En egendefinert tilkobling lar en organisasjonsadministrator registrere en HTTPS API eller, der det er aktivert, en Streamable HTTP MCP-server som ikke finnes i den innebygde katalogen. Den definerer nettverksgrensen og autentiseringsmetoden. Den genererer ikke automatisk en komplett API-referanse for agenten.
Hvem konfigurerer hva
- Org-administratorer oppretter, redigerer og sletter tilkoblingsdefinisjonen.
- Medlemmer kobler til sin egen hemmelighet eller fullfører tilkoblingens OAuth-flyt.
- Agentautorisasjon styrer hvilke agenter som kan bruke den tilkoblede legitimasjonen og hvilke navngitte tillatelser de får.
Definisjonen deles i organisasjonen. Medlemslegitimasjon forblir begrenset til medlemmet og organisasjonen.
HTTP API-tilkobling
- Åpne Tilkoblinger → Egendefinert og velg Ny tilkobling.
- Velg HTTP API og skriv inn et visningsnavn.
- Legg til én eller flere HTTPS-prefikser, én per linje. En forespørsel må samsvare med et konfigurert prefiks før tilkoblingen kan autorisere den.
- Legg til autentisering hvis API-et krever det:
- API-autentisering: skriv inn header-navn og en header-mal som inneholder
{{secret}}, for eksempelAuthorizationogBearer {{secret}}. - OAuth 2.0: skriv inn autorisasjons-URL, token-URL, klient-ID, klienthemmelighet, scopes og autentiseringsmetode for token-endepunkt. Registrer den eksakte omdirigerings-URL-en som vises i skjemaet hos leverandøren.
- API-autentisering: skriv inn header-navn og en header-mal som inneholder
- Opprett tilkoblingen. Hvert medlem som trenger den, velger deretter Koble til og oppgir sin hemmelighet eller fullfører OAuth.
- Autoriser nødvendig agent og tillatelser.
Endring av en eksisterende OAuth-definisjon eller dens klientlegitimasjon kobler fra nåværende OAuth-tilkoblinger. Medlemmer må koble til på nytt etter endringen.
MCP-tilkobling
Hvis MCP vises som en tilkoblingstype i arbeidsområdet ditt, skriv inn et HTTPS Streamable HTTP MCP-endepunkt og konfigurer API- eller OAuth-autentisering i samme skjema. Hvis MCP ikke tilbys i velgeren, er det ikke aktivert for det arbeidsområdet.
Lær agenten API-prosedyren
En egendefinert tilkobling gir sikker nettverkstilgang og injisering av legitimasjon. Opprettelsesskjemaet laster ikke opp eller oppdager automatisk et OpenAPI-dokument. Gi agenten endepunkt, metode, parametere og forventet respons i forespørselen, eller fang denne prosedyren i en arbeidsflyt med en API-referanse vedlagt som fil.
Valider en ny tilkobling med en smal, skrivebeskyttet forespørsel til et kjent endepunkt. Det finnes ingen generell Test tilkobling-forespørsel fordi mange API-er ikke har et meningsfullt rotendepunkt.
Sikkerhetsgrenser
- Kun HTTPS-prefikser og MCP-endepunkter aksepteres.
- Brannmuren injiserer den lagrede legitimasjonen kun i samsvarende forespørsler.
- Den lagrede hemmeligheten er kryptert i hvile og eksponeres ikke for agenten som en miljøvariabel.
- Ikke legg inn nøkler, tokens eller klienthemmeligheter i chatmeldinger, arbeidsflytinstruksjoner eller vedlagte filer.
- Bruk en tjenestelegitimasjon med minimum nødvendige upstream scopes for arbeidsflyten.
Feilsøking
| Problem | Sjekk |
|---|---|
| Ny tilkobling er utilgjengelig | Kun en org-administrator kan opprette eller redigere tilkoblingsdefinisjoner. |
| Agenten kan ikke se tilkoblingen | Koble den til for nåværende medlem, og autoriser deretter agenten. |
| Forespørselen blokkeres før den når API-et | Bekreft at forespørsels-URL-en starter med ett av de konfigurerte HTTPS-prefiksene. |
| API-et returnerer 401 eller 403 | Koble til medlemslegitimasjonen på nytt og verifiser upstream-nøkkel eller OAuth-scopes. |
| OAuth returnerer en omdirigeringsfeil | Registrer den eksakte omdirigerings-URL-en som vises i tilkoblingsskjemaet og verifiser autorisasjons- og token-URL-ene. |
| Agenten gjetter feil endepunkt eller payload | Legg API-prosedyren i en arbeidsflyt og legg ved relevant referanse i stedet for å kun stole på tilkoblingsnavnet. |
Hva skjer videre
- Se Arbeidsflyter for å fange gjentatt arbeid med egendefinerte tilkoblinger.
- Se Tillatelser for hvordan legitimasjon for egendefinerte tilkoblinger håndteres.
- Se Katalogen før du bygger egendefinert — tjenesten din kan allerede være støttet.
