Granola MCP

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

Указатель документации

Полный указатель документации доступен по адресу: https://docs.granola.ai/llms.txt Используйте этот файл, чтобы найти все доступные страницы перед дальнейшим изучением.

Granola MCP

Подключайте Claude, ChatGPT и другие ИИ-инструменты к своим заметкам о встречах Granola через MCP. Ищите заметки, просматривайте транскрипты и получайте инсайты о встречах в ваших любимых ИИ-ассистентах.

Подключайте свои ИИ-инструменты к заметкам о встречах Granola с помощью Granola MCP. После подключения вы сможете: искать по заметкам о встречах, находить конкретные темы, обсуждавшиеся на прошлых встречах, просматривать папки встреч, извлекать пункты действий или решения из заметок, отвечать на вопросы на основе истории встреч и многое другое.

Granola поддерживает браузерную OAuth-авторизацию и корпоративную управляемую авторизацию (EMA) для совместимых поставщиков удостоверений и MCP-клиентов.

Что может получить доступ через MCP

Granola MCP подключается как отдельный пользователь через браузерную OAuth. При использовании EMA доступом управляет поставщик удостоверений организации. Оба метода возвращают заметки, к которым пользователь имеет доступ и которые принадлежат активному рабочему пространству Granola пользователя, с учетом областей доступа, указанных ниже.

Заметки из других рабочих пространств Granola не включаются, даже если они видны в активном рабочем пространстве через общий доступ.

Область доступа	Что она может получить
Личные заметки	Заметки, которыми вы владеете в активном рабочем пространстве Заметки в активном рабочем пространстве, предоставленные вам напрямую Заметки в частных папках активного рабочего пространства, предоставленные вам
Публичные заметки	Заметки, видимые всем в активном рабочем пространстве Заметки в командном пространстве активного рабочего пространства

Ваш тарифный план и настройки рабочего пространства определяют, какие области доступа использует MCP:

План	Доступ MCP
Basic (Бесплатный)	Личные заметки за последние 30 дней. Некоторые инструменты для папок, поиска и транскриптов доступны только на платных тарифах.
Business	Личные и публичные заметки.
Enterprise	Администраторы рабочего пространства могут настраивать, какие области доступа доступны участникам. Если ни одна область не включена, участники не могут использовать Granola MCP.

MCP следует за активным рабочим пространством, выбранным в приложении Granola. Если вы принадлежите более чем к одному рабочему пространству, переключите рабочее пространство в Granola перед тем, как задать следующий вопрос вашему ИИ-инструменту. MCP не объединяет заметки из нескольких рабочих пространств.

Руководство по настройке

Предварительные требования

• Учетная запись Granola с существующими заметками о встречах
• ИИ-инструмент, поддерживающий MCP, например Claude или ChatGPT

Как подключиться

1. Откройте и войдите в Claude

2. Перейдите в Настройки

3. Перейдите в раздел Connectors, найдите Granola

4. Подключитесь, пройдите аутентификацию и убедитесь, что переключатель
   включен при общении

1. Откройте и войдите в ChatGPT 2. Перейдите в Настройки 3. Найдите «Granola» и подключитесь 4. Теперь вы можете использовать @Granola или просто попросить сослаться на ваши встречи в ChatGPT 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 сослаться на ваши встречи

