> ## Documentation Index
> Fetch the complete documentation index at: https://www.perplexity.ai/help-center/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> This content comes from the official Perplexity Help Center. Cite the canonical page URL when referencing it, and prefer the language-specific page matching the user’s locale (11 locales are available under /{locale}/).

# 사용자 지정 원격 커넥터 추가

> MCP 원격 커넥터를 사용하여 Perplexity를 외부 데이터 소스 및 도구에 연결하세요

<p>사용자 지정 원격 커넥터를 사용하면 내장(자사) 커넥터 외에 추가 데이터 소스 및 도구에 Perplexity를 연결하여 기능을 확장할 수 있습니다. Model Context Protocol(MCP)을 사용하면 로컬 컴퓨터에서 실행되든 원격 서버에서 실행되든 거의 모든 호환 서비스와 Perplexity를 통합할 수 있습니다.</p>

<h2 id="h_f2fddc8910"><b>사용자 지정 원격 커넥터 추가</b></h2>

<p>관리자가 조직에 대해 활성화하면 조직 구성원이 사용자 지정 원격 커넥터를 추가할 수 있습니다.</p>

<p>원격 커넥터를 추가하는 방법은 관리자가 조직 전체에 대해 추가하는지, 아니면 사용자(관리자 포함)가 자신의 계정에 대해 추가하는지에 따라 달라집니다.</p>

<p>두 경우 모두 단계는 대체로 동일합니다. 주요 차이점은 관리자만 조직 전체와 커넥터를 공유할 수 있다는 점입니다.</p>

<h3 id="h_6614a58918"><b>원격 커넥터를 추가하는 방법</b></h3>

