# 연결 문제 해결

> 만료된 토큰, 취소된 접근, 잘못된 계정, 권한 오류 — 각각이 어떻게 보이고 어떻게 고치는가.

어제까지 되던 커넥터가 오늘 안 된다면 대개 다섯 가지 중 하나입니다. 이 페이지는 그 목록을, 자주 일어나는 순서대로 담았습니다.

## 여기서 시작하세요

[에이전트 빌더](/ko/docs/build/agent-builder/)에서 그 에이전트의 커넥터를 엽니다. 손봐야 할 연결은 거기 표시돼 있고, 해법은 거의 항상 다시 승인하는 것입니다.

**다시 승인해도 바인딩은 유지됩니다.** 같은 서비스를 같은 계정으로 연결하면 두 번째 연결이 생기는 게 아니라 기존 연결이 다시 승인되므로, 에이전트마다 다시 바인딩할 필요가 없습니다.

## 다섯 가지 원인

### 승인이 만료됐다

제공자는 일정 기간이 지나면 접근을 만료시킵니다. 빠른 곳도 있고 몇 달 뒤인 곳도 있습니다. 연결에 재승인 필요 표시가 뜨고, 그 서비스의 도구가 동작을 멈춥니다.

**해법:** 같은 계정으로 다시 연결하세요.

### 제공자 쪽에서 접근이 취소됐다

누군가 Google 계정 설정에서 Endue 를 제거했거나, Slack 앱을 삭제했거나, API 토큰을 지운 경우입니다. Endue 는 시도해 보기 전까지 이것을 만료와 구분하지 못합니다.

**해법:** 다시 승인하거나, 새 토큰을 만들어 다시 연결하세요. 의도한 취소였다면 Endue 에서도 연결을 제거해 상태를 정직하게 맞추세요.

### 엉뚱한 계정을 연결했다

전형적인 경우입니다. 업무용 커넥터를 승인할 때 개인 Google 계정으로 로그인돼 있던 것이죠. 오류는 나지 않습니다. 엉뚱한 받은편지함을 보고 있으니 에이전트가 아무것도 찾지 못할 뿐입니다.

**해법:** 제공자에서 잘못된 계정을 로그아웃하거나 시크릿 창을 쓰고, 의도한 계정으로 다시 연결하세요. 승인 전에 동의 화면에 표시된 계정을 확인하는 습관을 들이면 좋습니다.

### 그 리소스에 대한 접근이 없다

연결은 멀쩡하고, 리소스가 공유돼 있지 않은 것입니다.

| 서비스 | 증상 | 해법 |
| --- | --- | --- |
| **Slack** | 기록을 읽을 때 "채널에 없음" | Slack 에서 그 채널에 앱을 초대 |
| **Notion** | 눈에 보이는 페이지인데 검색 결과가 없음 | Notion 에서 그 페이지를 통합에 공유 |
| **GitLab** | 프로젝트나 이슈를 찾을 수 없다고 함 | 토큰 소유자에게 권한이 없을 수 있음 — 철자가 아니라 권한을 확인 |
| **Google** | 파일을 찾을 수 없음 | 연결한 계정에 그 파일의 접근 권한이 없을 수 있음 |

<Aside type="note" title="찾을 수 없음은 대개 권한 없음입니다">
  여러 제공자가 볼 수 없는 것에 대해 "허용되지 않음" 대신 "찾을 수 없음" 을 돌려줍니다. 존재
  자체를 드러내지 않기 위해서죠. 분명히 있는 것에 대한 찾을 수 없음은 먼저 권한 문제로 의심하세요.
</Aside>

### 자체 설치 서비스가 옮겨졌거나 닿지 않는다

주소를 묻는 커넥터 — GitLab · Jenkins · Discourse · WordPress · Mattermost · Grafana · Elasticsearch — 는 그 주소가 인터넷에서 닿을 수 있어야 합니다.

**해법:** 주소가 맞고 공개적으로 닿을 수 있는지 확인한 뒤 다시 연결하세요. VPN 뒤의 서비스에는 닿을 수 없습니다.

## 커넥터는 멀쩡한데 에이전트가 계속 실패한다면

- **그 작업이 존재하지 않습니다.** 커넥터마다 제공하는 작업이 정해져 있습니다. [연결 가능한 서비스](/ko/docs/connect/available-connectors/)를 확인하세요. Endue 가 노출하지 않는 제공자 API 는 에이전트가 쓸 수 없습니다.
- **연결이 *이* 에이전트에 바인딩되지 않았습니다.** 연결은 계정 단위이고, 사용은 에이전트 단위입니다.
- **도구 그룹이 꺼져 있습니다.** 빠진 능력이 커넥터가 아니라 메모리·아티팩트·루틴·웹 가져오기라면 에이전트의 [내장 툴](/ko/docs/capabilities/built-in-tools/)를 확인하세요.
- **[승인](/ko/docs/work/approvals/) 관문에서 거절됐습니다.** 지켜보는 사람이 없는 실행이라 자동으로 거절된 경우도 포함합니다.

## 연결 제거하기

Endue 에서 제거하면 그 연결에 바인딩된 모든 에이전트가 즉시 그 도구를 잃습니다. 기존 대화의 기록은 남고, 에이전트가 더 이상 그 호출을 하지 못하게 됩니다.

Endue 에서 연결을 제거해도 제공자 쪽의 Endue 접근이 취소되지는 않습니다. 완전히 끊으려면 양쪽 다 하세요.

## 관련 문서

<CardGrid>
  <LinkCard
    title="커넥터 개요"
    href="/ko/docs/connect/overview/"
    description="연결 · 바인딩 · 해지가 어떻게 맞물리는지."
  />
  <LinkCard
    title="문제 해결"
    href="/ko/docs/troubleshooting/"
    description="연결과 무관한 문제들."
  />
  <LinkCard
    title="보안과 권한"
    href="/ko/docs/account/security/"
    description="에이전트가 닿을 수 있는 것과 없는 것."
  />
</CardGrid>