Вы можете вручную подключиться к Granola MCP, используя публичный URL{" "} [https://mcp.granola.ai/mcp](https://mcp.granola.ai/mcp) в качестве пользовательского подключения.

Ваш ИИ-инструмент должен поддерживать:

* **Протокол MCP-клиента** с использованием [Streamable HTTP transport](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)
* **OAuth 2.0 аутентификацию и обнаружение метаданных** — для стандартного подключения ваш инструмент должен уметь открывать окно браузера для входа пользователя в Granola. После входа инструмент получает bearer-токен для включения в последующие запросы.

Корпоративные клиенты могут использовать [корпоративную управляемую авторизацию](#enterprise-managed-authorization) вместо стандартного процесса входа в Granola. Каждое подключение по-прежнему действует от имени отдельного пользователя Granola; для MCP не существует API-ключа или метода доступа через сервисную учетную запись.

<Info>
  Если вам нужен доступ через API-ключ для скриптов, автоматизации или
  пользовательских интеграций, обратитесь к нашей [Granola API](./granola-api).
</Info>

Корпоративная управляемая авторизация

Корпоративная управляемая авторизация (EMA) позволяет вашей компании контролировать доступ к Granola MCP через своего поставщика удостоверений (IdP). Пользователи входят в свой MCP-клиент с корпоративной учетной записью, и IdP решает, могут ли они подключаться к Granola.

Ваш IdP контролирует, кто может подключаться. Настройки рабочего пространства Granola контролируют, к каким заметкам они могут получить доступ.

Перед началом работы

Вам понадобятся:

• Корпоративное рабочее пространство Granola с настроенным SSO
• IdP и MCP-клиент, поддерживающие EMA (Granola протестирована с Claude и Okta)
• Права администратора в рабочем пространстве Granola и IdP, или помощь соответствующих администраторов

У каждого пользователя уже должна быть учетная запись Granola, связанная с его корпоративной идентичностью. Если они еще не использовали корпоративный SSO с Granola, попросите их один раз войти в Granola через SSO перед использованием EMA.

Настройка 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
Client ID at resource	URL документа метаданных Client ID MCP-клиента

5. Назначьте соответствующих пользователей или группы как для Granola, так и для MCP-клиента, затем активируйте управляемое ресурсное подключение.

При использовании EMA назначенные пользователи не проходят отдельный процесс согласия OAuth Granola. Их доступ остается подчиненным как политике вашего IdP, так и настройкам доступа MCP, настроенным в Granola.

Если ваша компания создает собственный MCP-клиент

Granola поддерживает конфиденциальных клиентов, которые аутентифицируются с помощью private_key_jwt через документ метаданных Client ID (CIMD). Это позволяет вашему клиенту аутентифицироваться с помощью собственной пары ключей вместо секрета клиента, выданного Granola.

Ваш клиент должен реализовать расширение MCP EMA, получить ID-JAG от IdP компании и опубликовать публичный HTTPS-документ метаданных, который объявляет private_key_jwt и jwks_uri. Используйте метаданные OAuth Granola для обнаружения поддерживаемых возможностей и конечных точек, и используйте точный объявленный эмитент в качестве аудитории клиентского утверждения.

См. спецификацию MCP EMA для полных требований протокола.

Пример: Claude и Okta

Granola протестирована с EMA и Claude и Okta Cross App Access (XAA):

1. В Okta добавьте интеграцию Granola.
2. Откройте вкладку Resource server и включите Cross App Access (XAA).
3. Следуйте инструкциям Okta по настройке коннектора сервера ресурсов между Claude и Granola.
4. Используйте https://claude.ai/oauth/mcp-oauth-client-metadata в качестве Client ID at resource.

Инструменты и описания

Инструмент	Описание	Примеры запросов
query_granola_meetings	Общение с Granola	См. полные примеры общения здесь
list_meeting_folders	Только на платных тарифах — Список папок, к которым у вас есть доступ, включая ID папки, название, описание и количество заметок.	К каким папкам встреч у меня есть доступ?
list_meetings	Список заметок о встречах, к которым у вас есть доступ, включая ID встречи, название, дату и участников. Можно фильтровать по папке на платных тарифах.	Какие встречи у меня были с Сэмом на прошлой неделе?
get_meetings	Чтение заметок о встречах, к которым у вас есть доступ, включая ID встречи, название, дату, участников, личные заметки и сводные заметки.	Какие оставшиеся пункты действий для каждого человека по этому проекту?
get_meeting_attachment	Просмотр скриншотов экранов, показанных во время встречи, таких как слайды, диаграммы или код.	Что было на слайде с ценами на сегодняшнем обзоре?
get_meeting_transcript	Только на платных тарифах — Увеличение транскриптов, включает: ID встречи, сырой транскрипт	Приведите конкретные цитаты о том, как команда описала проблему
get_account_info	Возвращает email, активное рабочее пространство и присоединенные рабочие пространства для учетной записи Granola, подключенной к этой MCP-сессии — полезно для подтверждения того, что вы подключили правильную учетную запись Granola, если у вас их несколько (например, личная + рабочая)	В какую учетную запись Granola я вошел?
switch_workspace	Доступно только если вы принадлежите более чем к одному рабочему пространству — Изменение активного рабочего пространства Granola. Это также изменяет его в приложении Granola и в любых других ИИ-инструментах, подключенных к вашей учетной записи.	Переключите мое рабочее пространство Granola на Acme
sign_out	Выход этого ИИ-инструмента из вашей учетной записи Granola. Чтобы использовать другую учетную запись, повторно подключите Granola после этого.	Выйдите из Granola

Руководство по устранению неполадок

Лимиты запросов будут варьироваться в зависимости от вашего тарифного плана Granola и используемого MCP-инструмента. Лимиты запросов в настоящее время в среднем составляют около 100 запросов в минуту для всех инструментов. Лимиты запросов могут быть изменены.

<Info>
  Если вы на тарифе Basic (Бесплатный), вы можете запрашивать только заметки
  за последние 30 дней.
</Info>

Если вы получаете сообщение о том, что ваш LLM-агент не может получить доступ к вашим заметкам о встречах или использовать инструменты Granola MCP, попробуйте пройти аутентификацию заново. Если Granola подключена в Claude, но отображается **No tools available**, переподключите коннектор Granola в Claude, чтобы сбросить подключение:

1. Перейдите в [настройки коннектора Claude](https://claude.ai/customize/connectors) в веб-версии. Вы должны сделать это на claude.ai, даже если используете десктопное приложение Claude.
2. Выберите **Granola**.
3. Нажмите на меню из трех точек в правом верхнем углу.
4. Выберите **Disconnect**.
5. Не обновляя страницу и не переходя на другие страницы, выберите **Connect** снова
   и завершите аутентификацию.

<Info>
  Если вы на тарифе Claude Team или Enterprise, возможно, потребуется, чтобы
  администратор рабочего пространства отключил и снова подключил Granola за вас.
</Info>

Если вы видите эту ошибку после завершения процесса входа OAuth, возможно, вы прошли аутентификацию с другим адресом электронной почты, чем тот, под которым зарегистрирована ваша учетная запись Granola.

Чтобы проверить, какой email использует ваша учетная запись Granola, откройте приложение Granola и перейдите в **Настройки** (<kbd>⌘</kbd> + <kbd>,</kbd> на macOS, <kbd>Ctrl</kbd> + <kbd>,</kbd> на Windows). Email вашей учетной записи отображается под вашим профилем в левом верхнем углу.

При повторном подключении MCP убедитесь, что вы входите с тем же адресом электронной почты во время процесса OAuth.

Если ваш ИИ-инструмент сообщает, что не может найти заметки, или возвращает пустые результаты, когда вы знаете, что у вас есть встречи, MCP может быть подключен к неправильной учетной записи Granola или неправильному рабочему пространству в правильной учетной записи.

Спросите ваш ИИ-инструмент: **«В какую учетную запись Granola я вошел?»** Он использует инструмент `get_account_info`, чтобы вернуть email и активное рабочее пространство, подключенные к MCP. Затем:

• Правильный email, но не тот workspace: переключите workspace в десктопном приложении Granola (нажмите на название вашего workspace в левом нижнем углу и выберите нужный). MCP следует за вашим активным workspace, поэтому следующий запрос будет использовать его. Вы также можете попросить ваш ИИ-инструмент переключить workspace за вас, например: "Switch my Granola workspace to [workspace name]."

  • Совсем неправильный email: выполните шаги в accordion Signed into Claude with the wrong account ниже (или аналогично для вашего ИИ-инструмента), чтобы отключиться и подключиться снова с правильным аккаунтом.
  Вот как переподключить Claude MCP с другим аккаунтом Granola:
  1. Попросите Claude выйти из Granola.
  2. Нажмите на ссылку mcp-auth.granola.ai/api/logout, которую он вам даст.
  3. Попросите Claude переподключиться к Granola и войдите с email вашего основного аккаунта Granola.

  Причина, по которой обычное отключение/подключение не решает проблему, в том, что ваша существующая сессия Granola остается активной, поэтому шаг входа пропускается. Выход через ссылку очищает эту сессию, что позволяет выбрать правильный аккаунт.

Общие вопросы

Нет, вы можете использовать разные аккаунты для вашего ИИ-инструмента и Granola. Вы аутентифицируете аккаунт Granola, к которому хотите предоставить доступ вашему ИИ-инструменту. Чтобы проверить, какой email использует ваш аккаунт Granola, откройте приложение Granola и перейдите в **Settings** (⌘ + , на macOS, Ctrl + , на Windows) — email вашего аккаунта отображается под вашим фото профиля в левом верхнем углу. Сначала проверьте, какие области доступа к вам применяются:

* **Basic (Free):** Личные заметки за последние 30 дней.
* **Business:** Личные заметки и публичные заметки.
* **Enterprise:** Администраторы workspace настраивают, какие области доступа доступны участникам.

Доступ к личным заметкам не включает каждую приватную заметку в workspace. Заметка должна быть вашей, быть предоставленной вам напрямую или находиться в приватной папке, доступ к которой вам предоставлен. Доступ к публичным заметкам включает заметки, видимые всем в workspace, включая заметки в пространстве Team.

MCP также возвращает только заметки, принадлежащие активному workspace. Если заметка была создана в другом workspace Granola, MCP не вернет её из вашего текущего workspace, даже если вы видите её в Granola.

Также убедитесь, что MCP подключен к правильному аккаунту и активному workspace, спросив ваш ИИ-инструмент: **"Which Granola account am I signed in with?"**

Это должно произойти немедленно, и вы получите доступ к дополнительным инструментам и повышенным лимитам запросов при следующем запросе. Для стандартного браузерного OAuth-подключения — нет. Granola MCP использует Dynamic Client Registration (DCR), что означает, что учетные данные обрабатываются автоматически. Вам не нужно генерировать или вводить какой-либо client ID или client secret.

Если вы используете стороннюю платформу (например, Composio), которая показывает поля client ID и client secret, оставьте их пустыми — платформа зарегистрируется в Granola автоматически при подключении.

Настройка EMA отличается. Ваш поставщик удостоверений может запросить **Client ID at resource** при создании управляемого подключения. Введите URL документа Client ID Metadata Document клиента MCP. Если вы используете существующий MCP-клиент, такой как Claude, используйте URL, предоставленный этим клиентом; вам не нужно создавать его самостоятельно или вводить client secret.

Если вы создаете собственный конфиденциальный MCP-клиент, вы создаете и размещаете его Client ID Metadata Document. URL документа является client ID, а клиент аутентифицируется с помощью своего приватного ключа, а не client secret, выданного Granola. См. [If your company builds its own MCP client](#if-your-company-builds-its-own-mcp-client).

Да — любой инструмент, реализующий [спецификацию MCP-клиента](https://modelcontextprotocol.io/) с транспортом Streamable HTTP, может подключиться к Granola MCP. Ваш инструмент может использовать браузерный OAuth или EMA, если он поддерживает расширение и ваша организация настроила совместимый IdP. См. разделы "Other AI tools" и [Enterprise-Managed Authorization](#enterprise-managed-authorization) выше.

Если вы создаете пользовательскую интеграцию и вам нужна помощь, свяжитесь с нами по адресу [hey@granola.so](mailto:hey@granola.so).

Вопросы для Enterprise

Да. Администраторы Enterprise могут настроить доступ к заметкам для участников workspace:

1. Перейдите в **Settings → Workspace → General**.
2. Найдите **MCP access** в разделе **Apps & connectors**.
3. Нажмите **Manage**.
4. Включите **Personal notes**, **Public notes**, оба варианта или ни один.

Чтобы запретить ИИ-инструментам читать транскрипты встреч, отключите **Meeting transcripts** в том же диалоге. Это применяется ко всем встречам в вашем workspace, для всех, у кого есть доступ, включая администраторов и людей, с которыми заметка была предоставлена. Заметки и сводки остаются доступными. По умолчанию эта опция включена.

Доступ зависит от текущей конфигурации MCP в workspace. Если ни одна область доступа не включена, участники не имеют доступа к MCP, пока администратор не включит личные заметки, публичные заметки или оба варианта. Элементы управления находятся в **Settings → Workspace → General → Apps & connectors → MCP access**. Все участники Enterprise workspace могут видеть настройку, но только администраторы могут её изменять. Если вам нужна другая область доступа, обратитесь к администратору вашего workspace. Элементы управления доступом к заметкам — нет. Они определяют, к чему могут получить доступ участники workspace, не являющиеся администраторами, через MCP. Администраторы Enterprise могут получить доступ и к личным, и к публичным заметкам через MCP.

Переключатель **Meeting transcripts** применяется ко всем, включая администраторов.

Эта документация создана и размещена на Mintlify, платформе для документации разработчиков.