Met een aangepaste connector kan een org-beheerder een HTTPS API of, indien ingeschakeld, een Streamable HTTP MCP-server registreren die niet in de ingebouwde catalogus staat. Hiermee wordt de netwerkgrens en de authenticatiemethode gedefinieerd. Het genereert niet automatisch een volledige API-referentie voor de agent.
Wie configureert wat
- Org-beheerders maken, bewerken en verwijderen de connector-definitie.
- Leden koppelen hun eigen geheim of voltooien de OAuth-flow van de connector.
- Agent-autorisatie bepaalt welke agents de gekoppelde referentie mogen gebruiken en welke benoemde rechten zij ontvangen.
De definitie wordt gedeeld binnen de organisatie. Referenties van leden blijven gekoppeld aan het lid en de organisatie.
HTTP API-connector
- Open Connectors → Custom en kies Nieuwe connector.
- Selecteer HTTP API en voer een weergavenaam in.
- Voeg een of meer HTTPS-prefixen toe, één per regel. Een verzoek moet overeenkomen met een geconfigureerde prefix voordat de connector het kan autoriseren.
- Voeg authenticatie toe als de API dit vereist:
- API-authenticatie: voer de headernaam en een header-sjabloon in met
{{secret}}, bijvoorbeeldAuthorizationenBearer {{secret}}. - OAuth 2.0: voer de autorisatie-URL, token-URL, client-ID, clientgeheim, scopes en authenticatiemethode voor het token-endpoint in. Registreer de exacte redirect-URL die in het formulier wordt getoond bij de provider.
- API-authenticatie: voer de headernaam en een header-sjabloon in met
- Maak de connector aan. Elk lid dat deze nodig heeft, kiest vervolgens Verbinden en levert zijn geheim aan of voltooit OAuth.
- Autoriseer de benodigde agent en rechten.
Het wijzigen van een bestaande OAuth-definitie of de clientreferenties verbreekt bestaande OAuth-verbindingen. Leden moeten na de wijziging opnieuw verbinden.
MCP-connector
Als MCP als connectortype in uw werkruimte verschijnt, voer dan een HTTPS Streamable HTTP MCP-endpoint in en configureer API- of OAuth-authenticatie in hetzelfde formulier. Als MCP niet wordt aangeboden in de keuzelijst, is het niet ingeschakeld voor die werkruimte.
Leer de agent de API-procedure
Een aangepaste connector biedt veilige netwerktoegang en het injecteren van referenties. Het aanmaakformulier uploadt of ontdekt geen OpenAPI-document automatisch. Geef de agent het endpoint, de methode, parameters en verwachte respons in het verzoek, of leg die procedure vast in een workflow met een API-referentie als bijlage.
Valideer een nieuwe connector met een beperkt, alleen-lezen verzoek naar een bekend endpoint. Er is geen generiek Test verbinding-verzoek omdat veel API's geen zinvol root-endpoint aanbieden.
Beveiligingsgrenzen
- Alleen HTTPS-prefixen en MCP-endpoints worden geaccepteerd.
- De firewall injecteert de opgeslagen referentie alleen in overeenkomende verzoeken.
- Het opgeslagen geheim wordt versleuteld opgeslagen en wordt niet als omgevingsvariabele aan de agent blootgesteld.
- Plaats geen sleutels, tokens of clientgeheimen in chatberichten, workflow-instructies of bijgevoegde bestanden.
- Gebruik een service-referentie met de minimale upstream-scopes die de workflow nodig heeft.
Problemen oplossen
| Probleem | Controleren |
|---|---|
| Nieuwe connector is niet beschikbaar | Alleen een org-beheerder kan connector-definities maken of bewerken. |
| De agent ziet de connector niet | Koppel deze voor het huidige lid en autoriseer vervolgens die agent. |
| Het verzoek wordt geblokkeerd voordat het de API bereikt | Controleer of de request-URL begint met een van de geconfigureerde HTTPS-prefixen. |
| De API retourneert 401 of 403 | Verbind de ledenreferentie opnieuw en controleer de upstream-sleutel of OAuth-scopes. |
| OAuth retourneert een redirect-fout | Registreer de exacte redirect-URL uit het connectorformulier en controleer de autorisatie- en token-URL's. |
| De agent raadt het verkeerde endpoint of payload | Zet de API-procedure in een workflow en voeg de relevante referentie toe in plaats van alleen op de connectornaam te vertrouwen. |
