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

# Zoom 연결하기

> Zoom 앱을 하나 만들어 허브에 연결해, Claude가 회의 목록과 녹화, 요약, Zoom Docs를 보고 회의를 잡거나 옮기게 하는 방법을 설명합니다.

v0.41.0부터 허브는 Zoom도 연결합니다. 연결하고 나면 Claude에게 "지난주 회의 녹화
요약해 줘", "다음 주 화요일 오후 3시에 회의 잡아 줘"처럼 부탁하실 수 있습니다.

Notion이나 Railway와 달리 Zoom은 허브가 스스로 등록할 수 없습니다. 그래서 처음 한
번은 Zoom 쪽에 **앱을 하나 만들어** 그 앱의 Client ID와 Client secret을 허브에
넣어 주셔야 합니다. 구글 계정을 연결할 때 OAuth 클라이언트를 만드는 것과 같은
일입니다.

> [!NOTE]
>
> 만든 앱은 게시하지 않아도 됩니다. 게시하지 않은 앱은 그 앱을 만든 Zoom 계정 안의
> 사용자만 허용할 수 있습니다.

## 1. Zoom에서 앱 만들기

**1. General App을 만듭니다**

[Zoom App Marketplace](https://marketplace.zoom.us)에 로그인하고 오른쪽 위
**Develop** 메뉴에서 **Build App**을 누릅니다. 앱 종류는 **General App**을
고릅니다.

**Basic information**에서 **Select how the app is managed**는
**User-managed**로 둡니다.

**2. 리디렉션 주소를 두 곳에 넣습니다**

허브 관리 화면의 계정 추가 화면에서 Zoom을 고르면 입력 칸 아래에
`https://(내 허브 주소)/oauth/callback` 모양의 주소가 나옵니다. 이 주소를
복사해 Zoom 앱의 **OAuth information**에 있는 두 곳에 넣습니다.

* **OAuth redirect URL**
* **OAuth allow lists** (**Add allow list**를 눌러 추가)

![Zoom 앱의 Basic information 화면. App credentials의 Client ID와 Client secret, OAuth redirect URL 칸, OAuth allow lists 칸에 빨간 네모가 있다](https://mintcdn.com/mcp-hub/FLl27dfPWPBjJtLD/assets/zoom/01-zoom-app-credentials.png?fit=max\&auto=format\&n=FLl27dfPWPBjJtLD\&q=85\&s=1cfdf662128531eb5deb81125a760882)

같은 화면 위쪽 **App credentials**의 **Client ID**와 **Client secret**은
다음 단계에서 허브에 붙여 넣습니다.

**3. 권한(Scopes)을 넣습니다**

왼쪽에서 **Scopes**를 열고 **Add scopes**를 누릅니다. 검색 칸에 아래 이름을
하나씩 넣어 체크하고, 다 넣으면 **Done**을 누릅니다.

![Zoom의 Add scopes 창. 검색 칸과 Done 버튼에 빨간 네모가 있다](https://mintcdn.com/mcp-hub/FLl27dfPWPBjJtLD/assets/zoom/02-zoom-add-scopes.png?fit=max\&auto=format\&n=FLl27dfPWPBjJtLD\&q=85\&s=7b624e1b6ccae0c64cc82a1775d2b92b)

Zoom의 회의, 녹화, 검색, Docs를 읽고 쓰는 데 필요한 11개입니다.

* `meeting:read:search`
* `meeting:read:assets`
* `cloud_recording:read:list_user_recordings`
* `cloud_recording:read:content`
* `agentic_search:read:search`
* `agentic_search:read:ask`
* `docs:read:export`
* `docs:write:import`
* `hub:read:content`
* `hub:write:content`
* `my_notes:read:content`

회의를 만들고 옮기고 지우는 허브의 회의 도구에 필요한 6개입니다.

* `meeting:read:list_meetings`
* `meeting:read:meeting`
* `meeting:write:meeting`
* `meeting:update:meeting`
* `meeting:delete:meeting`
* `scheduler:read:list_scheduled_events`

![Zoom 앱의 Scopes 화면. Add scopes 버튼에 빨간 네모가 있고, 추가한 권한이 목록으로 보인다](https://mintcdn.com/mcp-hub/FLl27dfPWPBjJtLD/assets/zoom/03-zoom-scopes.png?fit=max\&auto=format\&n=FLl27dfPWPBjJtLD\&q=85\&s=eba102777e46aa0f786d269a05b0cb3b)

> [!WARNING]
>
> 앞의 11개 중 하나라도 빠지면 녹화와 검색 같은 Zoom 도구가 모두 권한 오류로
> 막힙니다. 빠진 채로 연결하면 허브 계정 목록에 **앱 권한 추가 필요**가
> 뜹니다. 그때는 Zoom 앱에 권한을 넣은 뒤 다시 연결하세요. 앱을 그대로 두고
> 다시 연결하면 같은 권한만 돌아옵니다.

`scheduler:read:list_scheduled_events`는 Zoom Scheduler 예약 목록용입니다.
Zoom 계정에 Scheduler 라이선스가 없으면 넣어도 예약 목록은 보이지 않고, 다른
기능에는 영향이 없습니다.

## 2. 허브에 계정 추가하기

**1. Zoom을 고르고 Client ID와 Client secret을 넣습니다**

관리 화면에서 **계정**을 열고 **계정 추가**를 누릅니다. **로그인할 곳**에서
**Zoom**을 고르고 계정 이름을 짧게 붙입니다. 나중에 Claude에게 "이 계정으로
해줘"라고 말씀하실 때 부르는 이름입니다. 영문 소문자, 숫자, `-`, `_`만
사용하실 수 있습니다.

**OAuth 클라이언트**는 **새 클라이언트를 직접 입력**을 고르고, Zoom 앱의
Client ID와 Client secret을 붙여 넣은 뒤 **계정 추가**를 누릅니다.

![계정 추가 화면. Zoom 카드, 계정 이름 칸, OAuth 클라이언트 ID와 시크릿 칸, 계정 추가 버튼에 빨간 네모가 있다](https://mintcdn.com/mcp-hub/FLl27dfPWPBjJtLD/assets/zoom/04-add-account-zoom.png?fit=max\&auto=format\&n=FLl27dfPWPBjJtLD\&q=85\&s=b036ea2ae1dbea8197a5bf310914812b)

**2. 지금 연결을 누릅니다**

![zoom 계정이 추가되었습니다 화면. 지금 연결 버튼에 빨간 네모가 있다](https://mintcdn.com/mcp-hub/FLl27dfPWPBjJtLD/assets/zoom/05-connect-now.png?fit=max\&auto=format\&n=FLl27dfPWPBjJtLD\&q=85\&s=2a0cb0708f1f5d99efa7b8d2fbdb3dc6)

**3. Zoom 화면에서 허용합니다**

Zoom 화면에 앱이 요청하는 권한 목록이 나옵니다. **Allow**를 누릅니다. 그
위의 "Allow this app to use my shared access permissions" 체크는 비워
두셔도 됩니다.

허브로 돌아오면 계정이 **연결됨**으로 표시됩니다.

**4. Claude의 도구 목록을 새로고침합니다**

[Claude의 도구 목록 새로고침](https://docs-hub.magicmealkits.com/ko/refresh-tools-list.md)을 한 뒤 새 대화에서
물어보세요.

## 같은 앱으로 다른 사람의 Zoom 붙이기

같은 회사의 다른 사람 Zoom을 붙일 때는 앱을 새로 만들 필요가 없습니다. 계정 추가
화면의 **OAuth 클라이언트** 목록에 저장된 Zoom 클라이언트가 나오니 그것을 고르고
**계정 추가**를 누르세요. Client secret은 다시 넣지 않아도 됩니다.

![계정 추가 화면의 OAuth 클라이언트 목록. 저장된 zoom 클라이언트와 계정 추가 버튼에 빨간 네모가 있다](https://mintcdn.com/mcp-hub/FLl27dfPWPBjJtLD/assets/zoom/06-second-account.png?fit=max\&auto=format\&n=FLl27dfPWPBjJtLD\&q=85\&s=f87d67f67ade97991acaef38455930fe)

> [!WARNING]
>
> **같은 사람의 Zoom을 계정 두 개로 붙이지 마세요.** Zoom은 한 사람, 한 앱에
> 로그인을 하나만 살려 둡니다. 두 번째 계정을 연결하는 순간 첫 번째 계정의
> 로그인이 끊기고, 둘이 번갈아 서로를 끊어 계속 다시 연결해야 하는 것처럼
> 보입니다. 이미 그렇게 붙였다면 하나를 지우고 남은 계정을 다시 연결하세요.

## Claude에게 이렇게 부탁해 보세요

* "지난주 Zoom 녹화 목록 보여 줘"
* "어제 회의 요약이랑 할 일 정리해 줘"
* "다음 주 화요일 오후 3시에 30분짜리 회의 잡아 줘"
* "내일 회의를 오후 4시로 옮겨 줘"

회의를 옮겨도 Zoom이 참석자에게 메일을 보내지는 않습니다. 참석자에게 따로
알려 주세요.

## 연결 끊기

두 군데 중 편한 곳에서 끊으시면 됩니다.

* 허브 관리 화면에서 계정을 지웁니다.
* Zoom App Marketplace의 **Manage**, **Added Apps**에서 앱을 지웁니다.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.