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

# 연결 개요

> Nora 가 팀이 이미 쓰는 시스템과 어떻게 대화하는지.

Nora 가 외부 시스템과 세 방법으로 통합:

* **커넥터** — 서비스 (Google Drive, S3, DB 등) 의 저장된 자격증명. 셋업하면 워크스페이스의 어느 Flow 든 파이프라인이든 사용 가능.
* **MCP** — 코딩 에이전트 친화적 표면. Claude Desktop, Cursor, 어느 MCP 호스트에서든 Nora 조작.
* **커스텀 HTTP** — 어느 REST API 든. 플러그인 없이 엔드포인트 설명하는 Tool 블록만.

셋 다 Settings 에서 관리.

## 카테고리

<CardGroup cols={2}>
  <Card title="커넥터" icon="plug" href="/ko/settings/connections/connectors">
    Google Drive, Notion, Slack, S3, DB, 일반 HTTP. 모든 재사용 자격증명 한 곳에.
  </Card>

  <Card title="Google Workspace" icon="google" href="/ko/settings/connections/google-workspace">
    가장 흔한 커넥터의 집중 워크스루 — Drive, Gmail, Calendar.
  </Card>

  <Card title="코딩 에이전트 (MCP)" icon="terminal" href="/ko/settings/connections/mcp">
    Claude Desktop, Cursor, 어느 MCP 호스트에게 워크스페이스 접근 부여.
  </Card>

  <Card title="커스텀 HTTP" icon="code" href="/ko/build/workflow/tool-block">
    어느 REST API 든 Tool 블록이 됨. 플러그인 불필요.
  </Card>
</CardGroup>

## Flow 에 어떻게 플러그되나

연결이 무엇을 하는지에 따라 다른 블록 타입에 나타남:

| 블록 타입          | 용도                                                |
| -------------- | ------------------------------------------------- |
| **DataSource** | 검색 / 읽기 통합 (Google Drive, 헬프 센터, 문서).             |
| **Tool**       | Agent 가 호출할 액션 통합 (Gmail 전송, Sheets 쓰기, 커스텀 API). |
| **Action**     | 답변 후 부수 효과 (Slack 알림, CRM 로그, 웹훅 아웃).             |
| **Trigger**    | Flow 시작하는 통합 (웹훅, 스케줄, MCP 호출).                   |

타입 수동 선택 안 함 — 통합과 캔버스에 드롭한 곳 기반으로 선택됨.

## 워크스페이스 레벨 모델

연결이 **워크스페이스** 레벨에 삶. 한 번 설정, 모든 Flow 에 재사용.

* **공유** — Flow 별 자격증명 중복 없음.
* **중앙에서 로테이션** — Google Drive 자격증명 한 곳에서 로테이션; 쓰는 모든 Flow 가 새 토큰 픽업.
* **감사 가능** — 워크스페이스 멤버가 어떤 연결이 존재하는지 봄. Owner 와 Manager 만 생성·로테이션.

## 서비스 연결

모든 연결이 같은 패턴 따름:

1. Settings → Connections → **New** 클릭.
2. 서비스 선택 (Google, Slack, S3, Postgres, ...).
3. OAuth 사인인 (대부분 서비스) 또는 자격증명 붙여넣기 (DB, 일반 HTTP).
4. 옵션으로 스코프 좁히기 (특정 폴더, 버킷 prefix, 채널).
5. 저장.

저장되면 자격증명이 저장 시 암호화되고 어떤 API 로도 반환 안 됨 — 앱이 여러분에게 다시 읽어줄 수 없음.

## 커스텀 통합

서비스가 목록에 없으면 두 옵션:

* **일반 HTTP 커넥터** — 표준 auth (API key, bearer, basic, OAuth 2.0 client credentials) 있는 어느 API 든. Flow 간 재사용.
* **커스텀 HTTP Tool 블록** — Flow 에 직접 배선된 일회성 엔드포인트용. [Tool 블록](/ko/build/workflow/tool-block) 참고.

둘 다 일급 — Nora 는 서비스와 작동하기 위해 "인증된" 통합 요구 안 함.

## 자격증명 로테이션

* **UI** — Settings → Connections → 연결 클릭 → **Rotate**.
* **CLI** — `nora connectors update <id> --rotate-api-key ?` ([커넥터 CLI](/ko/cli/connectors) 참고).

이전 자격증명이 60분 유예 기간 동안 계속 동작해 진행 중 실행 실패 안 함.

## 삭제

Flow 나 파이프라인이 여전히 연결 참조하면 실패. 먼저 그것들 업데이트, 그 다음 삭제. 감사 로그가 모든 삭제 기록.

## 관련 설정

<CardGroup cols={2}>
  <Card title="API 토큰" icon="key" href="/ko/settings/security/api-tokens">
    API/CLI 용 개인·워크스페이스 토큰.
  </Card>

  <Card title="Providers" icon="brain" href="/ko/settings/models/providers">
    LLM API 키 (OpenAI, Anthropic, Google 등).
  </Card>
</CardGroup>