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

# 커넥터

> 외부 시스템에 붙는, 다시 쓸 수 있는 인증 연결

**커넥터**는 외부 서비스에 저장한 자격증명입니다. 워크스페이스 수준에서 한번 세우면, 어느 Flow나 파운더리 파이프라인이든 다시 인증하지 않고 이름으로 참조합니다.

## 지원 서비스

| 서비스                                                 | 모드                         |
| --------------------------------------------------- | -------------------------- |
| **Google Drive**                                    | 파일·폴더 읽기, 변경 감시            |
| **Google Workspace**(Docs, Sheets, Gmail, Calendar) | 문서 읽기, 이벤트 목록, 받은편지함 감시    |
| **Microsoft 365**(OneDrive, SharePoint, Outlook)    | 파일 읽기, 변경 감시               |
| **Notion**                                          | 페이지·데이터베이스 읽기, 감시          |
| **Slack**                                           | 채널 읽기, 메시지 감시, 메시지 게시      |
| **Confluence**                                      | 스페이스 읽기, 페이지 업데이트 감시       |
| **GitHub**                                          | 리포·PR·이슈 읽기, 푸시 감시         |
| **S3 호환**(AWS S3, R2, GCS)                          | 객체 읽기, 버킷 prefix 감시        |
| **Postgres / MySQL / SQL Server**                   | 쿼리와 테이블 스트리밍               |
| **HTTP(일반)**                                        | 아무 auth나 쓰는 커스텀 REST 엔드포인트 |

새 커넥터가 계속 나옵니다. 앱의 픽커가 지금 목록을 보여줍니다.

## 커넥터 만들기

**Settings → Connections → New** 입니다.

1. 서비스를 고릅니다.
2. OAuth로 인증하거나(대부분 서비스), 자격증명을 직접 붙여 넣습니다(DB, S3, 일반 HTTP).
3. 기억하기 좋은 이름을 붙입니다.
4. 범위를 좁힐 수 있습니다(특정 폴더, 버킷, 채널). 좁은 범위가 뜻밖의 노출을 줄입니다.

저장합니다. 자격증명이 그 자리에서 암호화되고 UI나 API로 절대 안 돌아옵니다.

### CLI에서

```bash theme={null}
nora connectors create --provider tavily --name "Tavily search" --api-key ?
```

전체 CLI 문서는 [`nora connectors`](/ko/cli/connectors) 입니다.

## 커넥터 쓰기

서비스를 쓰는 아무 블록에서든(파이프라인의 Source 블록, Flow의 Tool 블록) 드롭다운에서 커넥터를 고릅니다. 블록이 서비스에 맞는 설정(어느 폴더, 어느 채널, 어느 SQL)을 띄우고, 자격증명은 커넥터에서 옵니다.

## 테스트

커넥터마다 **Test** 버튼이 있습니다(CLI에서는 `nora connectors invoke <id> ping`). 읽기 전용 프로브(폴더 목록, 채널 메시지 수, `SELECT 1`)를 돌립니다. 초록이면 자격증명이 유효합니다.

## 자격증명 로테이션

**Settings → Connections → \[커넥터] → Rotate** 입니다. 또는 이렇게요.

```bash theme={null}
nora connectors update c_tavily --rotate-api-key ?
```

이전 자격증명이 60분 유예 동안 그대로 돼, 돌던 파이프라인이 실패하지 않습니다.

스케줄로 돌리거나(분기마다가 흔합니다) 새는 게 의심되면 바로 돌립니다.

## 최소 권한

이렇게 권합니다.

* OAuth 커넥터는 읽기 전용을 채우는 가장 좁은 범위가 기본입니다.
* DB는 특정 스키마에 `SELECT`만 있는 Nora 전용 사용자를 만드세요.
* S3는 prefix 하나로 좁힌 IAM 정책을 쓰세요.
* 웹훅은 워크스페이스 전체 bearer가 아니라 엔드포인트별 토큰을 쓰세요.

범위 넓은 자격증명은 세우기 쉽지만, 새면 번지는 범위가 큽니다.

## 삭제

Flow나 파이프라인이 아직 커넥터를 쓰면 삭제가 실패합니다. 에러가 막는 것의 이름을 알려 주니 무엇을 먼저 고칠지 알 수 있습니다.

삭제는 감사됩니다([감사 트레일](/ko/reliable/versions/audit) 참고).

## 커스텀 auth

픽커에 없는 서비스는 **HTTP(일반)** 커넥터를 씁니다. 이런 걸 지원합니다.

* API key(`X-API-Key`나 커스텀 헤더).
* Bearer 토큰.
* Basic auth.
* OAuth 2.0 client credentials.
* 작은 pre-request 스크립트로 서명한 요청(고급).

Tool 별 헤더와 엮으면 사실상 어느 HTTP 서비스든 다룰 수 있습니다.

## 커넥터냐 Tool 이냐

* **커넥터** 다시 쓰는 자격증명, 특히 여러 Flow가 같은 서비스를 나눠 쓸 때.
* **Tool 블록** 인라인입니다. 자격증명이 Tool에 삽니다. 한 Flow에 바로 이은 일회성 연동에 맞습니다.

원칙은 이렇습니다. 두 Flow가 같은 자격증명을 쓸 거면 커넥터, 한 Flow 만이면 Tool 블록이 더 간단합니다.

## 관련

* [`nora connectors`](/ko/cli/connectors) 전체 CLI 레퍼런스.
* [파운더리 커넥터](/ko/build/foundry/connectors) 파이프라인이 커넥터를 쓰는 방법.
* [Google Workspace 워크스루](/ko/settings/connections/google-workspace) 가장 흔한 커넥터를 짚어 보는 셋업.
* [MCP](/ko/settings/connections/mcp) Nora를 다루는 코딩 에이전트용.