Granola MCP

npx add-mcp 'https://mcp.granola.ai/mcp'

문서 색인

전체 문서 색인을 다음에서 확인하세요: https://docs.granola.ai/llms.txt 이 파일을 사용하여 더 탐색하기 전에 사용 가능한 모든 페이지를 확인하세요.

Granola MCP

Claude, ChatGPT 및 기타 AI 도구를 MCP를 통해 Granola 회의 노트에 연결하세요. 즐겨 사용하는 AI 어시스턴트에서 노트를 조회하고, 대화록을 검색하고, 회의 인사이트를 얻을 수 있습니다.

Granola MCP로 AI 도구를 Granola 회의 노트에 연결하세요. 연결이 완료되면 다음을 수행할 수 있습니다: 회의 노트 검색, 과거 회의에서 논의된 특정 주제 찾기, 회의 폴더 탐색, 노트에서 실행 항목이나 결정 사항 추출, 회의 기록을 기반으로 질문에 답변하기 등.

Granola는 호환 가능한 ID 공급자 및 MCP 클라이언트를 위한 브라우저 기반 OAuth 및 Enterprise-Managed Authorization(EMA)을 지원합니다.

MCP가 액세스할 수 있는 항목

Granola MCP는 브라우저 OAuth를 통해 개별 사용자로 연결됩니다. EMA를 사용하면 조직의 ID 공급자가 대신 액세스를 관리합니다. 두 방법 모두 아래 액세스 범위에 따라 사용자가 액세스할 수 있고 사용자의 활성 Granola 작업 공간에 속한 노트를 반환합니다.

공유를 통해 활성 작업 공간에 표시되더라도 다른 Granola 작업 공간의 노트는 포함되지 않습니다.

액세스 범위	액세스 가능한 항목
개인 노트	활성 작업 공간에서 본인이 소유한 노트 활성 작업 공간에서 본인과 직접 공유된 노트 활성 작업 공간의 비공개 폴더에서 본인과 공유된 노트
공개 노트	활성 작업 공간의 모든 사용자에게 표시되는 노트 활성 작업 공간의 팀 공간에 있는 노트

요금제 및 작업 공간 설정에 따라 MCP가 사용하는 범위가 결정됩니다:

요금제	MCP 액세스
Basic (무료)	최근 30일간의 개인 노트. 일부 폴더, 검색 및 대화록 도구는 유료 요금제에서만 사용할 수 있습니다.
Business	개인 노트 및 공개 노트.
Enterprise	작업 공간 관리자는 구성원에게 제공할 범위를 구성할 수 있습니다. 두 범위 모두 활성화되지 않은 경우 구성원은 Granola MCP를 사용할 수 없습니다.

MCP는 Granola 앱에서 선택된 활성 작업 공간을 따릅니다. 둘 이상의 작업 공간에 속한 경우, AI 도구에 다른 질문을 하기 전에 Granola에서 작업 공간을 전환하세요. MCP는 여러 작업 공간의 노트를 결합하지 않습니다.

설정 가이드

사전 요구 사항

• 기존 회의 노트가 있는 Granola 계정
• Claude 및 ChatGPT와 같은 MCP를 지원하는 AI 도구

연결 방법

1. Claude를 열고 로그인합니다

2. 설정으로 이동합니다

3. 커넥터로 이동하여 Granola를 검색합니다

4. 연결, 인증을 수행하고 채팅 시 활성화되어 있는지 확인합니다

1. ChatGPT를 열고 로그인합니다 2. 설정으로 이동합니다 3. 'Granola'를 검색하고 연결합니다 4. 이제 ChatGPT에서 @Granola를 사용하거나 회의를 참조하도록 요청할 수 있습니다 1. 터미널에서 `claude`을 실행합니다 2. 다음 명령을 실행합니다:

```bash theme={null}
  claude mcp add granola --transport http https://mcp.granola.ai/mcp
```

3. 새 터미널 탭을 열고 `claude`을 다시 실행합니다
4. `/mcp`을 실행하고 granola MCP를 선택한 다음 'Authenticate'를 선택합니다
5. Claude에게 회의를 참조하도록 요청합니다

