Granola MCP

Granola MCP

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

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

В настоящее время мы поддерживаем только аутентификацию через браузерный OAuth. Для других способов аутентификации, пожалуйста, отправьте отзыв на hey@granola.so.

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

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

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

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

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

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

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

3. Перейдите в Коннекторы, найдите 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 и выберите 'Аутентифицироваться'
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** — сервер использует браузерный OAuth, поэтому ваш инструмент должен иметь возможность открыть окно браузера для входа пользователя в Granola. После входа инструмент получает токен-носитель для включения в последующие запросы.

Каждый пользователь аутентифицируется индивидуально через браузерный поток OAuth. Не существует метода доступа по API-ключу или сервисному аккаунту для MCP.

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

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

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

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

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

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

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

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

<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, неправильное рабочее пространство**: переключите рабочее пространство в десктопном приложении Granola (нажмите на название вашего рабочего пространства в левом верхнем углу и выберите нужное). MCP следует за вашим активным рабочим пространством, поэтому следующий запрос будет использовать его.
* **Полностью неправильный email**: выполните шаги в разделе **Вход в Claude выполнен под неправильным аккаунтом** ниже (или аналогичные для вашего ИИ-инструмента), чтобы отключиться и переподключиться с правильным аккаунтом.

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

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

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

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

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

* **Бесплатный тариф:** Ваши собственные заметки за последние 30 дней.
* **Платные тарифы:** Ваши собственные заметки, а также заметки, которыми с вами поделились, и заметки в приватных папках, в которых вы состоите.

MCP может получать доступ только к папкам в вашем пространстве "Мои заметки" (приватном). Папки в пространстве команды никогда не доступны через MCP, даже если вы их создали и явно добавили всех участников.

Чтобы сделать папку пространства команды доступной через MCP, переместите ее из пространства команды в "Мои заметки", используя настройки общего доступа к папке, затем явно добавьте каждого участника команды, которому нужен доступ. Обратите внимание, что эти папки больше не будут видны всему рабочему пространству по умолчанию.

Это должно произойти немедленно, и вы получите доступ к дополнительным инструментам и повышенным лимитам скорости при следующем запросе. Нет. Granola MCP использует браузерный OAuth с динамической регистрацией клиентов (DCR), что означает, что учетные данные обрабатываются автоматически. Вам не нужно генерировать или вводить какой-либо идентификатор клиента или секрет клиента.

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

Да — любой инструмент, реализующий [спецификацию MCP-клиента](https://modelcontextprotocol.io/) с транспортом Streamable HTTP, может подключиться к Granola MCP. Вашему инструменту потребуется обрабатывать поток браузерной аутентификации OAuth 2.0, чтобы каждый пользователь мог войти в свой аккаунт Granola. Смотрите раздел "Другие ИИ-инструменты" выше для получения технических деталей.

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

Вопросы по Enterprise

Да, MCP доступен для клиентов Enterprise. Администраторы могут включить MCP для своего рабочего пространства, перейдя в **Настройки → Рабочее пространство > Общие** и включив переключатель MCP.

<img src="https://mintcdn.com/granola-c3940166/rTtxUdgB05Bp81mq/help-center/sharing/integrations/mcp-enterprise-toggle.png?fit=max&auto=format&n=rTtxUdgB05Bp81mq&q=85&s=4932feaa5122c0254d19ea94a224f35f" alt="MCP toggle in workspace settings" width="1200" height="217" data-path="help-center/sharing/integrations/mcp-enterprise-toggle.png" />

MCP отключен по умолчанию для всех участников рабочего пространства. Администраторы могут включить его в **Настройки → Рабочее пространство > Общие**. Переключатель MCP находится в разделе **Настройки → Рабочее пространство > Общие**. Все участники корпоративного рабочего пространства видят этот переключатель, но изменять его могут только администраторы — для остальных он будет неактивен с подсказкой «Только администраторы рабочего пространства могут редактировать». Если вам нужно включить MCP, попросите администратора вашего рабочего пространства активировать его. Мы разрабатываем дополнительные корпоративные возможности, включая расширенный контроль доступа, мониторинг использования и аналитику, повышенные лимиты запросов и гибкие варианты ценообразования (подробнее об этом скоро!)