> ## 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.

# Plaid 연결

> 빌더가 Agent를 사용하여 잔액, 거래, 투자 데이터를 위한 Plaid Link로 금융 계좌를 연결하는 앱을 빌드할 수 있도록 Plaid 커넥터를 설정하세요.

export const WistiaEmbed = ({videoId, title = "Wistia video", playerColor = "FF0000", controlsVisibleOnLoad = false}) => {
  if (!videoId) {
    return null;
  }
  const url = "https://fast.wistia.net/embed/iframe/" + videoId + "?seo=false&playerColor=" + playerColor + "&controlsVisibleOnLoad=" + controlsVisibleOnLoad;
  return <Frame>
      <iframe src={url} title={title} allow="autoplay; fullscreen" allowFullScreen></iframe>
    </Frame>;
};

export const AiPrompt = ({children}) => {
  return <CodeBlock className="relative block font-sans whitespace-pre-wrap break-words">
      <div className="pr-7">
        {children}
      </div>
    </CodeBlock>;
};

<Info>
  Plaid 커넥터는 유료 Replit 플랜에서 사용 가능하며 [팀 워크스페이스](/references/collaboration/team-workspaces#create-a-team-workspace)가 필요합니다.
</Info>

<WistiaEmbed videoId="fcqtulftwk" title="See how it was built with Replit and Plaid" />

Plaid는 앱을 금융 기관에 연결합니다. Plaid 커넥터를 사용하면 빌더가 연결된 기관에서 지원하는 경우 계좌 잔액, 거래, 투자 데이터를 사용하는 앱을 만들 수 있습니다.

설정은 두 부분으로 이루어집니다. 워크스페이스 관리자가 Replit에서 Plaid 자격 증명을 한 번 구성하면 앱을 사용하는 각 사람이 Plaid Link를 통해 자신의 금융 계좌를 연결합니다. Plaid 액세스 토큰은 사람별로 범위가 지정되고 안전하게 저장되므로 앱이 Plaid 시크릿을 직접 처리하지 않고도 금융 데이터를 사용할 수 있습니다.

## 빌드할 수 있는 것

Plaid 커넥터를 사용하여 다음과 같은 앱을 빌드하세요:

* 개인 금융 대시보드
* 예산 및 지출 분류 도구
* 거래 검색 및 분석 앱
* 지원되는 투자 계좌의 포트폴리오 트래커
* 지출 패턴을 요약하는 금융 코치

## 전제 조건

Replit에서 Plaid를 구성하기 전에 다음이 필요합니다:

* [팀 워크스페이스](/references/collaboration/team-workspaces#create-a-team-workspace) — Plaid는 팀 수준에서 구성됩니다
* [Plaid 계정](https://dashboard.plaid.com/signup)
* [Plaid 대시보드](https://dashboard.plaid.com/developers/keys)의 Plaid **클라이언트 ID**
* 사용하려는 환경의 Plaid **시크릿**
* Plaid `sandbox` 또는 `production` 중 무엇을 사용할지 결정

Plaid의 샘플 기관과 자격 증명으로 테스트하는 동안에는 `sandbox`를 사용하세요. 앱이 실제 금융 계좌를 연결할 준비가 되면 `production`을 사용하세요.

## Replit에서 Plaid 커넥터 구성하기

워크스페이스 관리자가 Replit에 Plaid 자격 증명을 추가합니다. 커넥터가 구성된 후 빌더가 Agent와 함께 Plaid 데이터를 사용할 수 있습니다.

<Steps>
  <Step title="연동 열기">
    Replit에서 워크스페이스 또는 앱 설정을 열고 **연동**을 선택하세요.

    <Frame>
      <img src="https://mintcdn.com/replit/S8pkAHcCKNXM_bfw/images/replitai/plaid-connector/integrations-panel.png?fit=max&auto=format&n=S8pkAHcCKNXM_bfw&q=85&s=8bc11cb25ea92696a154d99240ae5278" alt="Replit 관리형 연동과 커넥터 섹션이 있고 오른쪽 상단에 새 커넥터 추가 버튼이 강조된 Avenger 팀 워크스페이스 연동 패널" width="1440" height="900" data-path="images/replitai/plaid-connector/integrations-panel.png" />
    </Frame>
  </Step>

  <Step title="Plaid 커넥터 추가하기">
    **새 커넥터 추가**를 선택한 다음 **Plaid**를 선택하세요.

    <Frame>
      <img src="https://mintcdn.com/replit/S8pkAHcCKNXM_bfw/images/replitai/plaid-connector/plaid-connector-search.png?fit=max&auto=format&n=S8pkAHcCKNXM_bfw&q=85&s=24449d0a433bb175808daf57cd0b19bb" width="1440" height="900" data-path="images/replitai/plaid-connector/plaid-connector-search.png" />
    </Frame>
  </Step>

  <Step title="환경 선택하기">
    `sandbox` 또는 `production`을 선택하세요. 사용하려는 Plaid 시크릿과 일치해야 합니다.
  </Step>

  <Step title="Plaid 자격 증명 입력하기">
    Plaid 대시보드에서 Plaid **클라이언트 ID**와 **시크릿**을 붙여넣으세요.
  </Step>

  <Step title="클라이언트 이름 설정하기">
    Plaid Link에 표시될 앱 이름을 입력하세요. 필드에는 `My Plaid App`이 미리 채워져 있습니다. 사용자에게 표시될 이름으로 교체하세요. Plaid가 올바르게 표시할 수 있도록 30자 이하로 유지하세요.
  </Step>

  <Step title="커넥터 저장하기">
    **구성**을 선택하여 커넥터를 저장하세요. Replit이 자격 증명을 안전하게 저장하고 빌더가 Plaid 계좌를 연결할 때 사용합니다.

    <Frame>
      <img src="https://mintcdn.com/replit/S8pkAHcCKNXM_bfw/images/replitai/plaid-connector/plaid-config-dialog.png?fit=max&auto=format&n=S8pkAHcCKNXM_bfw&q=85&s=2d6367edf76b21a6b520dfeee37a88df" alt="환경, 클라이언트 ID, 클라이언트 시크릿, 클라이언트 이름 필드와 저장을 위한 구성 버튼이 있는 Plaid 구성 활성화 다이얼로그" width="1440" height="900" data-path="images/replitai/plaid-connector/plaid-config-dialog.png" />
    </Frame>
  </Step>
</Steps>

나중에 구성을 변경하려면 연동 패널에서 **커넥터 관리**를 열고 Plaid 옆의 **관리**를 선택하세요.

<Frame>
  <img src="https://mintcdn.com/replit/S8pkAHcCKNXM_bfw/images/replitai/plaid-connector/plaid-connector-manage.png?fit=max&auto=format&n=S8pkAHcCKNXM_bfw&q=85&s=8ae2a857432719ca0827c65ee8d1c193" alt="저장된 환경, 클라이언트 ID, 클라이언트 시크릿, 클라이언트 이름과 변경 사항을 저장하기 위한 업데이트 버튼이 있는 Plaid 커넥터 관리 패널" width="1440" height="900" data-path="images/replitai/plaid-connector/plaid-connector-manage.png" />
</Frame>

조직 전체 커넥터 관리는 [커넥터 관리하기](/replitai/managing-connectors)를 참조하세요.

## Plaid Link로 로그인하기

Plaid는 표준 OAuth 리디렉션 대신 [Plaid Link](https://plaid.com/docs/link/)를 사용합니다. 흐름을 시작하려면 커넥터 테이블에서 Plaid를 찾고 **로그인**을 선택하세요. Replit이 연결을 확인하는 간단한 동의 화면을 표시한 다음 Plaid Link를 엽니다.

<Frame>
  <img src="https://mintcdn.com/replit/S8pkAHcCKNXM_bfw/images/replitai/plaid-connector/connect-plaid-consent.png?fit=max&auto=format&n=S8pkAHcCKNXM_bfw&q=85&s=738d4366039cefb0e4671ba805133342" alt="Replit과 Plaid 로고, Plaid 연결, 데이터 사용, 취소 가능한 권한에 대한 세 가지 안심 항목, Plaid로 계속 버튼이 있는 Plaid 연결 동의 다이얼로그" width="1440" height="900" data-path="images/replitai/plaid-connector/connect-plaid-consent.png" />
</Frame>

그런 다음 Plaid Link가 내장된 흐름을 열어 각 사람이 금융 기관을 선택하고 해당 기관으로 인증합니다.

<Frame>
  <img src="https://mintcdn.com/replit/EnyLbFHisfL7qzsL/images/replitai/plaid-connector/plaid-link-picker.png?fit=max&auto=format&n=EnyLbFHisfL7qzsL&q=85&s=fb920d84d88c5d3b3d69344f1a5b8448" alt="검색 입력과 Chase, Bank of America, Wells Fargo, Citibank, US Bank, Capital One, PNC, USAA, American Express, TD, Regions, Navy Federal 등 주요 미국 은행 로고가 있는 '기관 선택' 제목의 Plaid Link 기관 선택기, 하단에 Sandbox 모드 배너" width="1440" height="900" data-path="images/replitai/plaid-connector/plaid-link-picker.png" />
</Frame>

각 사람이 자신의 계좌를 연결합니다. Replit이 해당 사람의 연결에 대한 Plaid 액세스 토큰을 저장하고 Agent 또는 앱이 Plaid 데이터를 요청할 때 사용합니다.

## Plaid 데이터로 빌드 시작하기

Plaid가 연결된 후 연결된 금융 데이터로 빌드하도록 Agent에게 요청하세요. 예를 들어:

<AiPrompt>
  Build a personal finance dashboard where people connect bank accounts with Plaid Link. Show account balances, monthly spending by category, and the five largest recent transactions.
</AiPrompt>

<AiPrompt>
  Create a budgeting app where each person connects accounts through Plaid Link. Import transactions, group them by merchant and category, and show whether they are over budget this month.
</AiPrompt>

<AiPrompt>
  Build a portfolio tracker where people connect supported investment accounts through Plaid Link. Show holdings, account balances, and changes over time where data is available.
</AiPrompt>

Plaid 데이터 가용성은 연결된 기관과 Plaid 계정에 활성화된 Plaid 제품에 따라 다릅니다.

## 문제 해결

<AccordionGroup>
  <Accordion title="연동에 Plaid가 표시되지 않음">
    Plaid는 유료 Replit 플랜이 필요합니다. 유료 플랜을 사용 중인데도 Plaid가 표시되지 않으면 페이지를 새로고침하고 올바른 워크스페이스에 있는지 확인하세요.

    설정에 **이 기능은 Enterprise 플랜이 필요합니다**가 표시되면 페이지를 새로고침하고 올바른 워크스페이스를 사용하고 있는지 확인하세요.

    Plaid가 여전히 표시되지 않으면 Replit 지원팀에 문의하여 팀이 워크스페이스 구성을 확인할 수 있도록 하세요.
  </Accordion>

  <Accordion title="Plaid Link에 앱 이름 대신 '이 애플리케이션'이 표시됨">
    구성된 클라이언트 이름이 없거나 너무 길 때 Plaid가 **이 애플리케이션**을 표시할 수 있습니다. Plaid 커넥터 구성을 편집하고 30자 이하의 앱 이름을 사용하세요.
  </Accordion>

  <Accordion title="연결이 연결 해제됨으로 표시됨">
    금융 기관이 계좌 소유자에게 다시 로그인을 요구하거나, 자격 증명이 변경되거나, 권한이 취소된 경우 Plaid 연결이 끊길 수 있습니다.

    연동 또는 커넥터 패널에서 Plaid를 다시 연결하여 Plaid Link를 열고 접근을 복원하세요.
  </Accordion>

  <Accordion title="Sandbox와 프로덕션 데이터가 일치하지 않음">
    Plaid sandbox와 프로덕션은 서로 다른 자격 증명과 토큰을 사용합니다. 커넥터 환경이 입력한 Plaid 시크릿과 테스트 중인 금융 계좌 유형과 일치하는지 확인하세요.
  </Accordion>
</AccordionGroup>

## 관련 문서

* [Agent 연동](/references/integrations/overview) — Replit 관리형 연동, 커넥터, 외부 연동, Agent 서비스 개요
* [커넥터 관리하기](/replitai/managing-connectors) — 워크스페이스의 커넥터 구성 및 관리
* [Plaid 문서](https://plaid.com/docs/) — Plaid API, Link, 제품 문서
* [Plaid 대시보드](https://dashboard.plaid.com/developers/keys) — Plaid 클라이언트 ID와 시크릿 찾기
* [Replit x Plaid](https://replit.com/partners/plaid) — 데모와 설정 리소스가 있는 파트너 페이지