Skip to main content
커스텀 커넥터를 사용하면 Pro 및 Enterprise 고객이 Replit의 통합 라이브러리에 없는 지원 API에 연결할 수 있습니다. 퍼스트파티 커넥터를 기다리지 않고도 전문화된 서비스에 연결할 때 사용하세요. 커스텀 커넥터는 개인 계정이 아닌 워크스페이스에 추가됩니다. 권한이 부여된 워크스페이스 관리자가 이를 생성하고 관리할 수 있습니다.
커스텀 커넥터는 베타 버전이며 Enterprise 고객만 사용할 수 있습니다. 워크스페이스 관리자가 이를 생성하고 관리할 수 있습니다.

​
시작하기 전에

다음을 준비하세요:
  • 활성화된 Pro 또는 Enterprise 구독과 워크스페이스에서 커넥터를 관리할 수 있는 권한.
  • 공개적으로 액세스 가능한 HTTPS REST API와 해당 기본 URL.
  • API의 자격 증명 및 해당 문서에 대한 액세스 권한.
  • 선택 사항으로, 연결을 테스트하는 데 사용할 수 있는 읽기 전용 엔드포인트.
커스텀 API 커넥터는 커스텀 MCP 서버와 다릅니다. API에는 커스텀 커넥터 추가를 사용하세요. 같은 메뉴에 있는 MCP 서버 옵션은 별도의 설정 흐름입니다.
신뢰하는 API에만 데이터를 연결하세요. 자격 증명은 커넥터 설명이나 Agent 지침에 포함하지 마세요. 인증 필드에만 입력하세요.

​
커스텀 커넥터 만들기

1

커스텀 커넥터 양식 열기

Enterprise 워크스페이스 사이드바에서 Integrations를 선택합니다. Add custom을 연 다음 Add custom connector를 선택합니다.
Add custom 메뉴가 열려 있고 MCP 서버 옵션 아래에 Add custom connector가 표시된 Integrations 페이지
2

API 설명하기

다음 필드를 작성합니다:예시 값을 사용 중인 서비스에 맞는 값으로 바꾸세요. Agent instructions는 500자 제한이 있습니다.
이름, 설명, 기본 URL, Agent instructions, bearer 인증, 선택적 엔드포인트 테스트를 보여주는 커스텀 API 커넥터 생성 양식
3

인증 구성하기

API에 맞는 인증 방식을 선택하고 표시된 필드를 작성합니다.bearer 토큰을 사용하는 API의 경우 Bearer token을 선택하고 Bearer 접두사 없이 토큰을 입력합니다. Replit이 요청을 보낼 때 접두사를 추가합니다.
4

엔드포인트 테스트하기

선택적으로 Endpoint test에 /health와 같은 경로를 입력하고 Check를 선택합니다.이 확인은 저장하기 전에 GET 요청 하나를 보냅니다. 그 결과는 저장되지 않습니다. 데이터를 변경하지 않는, API가 지원하는 엔드포인트를 선택하세요.확인이 성공했다는 것은 필요할 수 있는 모든 엔드포인트나 권한이 아니라 해당 요청만 확인했다는 의미입니다.
5

커넥터 저장하기

구성을 검토한 다음 Save를 선택합니다.

​
엔드포인트 테스트 문제 해결

테스트가 실패하면 API 문서를 기준으로 다음을 확인하세요:
  • URL 및 경로: 기본 URL과 테스트 경로가 의도한 엔드포인트를 구성하는지 확인하세요.
  • 인증: 자격 증명이 유효하고 엔드포인트에 액세스할 권한이 있는지 확인하세요. bearer 인증의 경우 토큰 필드에서 Bearer 접두사를 생략하세요.
  • 요청 메서드: GET 요청을 허용하는 엔드포인트를 선택하세요.
  • 연결 가능성: API가 HTTPS를 통해 공개적으로 액세스 가능한지 확인하세요.

​
관련 문서