공개 URL{" "}을 사용하여 Granola MCP에 수동으로 연결할 수 있습니다. [https://mcp.granola.ai/mcp](https://mcp.granola.ai/mcp) 사용자 지정 연결로.

AI 도구는 다음을 지원해야 합니다:

* [Streamable HTTP 전송](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)을 사용하는 **MCP 클라이언트 프로토콜**
* **OAuth 2.0 인증 및 메타데이터 검색** — 표준 연결의 경우 도구가 사용자가 Granola에 로그인할 수 있도록 브라우저 창을 열 수 있어야 합니다. 로그인 후 도구는 후속 요청에 포함할 bearer 토큰을 받습니다.

엔터프라이즈 클라이언트는 표준 Granola 로그인 흐름 대신 [Enterprise-Managed Authorization](#enterprise-managed-authorization)을 사용할 수 있습니다. 각 연결은 여전히 개별 Granola 사용자를 대신하여 작동합니다. MCP에는 API 키 또는 서비스 계정 액세스 방법이 없습니다.

<Info>
  스크립트, 자동화 또는 사용자 지정 통합을 위해 API 키 액세스가 필요한 경우 [Granola API](./granola-api)를 참조하세요.
</Info>

Enterprise-Managed Authorization

Enterprise-Managed Authorization(EMA)을 사용하면 회사가 ID 공급자(IdP)를 통해 Granola MCP에 대한 액세스를 제어할 수 있습니다. 사용자는 회사 계정으로 MCP 클라이언트에 로그인하고 IdP가 Granola에 연결할 수 있는지 여부를 결정합니다.

IdP는 연결할 수 있는 사용자를 제어합니다. Granola의 작업 공간 설정은 액세스할 수 있는 노트를 제어합니다.

시작하기 전에

다음이 필요합니다:

• SSO가 구성된 Granola Enterprise 작업 공간
• EMA를 지원하는 IdP 및 MCP 클라이언트 (Granola는 Claude 및 Okta로 테스트했습니다)
• Granola 작업 공간 및 IdP에 대한 관리자 액세스 권한 또는 관련 관리자의 도움

각 사용자는 이미 회사 ID와 연결된 Granola 계정이 있어야 합니다. 회사 SSO를 Granola와 함께 사용한 적이 없다면 EMA를 사용하기 전에 한 번 SSO로 Granola에 로그인하도록 요청하세요.

EMA 구성

1. Granola에서 왼쪽 하단 모서리의 작업 공간 이름을 클릭한 다음 설정을 선택합니다. 설정 → 작업 공간 → 일반 → 앱 및 커넥터 → MCP 액세스로 이동하여 회사가 허용하려는 노트 액세스를 활성화합니다.
2. IdP에서 Granola를 추가하거나 선택하고 관리된 권한 부여 또는 리소스 서버 기능을 활성화합니다.
3. MCP 클라이언트에서 Granola로 관리 리소스 연결을 생성합니다.
4. 아래 값을 입력합니다. IdP는 다른 필드 이름을 사용하거나 일부 값을 자동으로 유추할 수 있습니다.

필드	값
리소스 URL	https://mcp.granola.ai/mcp
발급자 URL	https://mcp-auth.granola.ai
ID-JAG 대상	https://mcp-auth.granola.ai
범위	mcp
리소스의 클라이언트 ID	MCP 클라이언트의 Client ID Metadata Document URL

5. 적절한 사용자 또는 그룹을 Granola와 MCP 클라이언트 모두에 할당한 다음 관리 리소스 연결을 활성화합니다.

EMA를 사용하면 할당된 사용자는 별도의 Granola OAuth 동의 흐름을 완료하지 않습니다. 해당 액세스는 IdP 정책과 Granola에서 구성된 MCP 액세스 모두에 적용됩니다.

회사가 자체 MCP 클라이언트를 구축하는 경우

Granola는 Client ID Metadata Document(CIMD)를 통해 private_key_jwt으로 인증하는 기밀 클라이언트를 지원합니다. 이를 통해 클라이언트는 Granola가 발급한 클라이언트 비밀 대신 자체 키 쌍으로 인증할 수 있습니다.

클라이언트는 MCP EMA 확장을 구현하고, 회사 IdP에서 ID-JAG를 획득하고, private_key_jwt 및 jwks_uri을 선언하는 공개 HTTPS 메타데이터 문서를 게시해야 합니다. Granola의 OAuth 메타데이터를 사용하여 지원되는 기능과 엔드포인트를 검색하고, 광고된 발급자를 클라이언트 어설션의 대상으로 정확히 사용하세요.

전체 프로토콜 요구 사항은 MCP EMA 사양을 참조하세요.

예시: Claude 및 Okta

Granola는 Claude 및 Okta Cross App Access(XAA)와 함께 EMA를 테스트했습니다:

1. Okta에서 Granola 통합을 추가합니다.
2. 리소스 서버 탭을 열고 **Cross App Access (XAA)**를 활성화합니다.
3. Okta의 지침에 따라 Claude와 Granola 간에 리소스 서버 커넥터를 구성합니다.
4. 리소스의 클라이언트 ID로 https://claude.ai/oauth/mcp-oauth-client-metadata을 사용합니다.

도구 및 설명

도구	설명	예시 프롬프트
query_granola_meetings	Granola와 채팅	전체 채팅 예시 보기
list_meeting_folders	유료 요금제 전용 — 폴더 ID, 제목, 설명 및 노트 수를 포함하여 액세스할 수 있는 폴더를 나열합니다.	내가 액세스할 수 있는 회의 폴더는 무엇인가요?
list_meetings	회의 ID, 제목, 날짜 및 참석자를 포함하여 액세스할 수 있는 회의 노트를 나열합니다. 유료 요금제에서는 폴더별로 필터링할 수 있습니다.	지난주에 Sam과 가진 회의는 무엇인가요?
get_meetings	회의 ID, 제목, 날짜, 참석자, 개인 노트 및 요약 노트를 포함하여 액세스할 수 있는 회의 노트를 읽습니다.	이 프로젝트에서 각 사람의 남은 실행 항목은 무엇인가요?
get_meeting_attachment	슬라이드, 차트 또는 코드와 같이 회의 중 공유된 화면의 스크린샷을 봅니다.	오늘 리뷰에서 가격 슬라이드에 무엇이 있었나요?
get_meeting_transcript	유료 요금제 전용 — 대화록을 확대하여 회의 ID, 원본 대화록을 포함합니다.	팀이 문제를 어떻게 설명했는지 구체적인 인용문을 제공하세요
get_account_info	이 MCP 세션에 현재 연결된 Granola 계정의 이메일, 활성 작업 공간 및 가입된 작업 공간을 반환합니다 — 여러 계정(예: 개인 + 업무)이 있을 때 올바른 Granola 계정에 연결되었는지 확인하는 데 유용합니다.	어떤 Granola 계정으로 로그인되어 있나요?
switch_workspace	둘 이상의 작업 공간에 속한 경우에만 사용 가능 — 활성 Granola 작업 공간을 변경합니다. 이는 Granola 앱 및 계정에 연결된 다른 AI 도구에서도 변경됩니다.	내 Granola 작업 공간을 Acme로 전환
sign_out	이 AI 도구를 Granola 계정에서 로그아웃합니다. 다른 계정을 사용하려면 이후에 Granola를 다시 연결하세요.	Granola에서 로그아웃

문제 해결 가이드

속도 제한은 Granola 구독 요금제와 사용 중인 MCP 도구에 따라 다릅니다. 속도 제한은 현재 모든 도구에서 분당 약 100회 요청입니다. 속도 제한은 변경될 수 있습니다.

<Info>
  Basic (무료) 요금제를 사용 중인 경우 최근 30일 이내의 노트만
  조회할 수 있습니다.
</Info>

LLM 에이전트가 회의 노트에 액세스할 수 없거나 Granola MCP 도구를 사용할 수 없다는 메시지가 표시되면 다시 인증해 보세요. Claude에서 Granola가 연결되었지만 **사용 가능한 도구 없음**이 표시되면 Claude에서 Granola 커넥터를 다시 연결하여 연결을 재설정하세요:

1. 웹에서 [Claude 커넥터 설정](https://claude.ai/customize/connectors)으로 이동합니다. Claude 데스크톱 앱을 사용하더라도 claude.ai에서 수행해야 합니다.
2. **Granola**를 선택합니다.
3. 오른쪽 상단의 점 3개 메뉴를 클릭합니다.
4. **연결 끊기**를 선택합니다.
5. 페이지를 새로 고치거나 이동하지 않고 **연결**을 다시 선택하고
   인증을 완료합니다.

<Info>
  Claude Team 또는 Enterprise 요금제를 사용 중인 경우 작업 공간
  관리자가 Granola를 연결 해제하고 다시 연결해야 할 수 있습니다.
</Info>

OAuth 로그인 흐름을 완료한 후 이 오류가 표시되면 Granola 계정이 등록된 이메일 주소와 다른 이메일 주소로 인증했을 수 있습니다.

Granola 계정이 사용하는 이메일을 확인하려면 Granola 앱을 열고 **설정**(<kbd>⌘</kbd> + <kbd>,</kbd> macOS에서, <kbd>Ctrl</kbd> + <kbd>,</kbd> Windows에서)으로 이동하세요. 계정 이메일은 왼쪽 상단의 프로필 사진 아래에 표시됩니다.

MCP를 다시 연결할 때 OAuth 흐름 중에 동일한 이메일 주소로 로그인해야 합니다.

AI 도구가 노트를 찾을 수 없다고 하거나 회의가 있는데 결과가 반환되지 않으면 MCP가 잘못된 Granola 계정 또는 올바른 계정 내의 잘못된 작업 공간에 연결되었을 수 있습니다.

AI 도구에 **"어떤 Granola 계정으로 로그인되어 있나요?"**라고 물어보세요. `get_account_info` 도구를 사용하여 현재 MCP에 연결된 이메일과 활성 작업 공간을 반환합니다. 그런 다음:

• 올바른 이메일, 잘못된 워크스페이스: Granola 데스크톱 앱에서 워크스페이스를 전환하세요(왼쪽 하단 모서리의 워크스페이스 이름을 클릭하고 올바른 것을 선택). MCP는 활성 워크스페이스를 따르므로 다음 쿼리에서 해당 워크스페이스를 사용합니다. AI 도구에 워크스페이스 전환을 요청할 수도 있습니다. 예: "내 Granola 워크스페이스를 [워크스페이스 이름]으로 전환해 줘."

• 이메일 자체가 잘못된 경우: 아래 Claude에 잘못된 계정으로 로그인됨 아코디언(또는 AI 도구에 해당하는 항목)의 단계를 따라 올바른 계정으로 연결을 끊고 다시 연결하세요.

  다른 Granola 계정으로 Claude MCP를 다시 연결하는 방법은 다음과 같습니다:
  1. Claude에게 Granola에서 로그아웃하도록 요청하세요.
  2. 제공된 mcp-auth.granola.ai/api/logout 링크를 클릭하세요.
  3. Claude에게 Granola에 다시 연결하도록 요청하고, 기본 Granola 계정 이메일로 로그인하세요.

  일반적인 연결 끊기/재연결로 이 문제가 해결되지 않는 이유는 기존 Granola 세션이 활성 상태로 유지되어 로그인 단계를 건너뛰기 때문입니다. 링크를 통해 로그아웃하면 해당 세션이 지워져 올바른 계정을 선택할 수 있습니다.

일반 FAQ

아니요, AI 도구와 Granola에 서로 다른 계정을 사용할 수 있습니다. AI 도구가 액세스할 수 있도록 하려는 Granola 계정을 인증하면 됩니다. Granola 계정이 사용하는 이메일을 확인하려면 Granola 앱을 열고 **설정**(macOS에서 ⌘ + ,, Windows에서 Ctrl + ,)으로 이동하세요. 계정 이메일은 왼쪽 상단의 프로필 사진 아래에 표시됩니다. 먼저 자신에게 적용되는 액세스 범위를 확인하세요:

* **기본(무료):** 최근 30일간의 개인 노트.
* **비즈니스:** 개인 노트 및 공개 노트.
* **엔터프라이즈:** 워크스페이스 관리자가 구성원에게 제공되는 범위를 구성합니다.

개인 노트 액세스에는 워크스페이스의 모든 비공개 노트가 포함되지 않습니다. 노트는 본인 소유이거나, 직접 공유되었거나, 공유된 비공개 폴더에 있어야 합니다. 공개 노트 액세스에는 워크스페이스의 모든 사용자에게 표시되는 노트(팀 공간의 노트 포함)가 포함됩니다.

MCP는 또한 활성 워크스페이스에 속한 노트만 반환합니다. 다른 Granola 워크스페이스에서 생성된 노트는 Granola에서 볼 수 있더라도 현재 워크스페이스에서 MCP가 반환하지 않습니다.

또한 AI 도구에 **"내가 로그인한 Granola 계정은 무엇인가요?"**라고 물어 MCP가 올바른 계정과 활성 워크스페이스에 연결되어 있는지 확인하세요.

이 작업은 즉시 이루어져야 하며, 다음 쿼리에서 추가 도구와 업그레이드된 속도 제한에 액세스할 수 있습니다. 표준 브라우저 OAuth 연결의 경우, 아닙니다. Granola MCP는 DCR(동적 클라이언트 등록)을 사용하므로 자격 증명이 자동으로 처리됩니다. 클라이언트 ID나 클라이언트 시크릿을 생성하거나 입력할 필요가 없습니다.

클라이언트 ID 및 클라이언트 시크릿 필드를 표시하는 타사 플랫폼(예: Composio)을 사용하는 경우 해당 필드를 비워 두세요. 연결 시 플랫폼이 Granola에 자동으로 등록됩니다.

EMA 설정은 다릅니다. 관리형 연결을 만들 때 ID 공급자가 **리소스의 클라이언트 ID**를 요청할 수 있습니다. MCP 클라이언트의 클라이언트 ID 메타데이터 문서 URL을 입력하세요. Claude와 같은 기존 MCP 클라이언트를 사용하는 경우 해당 클라이언트가 제공하는 URL을 사용하세요. 직접 만들거나 클라이언트 시크릿을 입력할 필요가 없습니다.

자체 기밀 MCP 클라이언트를 구축하는 경우 클라이언트 ID 메타데이터 문서를 직접 생성하고 호스팅합니다. 문서의 URL이 클라이언트 ID이며, 클라이언트는 Granola에서 발급한 클라이언트 시크릿이 아닌 개인 키로 인증합니다. [회사가 자체 MCP 클라이언트를 구축하는 경우](#if-your-company-builds-its-own-mcp-client)를 참조하세요.

예 — Streamable HTTP 전송으로 [MCP 클라이언트 사양](https://modelcontextprotocol.io/)을 구현하는 모든 도구는 Granola MCP에 연결할 수 있습니다. 도구는 브라우저 OAuth를 사용하거나, 확장을 지원하고 조직이 호환 가능한 IdP를 구성한 경우 EMA를 사용할 수 있습니다. 위의 "기타 AI 도구" 및 [엔터프라이즈 관리 인증](#enterprise-managed-authorization) 섹션을 참조하세요.

사용자 지정 통합을 구축 중이고 도움이 필요하면 [hey@granola.so](mailto:hey@granola.so)로 문의하세요.

엔터프라이즈 FAQ

예. 엔터프라이즈 관리자는 워크스페이스 구성원이 사용할 수 있는 노트 액세스를 구성할 수 있습니다:

1. **설정 → 워크스페이스 → 일반**로 이동하세요.
2. **앱 및 커넥터**에서 **MCP 액세스**를 찾으세요.
3. **관리**를 클릭하세요.
4. **개인 노트**, **공개 노트**, 둘 다 또는 둘 다 아님을 활성화하세요.

AI 도구가 회의 기록을 읽지 못하게 하려면 같은 대화 상자에서 **회의 기록**을 끄세요. 이 설정은 워크스페이스의 모든 회의에 적용되며, 액세스할 수 있는 모든 사람(관리자 및 노트가 공유된 사람 포함)에게 적용됩니다. 노트와 요약은 계속 사용할 수 있습니다. 기본적으로 켜져 있습니다.

액세스는 워크스페이스의 현재 MCP 구성에 따라 달라집니다. 두 범위 모두 활성화되지 않은 경우, 관리자가 개인 노트, 공개 노트 또는 둘 다를 활성화할 때까지 구성원은 MCP 액세스 권한이 없습니다. 컨트롤은 **설정 → 워크스페이스 → 일반 → 앱 및 커넥터 → MCP 액세스** 아래에 있습니다. 모든 엔터프라이즈 워크스페이스 구성원은 설정을 볼 수 있지만 변경할 수 있는 사람은 관리자뿐입니다. 다른 범위가 필요하면 워크스페이스 관리자에게 문의하세요. 노트 액세스 컨트롤은 그렇지 않습니다. 이 컨트롤은 관리자가 아닌 워크스페이스 구성원이 MCP를 통해 액세스할 수 있는 항목을 결정합니다. 엔터프라이즈 관리자는 MCP를 통해 개인 노트와 공개 노트 모두에 액세스할 수 있습니다.

**회의 기록** 스위치는 관리자를 포함한 모든 사람에게 적용됩니다.

이 문서는 개발자 문서 플랫폼인 Mintlify에서 구축 및 호스팅됩니다.