Anpassade kopplingar

En anpassad koppling låter en organisationsadministratör registrera ett HTTPS API eller, där det är aktiverat, en Streamable HTTP MCP-server som inte finns i den inbyggda katalogen. Den definierar nätverksgränsen och autentiseringsmetoden. Den genererar inte automatiskt en komplett API-referens för agenten.

Vem konfigurerar vad

Organisationsadministratörer skapar, redigerar och tar bort kopplingsdefinitionen.
Medlemmar ansluter sin egen autentiseringsuppgift eller slutför kopplingens OAuth-flöde.
Agentauktorisering styr vilka agenter som kan använda den anslutna autentiseringsuppgiften och vilka namngivna behörigheter de får.

Definitionen delas inom organisationen. Medlemsuppgifter förblir begränsade till medlemmen och organisationen.

HTTP API-koppling

Öppna Kopplingar → Anpassad och välj Ny koppling.
Välj HTTP API och ange ett visningsnamn.
Lägg till en eller flera HTTPS-Prefix, en per rad. En begäran måste matcha ett konfigurerat prefix innan kopplingen kan auktorisera den.
Lägg till autentisering om API:et kräver det:
- API-autentisering: ange rubriknamnet och en rubrikmall som innehåller {{secret}}, till exempel Authorization och Bearer {{secret}}.
- OAuth 2.0: ange auktoriserings-URL, token-URL, klient-ID, klienthemlighet, scopes och autentiseringsmetod för token-endpoint. Registrera exakt den omdirigerings-URL som visas i formuläret hos leverantören.
Skapa kopplingen. Varje medlem som behöver den väljer sedan Anslut och anger sin hemlighet eller slutför OAuth.
Auktorisera den nödvändiga agenten och behörigheterna.

Att ändra en befintlig OAuth-definition eller dess klientuppgifter kopplar bort aktuella OAuth-anslutningar. Medlemmar måste ansluta igen efter ändringen.

MCP-koppling

Om MCP visas som en kopplingstyp i din arbetsyta, ange en HTTPS Streamable HTTP MCP-endpoint och konfigurera API- eller OAuth-autentisering i samma formulär. Om MCP inte erbjuds i urvalet är det inte aktiverat för den arbetsytan.

Lär agenten API-proceduren

En anpassad koppling tillhandahåller säker nätverksåtkomst och uppgiftsinjektion. Skapandeformuläret laddar inte upp eller upptäcker automatiskt ett OpenAPI-dokument. Ge agenten endpoint, metod, parametrar och förväntat svar i begäran, eller fånga proceduren i ett arbetsflöde med en API-referens bifogad som fil.

Validera en ny koppling med en smal, skrivskyddad begäran till en känd endpoint. Det finns ingen generell Testa anslutning-begäran eftersom många API:er inte exponerar en meningsfull rot-endpoint.

Säkerhetsgränser

Endast HTTPS-prefix och MCP-endpoints accepteras.
Brandväggen injicerar den sparade autentiseringsuppgiften endast i matchande begäranden.
Den sparade hemligheten är krypterad i vila och exponeras inte för agenten som en miljövariabel.
Lägg inte in nycklar, tokens eller klienthemligheter i chattmeddelanden, arbetsflödesinstruktioner eller bifogade filer.
Använd en tjänsteautentiseringsuppgift med minsta möjliga upstream-scopes som arbetsflödet kräver.

Felsökning

Problem	Kontrollera
Ny koppling är inte tillgänglig	Endast en organisationsadministratör kan skapa eller redigera kopplingsdefinitioner.
Agenten kan inte se kopplingen	Anslut den för aktuell medlem och auktorisera sedan agenten.
Begäran blockeras innan den når API:et	Kontrollera att begärans URL börjar med ett av de konfigurerade HTTPS-prefixen.
API:et returnerar 401 eller 403	Återanslut medlemsuppgiften och verifiera upstream-nyckeln eller OAuth-scopes.
OAuth returnerar ett omdirigeringsfel	Registrera exakt den omdirigerings-URL som visas i kopplingsformuläret och verifiera auktoriserings- och token-URL:erna.
Agenten gissar fel endpoint eller payload	Lägg API-proceduren i ett arbetsflöde och bifoga relevant referens istället för att bara lita på kopplingsnamnet.

Vad händer härnäst

Se Arbetsflöden för att fånga upprepade arbetsuppgifter med anpassad koppling.
Se Behörigheter för hur uppgifter för anpassade kopplingar hanteras.
Se Katalogen innan du bygger anpassat — din tjänst kan redan stödjas.