Vlastní konektor umožňuje správci organizace zaregistrovat HTTPS API nebo, kde je povoleno, Streamable HTTP MCP server, který není v předdefinovaném katalogu. Konektor definuje síťovou hranici a způsob ověření. Automaticky nevytváří kompletní API referenci pro agenta.
Kdo co nastavuje
- Správci organizace vytvářejí, upravují a mažou definici konektoru.
- Členové připojují svůj vlastní tajný klíč nebo dokončují OAuth proces konektoru.
- Autorizace agenta určuje, kteří agenti mohou použít připojené údaje a jaká pojmenovaná oprávnění získají.
Definice je sdílena v rámci organizace. Údaje členů zůstávají omezeny na člena a organizaci.
HTTP API konektor
- Otevřete Konektory → Vlastní a zvolte Nový konektor.
- Vyberte HTTP API a zadejte zobrazovaný název.
- Přidejte jeden nebo více HTTPS Prefixů, každý na samostatný řádek. Požadavek musí odpovídat nastavenému prefixu, aby jej konektor mohl autorizovat.
- Přidejte ověření, pokud jej API vyžaduje:
- API ověření: zadejte název hlavičky a šablonu hlavičky obsahující
{{secret}}, napříkladAuthorizationaBearer {{secret}}. - OAuth 2.0: zadejte autorizační URL, token URL, client ID, client secret, scopes a způsob ověření token-endpointu. U poskytovatele zaregistrujte přesně tu přesměrovací URL, která je zobrazena ve formuláři.
- API ověření: zadejte název hlavičky a šablonu hlavičky obsahující
- Vytvořte konektor. Každý člen, který jej potřebuje, poté zvolí Připojit a zadá svůj tajný klíč nebo dokončí OAuth.
- Autorizujte požadovaného agenta a oprávnění.
Změna existující OAuth definice nebo jejích klientských údajů odpojí aktuální OAuth připojení. Členové se musí po změně znovu připojit.
MCP konektor
Pokud se ve vašem pracovním prostoru objeví MCP jako typ konektoru, zadejte HTTPS Streamable HTTP MCP endpoint a nastavte API nebo OAuth ověření ve stejném formuláři. Pokud MCP není v nabídce, není pro tento workspace povolen.
Naučte agenta postup API
Vlastní konektor poskytuje bezpečný síťový přístup a vložení údajů. Formulář nevkládá ani automaticky nevyhledává OpenAPI dokument. Uveďte agentovi endpoint, metodu, parametry a očekávanou odpověď v požadavku, nebo tento postup zachyťte v workflow s přiloženou API referencí jako soubor.
Ověřte nový konektor úzkým, pouze pro čtení určeným požadavkem na známý endpoint. Neexistuje obecný požadavek Testovat připojení, protože mnoho API nemá smysluplný kořenový endpoint.
Bezpečnostní hranice
- Jsou akceptovány pouze HTTPS prefixy a MCP endpointy.
- Firewall vkládá uložené údaje pouze do odpovídajících požadavků.
- Uložený tajný klíč je šifrován v klidu a není agentovi zpřístupněn jako proměnná prostředí.
- Nevkládejte klíče, tokeny ani client secret do chatovacích zpráv, instrukcí workflow nebo přiložených souborů.
- Používejte služební údaje s minimálními potřebnými scopes pro workflow.
Řešení problémů
| Problém | Kontrola |
|---|---|
| Nový konektor není dostupný | Pouze správce organizace může vytvářet nebo upravovat definice konektorů. |
| Agent nevidí konektor | Připojte jej pro aktuálního člena a poté autorizujte daného agenta. |
| Požadavek je zablokován před dosažením API | Ověřte, že URL požadavku začíná jedním z nastavených HTTPS prefixů. |
| API vrací 401 nebo 403 | Znovu připojte členské údaje a ověřte upstream klíč nebo OAuth scopes. |
| OAuth vrací chybu přesměrování | Zaregistrujte přesně tu přesměrovací URL, která je zobrazena ve formuláři konektoru, a ověřte autorizační a token URL. |
| Agent hádá špatný endpoint nebo payload | Zadejte postup API do workflow a přiložte relevantní referenci místo spoléhání na samotný název konektoru. |
