사용자 지정 커넥터

사용자 지정 커넥터를 사용하면 조직 관리자가 내장 카탈로그에 없는 HTTPS API 또는 (활성화된 경우) Streamable HTTP MCP 서버를 등록할 수 있습니다. 네트워크 경계와 인증 방식을 정의합니다. 에이전트를 위한 완전한 API 참조를 자동 생성하지는 않습니다.

누가 무엇을 구성하는가

• 조직 관리자는 커넥터 정의를 만들고 편집하고 삭제합니다.
• 멤버는 자신의 시크릿을 연결하거나 커넥터의 OAuth 플로우를 완료합니다.
• 에이전트 권한 부여는 어떤 에이전트가 연결된 자격 증명을 사용할 수 있고 어떤 이름 지정 권한을 받는지 제어합니다.

정의는 조직 내에서 공유됩니다. 멤버 자격 증명은 멤버와 조직으로 제한됩니다.

HTTP API 커넥터

1. Connectors → Custom을 열고 New connector를 선택합니다.
2. HTTP API를 선택하고 표시 이름을 입력합니다.
3. HTTPS Prefixes를 한 줄에 하나씩 추가합니다. 요청이 구성된 접두사와 일치해야 커넥터가 승인할 수 있습니다.
4. API에 인증이 필요하면 추가합니다:
   • API authentication: 헤더 이름과 {{secret}}이 포함된 헤더 템플릿을 입력합니다(예: Authorization과 Bearer {{secret}}).
   • OAuth 2.0: 인증 URL, 토큰 URL, 클라이언트 ID, 클라이언트 시크릿, 스코프, 토큰 엔드포인트 인증 방식을 입력합니다. 양식에 표시된 정확한 리다이렉트 URL을 프로바이더에 등록합니다.
5. 커넥터를 만듭니다. 필요한 각 멤버는 Connect를 선택하고 시크릿을 제공하거나 OAuth를 완료합니다.
6. 필요한 에이전트와 권한을 승인합니다.

기존 OAuth 정의나 클라이언트 자격 증명을 변경하면 현재 OAuth 연결이 끊깁니다. 변경 후 멤버가 다시 연결해야 합니다.

MCP 커넥터

워크스페이스에서 커넥터 유형으로 MCP가 표시되면 HTTPS Streamable HTTP MCP 엔드포인트를 입력하고 같은 양식에서 API 또는 OAuth 인증을 구성합니다. 선택기에 MCP가 제공되지 않으면 그 워크스페이스에 활성화되지 않은 것입니다.

에이전트에게 API 절차 가르치기

사용자 지정 커넥터는 안전한 네트워크 액세스와 자격 증명 주입을 제공합니다. 생성 양식은 OpenAPI 문서를 업로드하거나 자동 탐지하지 않습니다. 요청에서 엔드포인트, 메서드, 매개변수, 예상 응답을 에이전트에 주거나, API 참조를 파일로 첨부한 워크플로에 그 절차를 기록하세요.

새 커넥터는 알려진 엔드포인트에 대한 좁은 읽기 전용 요청으로 검증하세요. 많은 API가 의미 있는 루트 엔드포인트를 노출하지 않으므로 범용 Test connection 요청은 없습니다.

보안 경계

• HTTPS 접두사와 MCP 엔드포인트만 허용됩니다.
• 방화벽은 일치하는 요청에만 저장된 자격 증명을 주입합니다.
• 저장된 시크릿은 저장 시 암호화되며 환경 변수로 에이전트에 노출되지 않습니다.
• 키, 토큰, 클라이언트 시크릿을 채팅 메시지, 워크플로 인스트럭션, 첨부 파일에 넣지 마세요.
• 워크플로에 필요한 최소 업스트림 스코프를 가진 서비스 자격 증명을 사용하세요.

문제 해결

다음

• 반복적인 사용자 지정 커넥터 작업 기록은 Workflows 참조.
• 사용자 지정 커넥터 자격 증명 처리 방식은 Permissions 참조.
• 직접 만들기 전에 Catalog 확인. 이미 지원되는 서비스일 수 있습니다.