Granola MCP

Granola MCP

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

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

Granola поддерживает браузерную OAuth-авторизацию и Enterprise-Managed Authorization (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](#enterprise-managed-authorization) вместо стандартного процесса входа в Granola. Каждое подключение по-прежнему действует от имени отдельного пользователя Granola; для MCP не существует метода доступа через API-ключ или сервисную учётную запись.

Информация

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

Enterprise-Managed Authorization

Enterprise-Managed Authorization (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 у ресурса	URL документа метаданных Client ID MCP-клиента

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

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

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

Granola поддерживает конфиденциальных клиентов, которые аутентифицируются с помощью private_key_jwt через Client ID Metadata Document (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 у ресурса.

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

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

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

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

Информация

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

Если вы получаете сообщение о том, что ваш 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 за вас.

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

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

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

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

Спросите ваш ИИ-инструмент: **"Which Granola account am I signed in with?"** Он использует инструмент `get_account_info`, чтобы вернуть email и активное рабочее пространство, подключённые к MCP. Затем:

* **Правильный email, неправильное рабочее пространство**: переключите рабочее пространство в десктопном приложении Granola (нажмите на название рабочего пространства в левом верхнем углу и выберите нужное). MCP следует за вашим активным рабочим пространством, поэтому следующий запрос будет использовать его.
* **Совсем неправильный email**: выполните шаги из раздела **Signed into Claude with the wrong account** ниже (или аналогичного для вашего ИИ-инструмента), чтобы отключить и подключить правильный аккаунт.

Вот как переподключить Claude MCP с другим аккаунтом Granola:

1. Откройте окно инкогнито/приватного просмотра и войдите на claude.ai.
2. Перейдите в **Settings -> Connectors** и отключите Granola.
3. Оставаясь в инкогнито, снова подключите Granola. Это предложит вам войти снова, поэтому используйте email вашего основного аккаунта Granola.
4. После подключения вернитесь в обычный браузер — всё должно работать с правильным аккаунтом.

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

General FAQ

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

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

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

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

Также убедитесь, что MCP подключён к правильному аккаунту и активному рабочему пространству, спросив ваш ИИ-инструмент: **"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 FAQ

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

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

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