> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 커스텀 커넥터

> Pro 및 Enterprise 고객이 커스텀 API 커넥터를 만들고 인증을 구성하며 Replit 라이브러리에 없는 외부 서비스의 엔드포인트를 테스트하는 방법을 알아보세요.

커스텀 커넥터를 사용하면 Pro 및 Enterprise 고객이 Replit의
[통합 라이브러리](/ko/features/integrations/overview)에 없는 지원 API에 연결할 수 있습니다.
퍼스트파티 커넥터를 기다리지 않고도 전문화된 서비스에 연결할 때 사용하세요.

커스텀 커넥터는 개인 계정이 아닌 워크스페이스에 추가됩니다.
권한이 부여된 워크스페이스 관리자가 이를 생성하고 관리할 수 있습니다.

<Note>
  커스텀 커넥터는 베타 버전이며 Enterprise 고객만 사용할 수 있습니다.
  워크스페이스 관리자가 이를 생성하고 관리할 수 있습니다.
</Note>

## 시작하기 전에

다음을 준비하세요:

* 활성화된 Pro 또는 Enterprise 구독과 워크스페이스에서 커넥터를 관리할 수 있는 권한.
* 공개적으로 액세스 가능한 HTTPS REST API와 해당 기본 URL.
* API의 자격 증명 및 해당 문서에 대한 액세스 권한.
* 선택 사항으로, 연결을 테스트하는 데 사용할 수 있는 읽기 전용 엔드포인트.

커스텀 API 커넥터는 커스텀 [MCP 서버](/ko/features/mcp/overview)와 다릅니다.
API에는 **커스텀 커넥터 추가**를 사용하세요. 같은 메뉴에 있는 MCP 서버 옵션은
별도의 설정 흐름입니다.

<Warning>
  신뢰하는 API에만 데이터를 연결하세요. 자격 증명은 커넥터 설명이나
  Agent 지침에 포함하지 마세요. 인증 필드에만 입력하세요.
</Warning>

## 커스텀 커넥터 만들기

<Steps>
  <Step title="커스텀 커넥터 양식 열기">
    Enterprise 워크스페이스 사이드바에서 **Integrations**를 선택합니다. **Add custom**을
    연 다음 **Add custom connector**를 선택합니다.

    <Frame>
      <img src="https://mintcdn.com/replit/UBZvDR_D82VVmneQ/images/connectors/custom-connectors/add-custom-connector.png?fit=max&auto=format&n=UBZvDR_D82VVmneQ&q=85&s=fe6d895207b33622e9e5be3310900fd0" alt="Add custom 메뉴가 열려 있고 MCP 서버 옵션 아래에 Add custom connector가 표시된 Integrations 페이지" width="1716" height="1177" data-path="images/connectors/custom-connectors/add-custom-connector.png" />
    </Frame>
  </Step>

  <Step title="API 설명하기">
    다음 필드를 작성합니다:

    | 필드                     | 입력할 내용                                              | 예시                                                                   |
    | ---------------------- | --------------------------------------------------- | -------------------------------------------------------------------- |
    | **Connector name**     | 서비스를 식별할 수 있는 이름.                                   | `Acme API`                                                           |
    | **Description**        | API가 하는 일에 대한 간단한 설명.                               | `Create and track customer orders`                                   |
    | **Base URL**           | 필요한 버전 접두사를 포함한 API의 루트 URL.                        | `https://api.example.com`                                            |
    | **Agent instructions** | 문서 URL 및 엔드포인트 규칙 등 API 사용에 대한 안내. 자격 증명은 포함하지 마세요. | `Read https://api.example.com/docs. Use GET /orders to list orders.` |

    예시 값을 사용 중인 서비스에 맞는 값으로 바꾸세요. Agent instructions는
    500자 제한이 있습니다.

    <Frame>
      <img src="https://mintcdn.com/replit/UBZvDR_D82VVmneQ/images/connectors/custom-connectors/create-custom-connector.png?fit=max&auto=format&n=UBZvDR_D82VVmneQ&q=85&s=97a0463c8c54c3837f2884fbc37ccd01" alt="이름, 설명, 기본 URL, Agent instructions, bearer 인증, 선택적 엔드포인트 테스트를 보여주는 커스텀 API 커넥터 생성 양식" width="1716" height="1177" data-path="images/connectors/custom-connectors/create-custom-connector.png" />
    </Frame>
  </Step>

  <Step title="인증 구성하기">
    API에 맞는 인증 방식을 선택하고 표시된 필드를 작성합니다.

    bearer 토큰을 사용하는 API의 경우 **Bearer token**을 선택하고 `Bearer` 접두사
    없이 토큰을 입력합니다. Replit이 요청을 보낼 때 접두사를 추가합니다.
  </Step>

  <Step title="엔드포인트 테스트하기">
    선택적으로 **Endpoint test**에 `/health`와 같은 경로를 입력하고
    **Check**를 선택합니다.

    이 확인은 저장하기 전에 GET 요청 하나를 보냅니다. 그 결과는 저장되지 않습니다.
    데이터를 변경하지 않는, API가 지원하는 엔드포인트를 선택하세요.

    확인이 성공했다는 것은 필요할 수 있는 모든 엔드포인트나 권한이 아니라
    해당 요청만 확인했다는 의미입니다.
  </Step>

  <Step title="커넥터 저장하기">
    구성을 검토한 다음 **Save**를 선택합니다.
  </Step>
</Steps>

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

테스트가 실패하면 API 문서를 기준으로 다음을 확인하세요:

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

## 관련 문서

* [Agent 통합](/ko/features/integrations/overview) — 지원되는 통합 살펴보기
* [커넥터 관리](/ko/replitai/managing-connectors) — 워크스페이스의 커넥터 관리