Granola MCP

공식

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

Granola MCP(으)로 무엇을 할 수 있나요?

  • 회의 노트 검색 — 어시스턴트에게 query_granola_meetings를 사용해 과거 회의에서 특정 주제, 결정, 논의를 찾아달라고 요청하세요.
  • 회의 폴더 목록 보기list_meeting_folders를 사용해 접근 가능한 폴더를 탐색하세요. 제목, 설명, 노트 수가 포함됩니다(유료 플랜 전용).
  • 회의 세부 정보 가져오기get_meetings로 특정 회의의 노트, 참석자, 날짜, 요약된 내용을 불러오세요.
  • 액션 아이템 추출 — 프로젝트 회의에서 get_meetings를 통해 개인별 남은 액션 아이템이나 결정 사항을 요청하세요.
  • 대화록 접근get_meeting_transcript로 원본 대화록을 가져와 정확한 인용문을 확보하거나 논의 내용을 명확히 하세요(유료 플랜 전용).
  • 계정 연결 확인get_account_info를 사용해 현재 활성화된 Granola 계정과 워크스페이스를 확인하세요.

문서

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를 선택한 후 '인증'을 선택합니다
5. Claude에게 회의를 참조하도록 요청합니다
공개 URL{" "} [https://mcp.granola.ai/mcp](https://mcp.granola.ai/mcp)을(를) 사용자 지정 연결로 사용하여 Granola MCP에 수동으로 연결할 수 있습니다.
AI 도구는 다음을 지원해야 합니다:

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

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

정보

스크립트, 자동화 또는 사용자 지정 통합을 위해 API 키 액세스가 필요한 경우 Granola API를 대신 참조하세요.

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에 따라 필드 이름이 다르거나 일부 값을 자동으로 유추할 수 있습니다.
필드
리소스 URLhttps://mcp.granola.ai/mcp
발급자 URLhttps://mcp-auth.granola.ai
ID-JAG 대상 그룹https://mcp-auth.granola.ai
범위mcp
리소스의 클라이언트 IDMCP 클라이언트의 클라이언트 ID 메타데이터 문서 URL
  1. 적절한 사용자 또는 그룹을 Granola와 MCP 클라이언트 모두에 할당한 다음 관리형 리소스 연결을 활성화합니다.

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

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

Granola는 클라이언트 ID 메타데이터 문서(CIMD)를 통해 private_key_jwt로 인증하는 기밀 클라이언트를 지원합니다. 이를 통해 클라이언트는 Granola가 발급한 클라이언트 비밀번호 대신 자체 키 쌍으로 인증할 수 있습니다.

클라이언트는 MCP EMA 확장을 구현하고, 회사 IdP에서 ID-JAG를 획득하며, private_key_jwtjwks_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. 리소스의 클라이언트 IDhttps://claude.ai/oauth/mcp-oauth-client-metadata를 사용합니다.

도구 및 설명

도구설명예시 프롬프트
query_granola_meetingsGranola와 채팅전체 채팅 예시 보기
list_meeting_folders유료 플랜 전용 — 폴더 ID, 제목, 설명 및 노트 수를 포함하여 액세스할 수 있는 폴더를 나열합니다.액세스할 수 있는 회의 폴더는 무엇인가요?
list_meetings회의 ID, 제목, 날짜 및 참석자를 포함하여 액세스할 수 있는 회의 노트를 나열합니다. 유료 플랜에서는 폴더별로 필터링할 수 있습니다.지난주에 Sam과 가진 회의는 무엇인가요?
get_meetings회의 ID, 제목, 날짜, 참석자, 개인 노트 및 요약 노트를 포함하여 액세스할 수 있는 회의 노트를 읽습니다.이 프로젝트에서 각 사람의 남은 실행 항목은 무엇인가요?
get_meeting_transcript유료 플랜 전용 — 대화 기록을 확대하여 회의 ID, 원본 대화 기록을 포함합니다.팀이 문제를 설명한 방식에 대한 구체적인 인용문을 제공하세요
get_account_info이 MCP 세션에 현재 연결된 Granola 계정의 이메일과 활성 작업 공간을 반환합니다. 여러 계정(예: 개인 + 업무)이 있을 때 올바른 Granola 계정에 연결되었는지 확인하는 데 유용합니다.현재 로그인된 Granola 계정은 무엇인가요?

문제 해결 가이드

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

정보

Basic(무료) 플랜을 사용 중인 경우 최근 30일 이내의 노트만 조회할 수 있습니다.

LLM 에이전트가 회의 노트에 액세스할 수 없거나 Granola MCP 도구를 사용할 수 없다는 메시지가 표시되면 다시 인증을 시도하세요. Granola가 Claude에 연결되어 있지만 **사용 가능한 도구 없음(No tools available)**이 표시되는 경우, Claude에서 Granola 커넥터를 다시 연결하여 연결을 재설정하세요:
1. 웹에서 [Claude 커넥터 설정](https://claude.ai/customize/connectors)으로 이동합니다. Claude 데스크톱 앱을 사용하는 경우에도 claude.ai에서 이 작업을 수행해야 합니다.
2. **Granola**를 선택합니다.
3. 오른쪽 상단의 점 3개 메뉴를 클릭합니다.
4. **연결 끊기(Disconnect)**를 선택합니다.
5. 페이지를 새로고침하거나 다른 곳으로 이동하지 말고 **연결(Connect)**을 다시 선택하고 인증을 완료합니다.

정보

Claude Team 또는 Enterprise 요금제를 사용 중인 경우, 워크스페이스 관리자가 Granola를 연결 해제하고 다시 연결해 주어야 할 수 있습니다.

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는 활성 워크스페이스를 따르므로 다음 쿼리에서 해당 워크스페이스를 사용합니다.
* **이메일 자체가 잘못된 경우**: 아래의 **잘못된 계정으로 Claude에 로그인됨** 아코디언(또는 해당 AI 도구에 해당하는 항목)의 단계에 따라 올바른 계정으로 연결을 끊고 다시 연결하세요.
다른 Granola 계정으로 Claude MCP를 다시 연결하는 방법은 다음과 같습니다:
1. 시크릿/개인 브라우징 창을 열고 claude.ai에 로그인합니다.
2. **설정 → 커넥터**로 이동하여 Granola를 연결 해제합니다.
3. 시크릿 창에서 Granola를 다시 연결합니다. 다시 로그인하라는 메시지가 표시되므로 기본 Granola 계정 이메일을 사용하세요.
4. 연결이 완료되면 일반 브라우저로 돌아가면 올바른 계정으로 작동합니다.

일반적인 연결 해제/재연결로 이 문제가 해결되지 않는 이유는 기존 Granola 세션이 활성 상태로 유지되어 로그인 단계를 건너뛰기 때문입니다. 시크릿 창은 새 로그인을 강제하여 올바른 계정을 선택할 수 있게 합니다.

일반 FAQ

아니요, AI 도구와 Granola에 다른 계정을 사용할 수 있습니다. AI 도구가 액세스할 Granola 계정을 인증하면 됩니다. Granola 계정이 사용하는 이메일을 확인하려면 Granola 앱을 열고 **설정**( + , (macOS), Ctrl + , (Windows))으로 이동하세요 — 계정 이메일은 왼쪽 상단의 프로필 사진 아래에 표시됩니다. 먼저 자신에게 적용되는 액세스 범위를 확인하세요:
* **기본(무료):** 최근 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. **개인 노트**, **공개 노트**, 둘 다 또는 둘 다 아님을 활성화합니다.
액세스는 워크스페이스의 현재 MCP 구성에 따라 달라집니다. 두 범위 모두 활성화되지 않은 경우, 관리자가 개인 노트, 공개 노트 또는 둘 다를 활성화할 때까지 구성원은 MCP에 액세스할 수 없습니다. 컨트롤은 **설정 → 워크스페이스 → 일반 → 앱 및 커넥터 → 구성원의 MCP 액세스** 아래에 있습니다. 모든 엔터프라이즈 워크스페이스 구성원이 설정을 볼 수 있지만 관리자만 변경할 수 있습니다. 다른 범위가 필요하면 워크스페이스 관리자에게 문의하세요. 아닙니다. 컨트롤은 관리자가 아닌 워크스페이스 구성원이 MCP를 통해 액세스할 수 있는 항목을 결정합니다. 엔터프라이즈 관리자는 MCP를 통해 개인 노트와 공개 노트 모두에 액세스할 수 있습니다.