# 커넥터 개요

> 이미 쓰는 서비스에 Endue 를 연결하고, 그 연결을 특정 에이전트에 바인딩하고, 다 쓰면 해지합니다.

**커넥터**는 이미 쓰고 있는 서비스에 에이전트를 잇습니다. Endue 는 서른 개가 넘는 서비스의 커넥터를 제공합니다 — [연결 가능한 서비스](/ko/docs/connect/available-connectors/)를 보세요.

## 연결과 바인딩

제대로 이해해 둘 만한 개념은 이것 하나입니다. 에이전트의 손이 닿는 범위를 예측 가능하게 만드는 것이 바로 이 구분이기 때문입니다.

<Steps>

1. **연결을 승인합니다.** 제공자 — Google · Slack · Notion — 에서 로그인하거나 API 토큰을 붙여넣습니다. 그렇게 만들어진 연결은 *사용자 계정*에 속합니다.

2. **연결을 특정 에이전트에 바인딩합니다.** 바인딩한 에이전트만 그것을 쓸 수 있습니다.

</Steps>

Gmail 을 연결했다고 모든 에이전트가 받은편지함을 갖지 않습니다. 메일을 읽을 이유가 없는 에이전트에는 바인딩하지 마세요. 잘못될 수 있는 범위가 좁아지고 에이전트의 선택도 더 예측 가능해집니다.

## 서비스 연결하기

<Steps>

1. **[에이전트 빌더](/ko/docs/build/agent-builder/)의 능력 섹션에서 커넥터를 열고** 서비스를 고릅니다.

2. **승인합니다.**

   대부분의 서비스는 제공자 화면으로 보내 로그인하고 접근을 승인하게 합니다. Endue 는 그 동의 화면에 표시된 권한만 받습니다. 어떤 서비스는 제공자 설정에서 만든 API 토큰을 요구하고, 때로는 자체 설치 주소를 함께 요구합니다.

3. **이 에이전트에 바인딩합니다.** 그 서비스의 도구는 에이전트의 다음 [실행](/ko/docs/work/runs/)부터 나타납니다.

</Steps>

<Aside type="caution" title="쓰려던 계정이 맞는지 확인하세요">
  연결은 제공자의 계정 하나에 묶입니다. 회사 구글 계정과 개인 구글 계정을 둘 다 쓴다면 어느
  쪽으로 로그인하는지 확인하세요. 같은 서비스를 같은 계정으로 다시 연결하면 사본이 생기는 게
  아니라 기존 연결이 다시 승인되므로 바인딩은 그대로 유지됩니다.
</Aside>

## 연결하면 에이전트가 할 수 있는 일

커넥터마다 제공하는 작업 묶음이 있고, 모든 작업은 무엇을 하는지에 따라 읽기·쓰기·발송·파괴로 분류돼 있습니다. **발송과 파괴 작업은 실행 전에 항상 [승인](/ko/docs/work/approvals/)을 위해 멈춥니다.** 어떤 인자를 쓰는지 그대로 보여주면서요.

그래서 Gmail 을 연결하면 에이전트는 마음껏 검색하고 읽고, 묻지 않고 초안을 쓰지만, 보내는 것은 사용자가 확인해야만 합니다.

## 해지하기

양쪽 어디서든 끊을 수 있습니다.

- **Endue 에서** 연결을 제거합니다. 바인딩돼 있던 모든 에이전트가 즉시 그 도구를 잃습니다.
- **제공자에서** Google · Slack · Notion 계정 설정에서 Endue 의 접근을 취소하거나 API 토큰을 삭제합니다.

제공자 쪽에서 취소하면 Endue 의 연결은 사용자가 제거하거나 다시 승인할 때까지 깨진 상태로 남습니다. [연결 문제 해결](/ko/docs/connect/troubleshooting/)을 보세요.

## 한계

- 서비스당 연결 하나에 계정 하나입니다. 구글 계정 둘을 쓰려면 연결을 둘 승인하세요.
- 연결은 에이전트별로 바인딩됩니다. "모든 에이전트" 옵션은 없습니다.
- 커넥터는 정해진 작업 묶음을 제공합니다. 범용 API 클라이언트가 아니어서, 에이전트가 제공자의 임의 엔드포인트를 호출할 수는 없습니다.
- Endue 는 제공자의 승인이 허용한 것만 할 수 있습니다. 허용되지 않은 범위의 작업은 조용히 넘어가지 않고 제공자 쪽에서 실패합니다.

## 관련 문서

<CardGrid>
  <LinkCard
    title="연결 가능한 서비스"
    href="/ko/docs/connect/available-connectors/"
    description="연결할 수 있는 모든 서비스와, 에이전트가 그것으로 할 수 있는 일."
  />
  <LinkCard
    title="승인"
    href="/ko/docs/work/approvals/"
    description="어떤 작업이 멈춰 서서 먼저 묻는지."
  />
  <LinkCard
    title="연결 문제 해결"
    href="/ko/docs/connect/troubleshooting/"
    description="만료된 토큰, 취소된 접근, 잘못된 계정."
  />
</CardGrid>