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

# 연결 개요

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