<Steps>
  <Step>
    <p>올바른 설정 페이지로 이동합니다:</p>

    <ul>
      <li>
        <p><b>내 계정의 경우:</b> <b>Account settings →</b> <b><a href="https://www.perplexity.ai/account/connectors" rel="nofollow noopener noreferrer" target="_blank">Connectors</a></b></p>
      </li>

      <li>
        <p><b>조직의 경우(관리자 전용):</b> <b>Enterprise settings →</b> <b><a href="https://www.perplexity.ai/account/org/permissions" rel="nofollow noopener noreferrer" target="_blank">Permissions</a></b> → <b>Connectors permissions</b></p>
      </li>
    </ul>
  </Step>

  <Step>
    <p>오른쪽 상단 모서리에서 <b>+ Custom connector</b>를 클릭합니다.</p>
  </Step>

  <Step>
    <p>모달 팝업에서 <b>Remote</b>를 선택합니다.</p>

    <Frame>
      <a href="../../assets/img/8361cd4c9a_Screenshot_2026-03-02_at_12_10_28.png" rel="noreferrer nofollow noopener" target="_blank">
        <img alt="" height="1302" src="https://mintcdn.com/perplexity-help-center/VSbT8XXdqBYCrHHo/help-center/assets/img/8361cd4c9a_Screenshot_2026-03-02_at_12_10_28.png?fit=max&auto=format&n=VSbT8XXdqBYCrHHo&q=85&s=ac1b47893d6158dceb33ee2505229592" width="1230" data-path="help-center/assets/img/8361cd4c9a_Screenshot_2026-03-02_at_12_10_28.png" />
      </a>
    </Frame>
  </Step>

  <Step>
    <p>필수 필드를 입력합니다:</p>

    <ul>
      <li>
        <p><b>Name</b> — 커넥터의 표시 이름입니다(예: "Acme CRM").</p>
      </li>

      <li>
        <p><b>MCP Server URL</b> — 원격 MCP 서버의 URL입니다(예: <code><a href="https://myapp.com/sse" rel="nofollow noopener noreferrer" target="_blank">[https://myapp.com/sse](https://myapp.com/sse)</a></code>). HTTPS가 필요합니다.</p>
      </li>
    </ul>
  </Step>

  <Step>
    <p>선택적으로 다음 추가 필드를 입력합니다:</p>

    <ul>
      <li>
        <p><b>Description</b> — 커넥터의 기능에 대한 간단한 설명입니다.</p>
      </li>

      <li>
        <p><b>Authentication</b> — <b>OAuth</b>, <b>API Key</b>, <b>None</b> 중에서 선택합니다(아래 인증 섹션 참조).</p>
      </li>

      <li>
        <p><b>Transport</b> — <code>Streamable HTTP</code> 또는 <code>SSE</code> 중에서 선택합니다.</p>
      </li>

      <li>
        <p><b>Icon</b> — 커넥터의 아이콘을 선택합니다. <b>참고:</b> 최대 이미지 크기는 128 KB입니다.</p>
      </li>
    </ul>
  </Step>

  <Step>
    <p>사용자 지정 커넥터의 위험을 이해했음을 확인하려면 동의 확인란을 선택합니다.</p>
  </Step>

  <Step>
    <p><b>Add</b>를 클릭합니다. 커넥터가 <b>Account settings</b>의 <b><a href="https://www.perplexity.ai/account/connectors" rel="nofollow noopener noreferrer" target="_blank">Connectors</a></b> 화면에 표시됩니다.</p>
  </Step>

  <Step>
    <p>커넥터 카드를 클릭하여 인증 흐름을 시작하고 활성화합니다. 나중에 커넥터를 수정하거나 제거하려면 줄임표(⋮)를 클릭하고 적절한 옵션을 선택합니다.</p>
  </Step>
</Steps>

<p>관리자가 추가한 조직 전체 커넥터는 다른 조직 구성원에게 즉시 표시되지 않을 수 있습니다.</p>

<p>다른 사람이 접근하려면 커넥터를 만든 사람이 <b>Enterprise settings</b>의 <b><a href="https://www.perplexity.ai/account/org/permissions" rel="nofollow noopener noreferrer" target="_blank">Permissions</a></b> 화면에서 커넥터를 조직과 공유해야 합니다.</p>

<h2 id="h_e6afa18fad"><b>인증 옵션</b></h2>

<p>원격 사용자 지정 커넥터는 세 가지 인증 방법을 지원합니다:</p>

<ul>
  <li>
    <p><b>None</b> — 인증이 필요하지 않습니다. 자격 증명 없이 MCP 서버에 접근할 수 있습니다.</p>
  </li>

  <li>
    <p><b>API Key</b> — 설정 중에 제공된 정적 API 키를 사용하여 인증합니다.</p>
  </li>

  <li>
    <p><b>OAuth 2.0</b> — OAuth 2.0 프로토콜을 사용하여 인증합니다. MCP 서버가 동적 클라이언트 등록을 지원하지 않는 경우 <b>Client ID</b> 및 <b>Client Secret</b>을 제공해야 할 수 있습니다. 서버가 OAuth 검색(<code>/.well-known/oauth-authorization-server</code>를 통해)을 지원하는 경우 엔드포인트와 범위를 자동으로 감지할 수 있습니다.</p>
  </li>
</ul>

<p>OAuth를 사용하는 조직 범위 커넥터의 경우, 관리자가 조직 전체를 대신하여 한 번 인증하거나 각 구성원이 개별적으로 인증하도록 요구할 수 있습니다.</p>

<h3 id="h_oauth_redirect_url"><b>사용자 지정 커넥터 OAuth 리디렉션 URL</b></h3>

<p>사용자 지정 커넥터를 위해 외부 시스템에서 OAuth 애플리케이션을 만들 때 콜백/리디렉션 경로는 항상 <code>/rest/connections/oauth\_callback</code>입니다.</p>

<p>등록할 리디렉션 URL은 다음과 같습니다: <code>[https://www.perplexity.ai/rest/connections/oauth\_callback](https://www.perplexity.ai/rest/connections/oauth_callback)</code></p>

<p>Enterprise 하위 도메인을 사용하는 조직의 경우 다음을 사용하세요: <code>[https://enterprise.perplexity.ai/rest/connections/oauth\_callback](https://enterprise.perplexity.ai/rest/connections/oauth_callback)</code></p>

<h2 id="h_cloudflare_access"><b>Cloudflare Access(네트워크 액세스)</b></h2>

<p>원격 MCP 서버가 <a href="https://www.cloudflare.com/zero-trust/products/access/" rel="nofollow noopener noreferrer" target="_blank">Cloudflare Access</a> 뒤에 있는 경우, 애플리케이션 계층 인증이 실행되기 전에 Perplexity를 제로 트러스트 에지에 인증할 수 있습니다. 이는 <b>+ Custom connector</b> 양식의 새로운 <b>Network access</b> 드롭다운을 통해 구성됩니다.</p>

<Frame>
  <a href="../../assets/img/cloudflare-access-network-access-dropdown.jpg" rel="noreferrer nofollow noopener" target="_blank">
    <img alt="Add custom connector modal with Network access set to Cloudflare Access, showing the CF-Access-Client-Id and CF-Access-Client-Secret fields" height="1120" src="https://mintcdn.com/perplexity-help-center/kBGsQkSG8SPEk_Ye/help-center/assets/img/cloudflare-access-network-access-dropdown.jpg?fit=max&auto=format&n=kBGsQkSG8SPEk_Ye&q=85&s=9b4343192ae9dc36acc7fa49012558c5" width="1034" data-path="help-center/assets/img/cloudflare-access-network-access-dropdown.jpg" />
  </a>
</Frame>

<h3 id="h_cf_access_admins_can"><b>관리자가 할 수 있는 작업</b></h3>

<ul>
  <li>
    <p><b>+ Custom connector</b> 양식의 새로운 <b>Network access</b> 드롭다운에서 <b>Cloudflare Access</b>를 선택하여 Cloudflare Access 뒤에 있는 원격 MCP 서버를 추가합니다.</p>
  </li>

  <li>
    <p><code>CF-Access-Client-Id</code>와 <code>CF-Access-Client-Secret</code>(둘 다 필수)을 붙여넣으세요 — Perplexity는 생성 시 확인 프로브와 모든 런타임 도구 호출을 포함하여 모든 요청에 이러한 헤더를 삽입하므로, 명백히 잘못된 토큰은 나중에 조용히 실패하는 대신 확인 단계에서 실패합니다. 확인은 성공하지만 런타임 호출이 403을 반환하는 경우에 대해서는 아래 문제 해결 참고 사항을 확인하세요.</p>
  </li>

  <li>
    <p>이를 일반 앱 계층 인증(<b>OAuth</b>, <b>API Key</b>, <b>None</b>)과 함께 중첩하여 사용할 수 있습니다 — 예를 들어 PayPal의 파일럿에서는 Cloudflare Access 헤더와 OAuth를 함께 사용합니다.</p>
  </li>

  <li>
    <p>헤더 값은 다른 커넥터 시크릿과 동일한 처리 경로에 따라 암호화되어 저장되며 UI에서 가려집니다.</p>
  </li>

  <li>
    <p>헤더 이름은 대소문자를 구분하지 않지만 키는 정확해야 합니다: <code>CF-Access-Client-Id</code> 및 <code>CF-Access-Client-Secret</code>.</p>
  </li>
</ul>

<h3 id="h_cf_access_configuring"><b>Cloudflare 측 구성</b></h3>

<p>Cloudflare Access는 Perplexity가 연결하기 전에 Cloudflare Zero Trust 대시보드에서 일회성 설정이 필요합니다.</p>

<Steps>
  <Step>
    <p><b>서비스 토큰을 만듭니다.</b> Cloudflare Zero Trust 대시보드에서 <b>Access → Service Auth → Service Tokens</b>로 이동하여 새 토큰을 만듭니다. <b>Client ID</b>와 <b>Client Secret</b>을 즉시 복사하세요 — 시크릿은 한 번만 표시됩니다.</p>
  </Step>

  <Step>
    <p>MCP 서버의 호스트 이름에 대한 <b>Access 애플리케이션을 만듭니다.</b> <b>Self-hosted</b> 애플리케이션 유형을 사용하고 Perplexity가 호출할 공개 호스트 이름을 지정합니다.</p>
  </Step>

  <Step>
    <p><b>Action = Service Auth로 정책을 추가합니다.</b> 애플리케이션 정책에서 <b>Action</b>을 <b>Service Auth</b>(<b>Allow</b>가 아님)로 설정하고 1단계에서 만든 서비스 토큰을 포함합니다.</p>
  </Step>
</Steps>

<p><b>일반적인 잘못된 구성:</b> <b>Service Auth</b> 대신 <b>Allow</b>를 선택하면 Cloudflare가 대화형 브라우저 로그인을 기대하고 브라우저가 아닌 요청을 거부하므로 Perplexity 확인 프로브가 실패합니다. <b>Service Auth</b>는 서비스 토큰을 통한 머신 간 액세스에 적합한 작업입니다.</p>

<p><b>팁:</b> 커넥터가 성공적으로 저장되면 확인 프로브가 Cloudflare Access를 통해 인증된 것이며, 인증 경로가 처음부터 끝까지 작동하고 있는 것입니다.</p>

<h3 id="h_cf_access_troubleshooting"><b>문제 해결: 확인 또는 도구 호출에서 403 반환</b></h3>

<p>커넥터 확인에 실패하거나, 확인은 성공했지만 런타임에 도구 호출이 403을 반환하는 경우 다음을 순서대로 진행하세요:</p>

<ul>
  <li>
    <p><b>불완전하거나 만료된 토큰.</b> 전체 <b>Client ID</b>와 <b>Client Secret</b>을 다시 붙여넣으세요 — 시크릿 필드가 길어서 일부만 붙여넣기 쉽습니다. 서비스 토큰에도 만료 기간(기본값 1년)이 있으므로 만료된 경우 토큰을 다시 발급하세요.</p>
  </li>

  <li>
    <p><b>잘못된 정책 작업.</b> Access 정책은 <b>Allow</b>나 <b>Bypass</b>가 아니라 <b>Service Auth</b>를 사용해야 합니다. 위의 구성 단계를 참조하세요.</p>
  </li>

  <li>
    <p><b>전파 지연.</b> 새로 만든 Access 애플리케이션, 정책, 서비스 토큰이 Cloudflare 에지 전체에 전파되는 데 몇 분이 걸립니다. 설정 직후 확인에 실패하면 잘못된 구성이라고 판단하기 전에 몇 분 기다렸다가 다시 시도하세요.</p>
  </li>

  <li>
    <p><b>WAF 또는 봇 관리 챌린지.</b> Perplexity는 데이터센터 IP 범위에서 연결됩니다. Cloudflare 존이 자동화된 트래픽에 챌린지를 적용하면 MCP 엔드포인트가 머신 클라이언트가 해결할 수 없는 Managed Challenge를 받을 수 있으며, 이는 403으로 나타납니다. MCP 호스트 이름에 대해 WAF 건너뛰기 또는 봇 관리 예외를 추가하세요. Cloudflare Access가 여전히 서비스 토큰을 통해 엔드포인트를 보호하므로 안전합니다.</p>
  </li>
</ul>

<p>위의 모든 사항이 정상인데도 커넥터가 여전히 실패한다면, 문제는 Cloudflare Access가 아니라 애플리케이션 계층(MCP 서버 자체)에 있을 가능성이 높습니다.</p>

<h2 id="h_privatelink"><b>AWS PrivateLink(네트워크 액세스)</b></h2>

<p>원격 MCP 서버가 AWS VPC 내부에서 실행되며 공용 인터넷에 노출되어 있지 않은 경우, Perplexity는 <a href="https://aws.amazon.com/privatelink/" rel="nofollow noopener noreferrer" target="_blank">AWS PrivateLink</a>를 통해 비공개로 해당 서버에 연결할 수 있습니다. 트래픽은 Perplexity에서 VPC까지 전적으로 AWS 네트워크를 통해 흐르므로 MCP 서버에 공개 엔드포인트가 전혀 필요하지 않습니다. 이 옵션은 Enterprise 조직에서 사용할 수 있으며 Perplexity 계정 팀과 함께 설정합니다.</p>

<h3 id="h_privatelink_how_it_works"><b>작동 방식</b></h3>

<ul>
  <li>
    <p>MCP 서버 앞에 VPC 엔드포인트 서비스를 만들고 이를 Perplexity 계정 팀과 공유합니다.</p>
  </li>

  <li>
    <p>Perplexity가 소유한 인터페이스 엔드포인트를 해당 서비스에 연결하고 팀과 함께 세부 정보를 확인합니다.</p>
  </li>

  <li>
    <p>AWS 계정에서 연결 요청을 수락하면 Perplexity가 조직에 대해 엔드포인트를 활성화합니다.</p>
  </li>

  <li>
    <p>이후 커넥터는 AWS를 통해 비공개로 MCP 서버에 연결됩니다 — 공개 엔드포인트가 필요하지 않습니다.</p>
  </li>
</ul>

<h3 id="h_privatelink_admins_can"><b>관리자가 할 수 있는 작업</b></h3>

<ul>
  <li>
    <p>Perplexity 계정 팀을 통해 PrivateLink 연결을 요청하세요. 온보딩은 Perplexity가 관리하고 확인하며, 셀프 서비스 설정은 없습니다.</p>
  </li>

  <li>
    <p>엔드포인트가 활성화되면 평소와 같이 사용자 지정 커넥터를 추가하고, <b>MCP Server URL</b>을 온보딩 중에 합의한 비공개 DNS 이름으로 지정하세요. HTTPS는 여전히 필요합니다.</p>
  </li>

  <li>
    <p>다른 원격 사용자 지정 커넥터와 마찬가지로 <b>Enterprise settings → Permissions</b>에서 커넥터를 조직과 공유하세요.</p>
  </li>
</ul>

<h3 id="h_privatelink_configuring"><b>AWS 측 구성</b></h3>

<p>팀은 온보딩 중에 Perplexity와 협의하여 AWS 계정에서 일회성 설정을 완료합니다:</p>

<Steps>
  <Step>
    <p><b>MCP 서버를 VPC 엔드포인트 서비스로 노출합니다.</b> VPC에서 Network Load Balancer를 서버 앞에 배치하고 이에 대한 <a href="https://docs.aws.amazon.com/vpc/latest/privatelink/create-endpoint-service.html" rel="nofollow noopener noreferrer" target="_blank">VPC 엔드포인트 서비스</a>를 만듭니다.</p>
  </Step>

  <Step>
    <p><b>Perplexity의 AWS 보안 주체를 허용 목록에 추가합니다.</b> 계정 팀이 엔드포인트 서비스의 허용된 보안 주체에 추가할 AWS 계정 보안 주체를 제공합니다.</p>
  </Step>

  <Step>
    <p><b>연결 요청을 수락합니다.</b> Perplexity가 인터페이스 엔드포인트를 프로비저닝하면 엔드포인트 서비스에서 대기 중인 연결을 수락하세요. Perplexity는 조직에 대해 엔드포인트가 활성화되기 전에 팀과 별도 채널로 서비스 세부 정보를 확인합니다.</p>
  </Step>
</Steps>

<h2 id="h_7150eebf0c"><b>공유 및 권한</b></h2>

<p>사용자 지정 커넥터는 두 가지 방식으로 범위를 지정할 수 있습니다:</p>

<ul>
  <li>
    <p><b>Individual</b> — 커넥터는 이를 만든 사용자에게만 비공개됩니다. 해당 사용자만 이를 보고 사용할 수 있습니다.</p>
  </li>

  <li>
    <p><b>Organization</b> — 커넥터가 모든 조직 구성원과 공유됩니다(원격 커넥터만 해당). 관리자만 커넥터를 조직 전체와 공유할 수 있습니다.</p>
  </li>
</ul>

<h2 id="h_bb98cf4bb0"><b>관리자 제어</b></h2>

<p>조직 관리자에게는 추가 관리 기능이 있습니다:</p>

<ul>
  <li>
    <p><b>구성원의 사용자 지정</b> <b>커넥터 추가 허용</b> — 이 토글을 사용하여 관리자가 아닌 구성원이 자신의 원격 사용자 지정 커넥터를 추가할 수 있는지 여부를 제어합니다. 기본적으로 비활성화되어 있습니다.</p>
  </li>

  <li>
    <p><b>조직 전체 원격 커넥터 추가</b> — 조직 전체와 공유되는 원격 커넥터를 추가합니다.</p>
  </li>
</ul>

<p>이러한 설정은 <b>Connector permissions</b> 섹션 아래의 <b>Enterprise settings → Connectors</b>에서 접근할 수 있습니다.</p>

<Frame>
  <a href="../../assets/img/46d4657480_Screenshot_2026-03-02_at_12_50_34__281_29.png" rel="noreferrer nofollow noopener" target="_blank">
    <img alt="" height="786" src="https://mintcdn.com/perplexity-help-center/Qv3d0vQE9qMlZrQx/help-center/assets/img/46d4657480_Screenshot_2026-03-02_at_12_50_34__281_29.png?fit=max&auto=format&n=Qv3d0vQE9qMlZrQx&q=85&s=4762db46a14f2a0cd04903ca707e9c3f" width="1406" data-path="help-center/assets/img/46d4657480_Screenshot_2026-03-02_at_12_50_34__281_29.png" />
  </a>
</Frame>

<h2 id="h_265e91510d"><b>보안 고려 사항</b></h2>

<p>Perplexity는 제3자 MCP 서버를 확인하거나 답변 품질을 보장할 수 없으므로 사용자 지정 커넥터는 추가 위험을 초래합니다. 다음 사항을 유념하세요:</p>

<ul>
  <li>
    <p>신뢰할 수 있는 출처의 커넥터만 사용하세요. Perplexity는 사용자 지정 커넥터로 인해 발생하는 문제에 대해 책임지지 않습니다.</p>
  </li>

  <li>
    <p>원격 MCP 서버 URL은 HTTPS를 사용해야 합니다.</p>
  </li>

  <li>
    <p>사용자는 자신의 커넥터만 편집하거나 삭제할 수 있습니다. 관리자는 조직 전체 커넥터를 관리할 수 있습니다.</p>
  </li>

  <li>
    <p>설정 중 서버 유효성 검사에 실패하면 커넥터에 다시 구성하라는 메시지와 함께 오류 태그가 표시됩니다.</p>
  </li>

  <li>
    <p>관리자는 구성원이 추가한 커넥터를 검토하고 보안 위험을 초래하는 커넥터를 제한하거나 제거해야 합니다.</p>
  </li>
</ul>


## Related topics

- [Perplexity 엔터프라이즈](/help-center/help-center/ko/collections/11312901-perplexity-엔터프라이즈.md)
- [Computer에서 사용자 지정 API 자격 증명 사용하기](/help-center/help-center/ko/articles/20260716-using-custom-api-credentials-in-computer.md)
- [Perplexity를 위한 로컬 및 원격 MCP](/help-center/help-center/ko/articles/11502712-perplexity용-로컬-및-원격-mcp.md)
- [Microsoft Teams 커넥터](/help-center/help-center/ko/articles/12674820-microsoft-teams-커넥터.md)
- [Slack용 커넥터 사용하기](/help-center/help-center/ko/articles/12167980-slack용-커넥터-사용.md)