Hedy MCP Server: руководство разработчика по 25 инструментам и доступу к API

Руководство разработчика по Hedy MCP Server

Это техническое дополнение к нашему первоначальному анонсу запуска MCP. Здесь описаны полный каталог инструментов, модель аутентификации и рабочие сценарии для разработчиков, которые подключают Claude или другие MCP-совместимые клиенты к данным о своих встречах через ИИ-ассистента для встреч со всеми 25 инструментами.

Hedy напрямую связывается с Claude и другими ИИ-ассистентами через Model Context Protocol (MCP). Ваши ИИ-инструменты могут получать доступ к данным о встречах, упорядочивать их и работать с ними без ручного копирования информации между приложениями.

Что это на самом деле даёт

MCP-сервер даёт ИИ-ассистентам вроде Claude Desktop прямой доступ к вашим данным Hedy через 25 инструментов. Вот что становится возможным:

Управление сессиями
ИИ-ассистенты могут получать транскрипты, резюме и выводы по вашим встречам. Попросите Claude «найти обсуждение бюджета со встречи с клиентом на прошлой неделе», и он достанет именно эту сессию со всем контекстом.

Организация тем
Создавайте темы и управляйте ими программно. Ваш ИИ может автоматически упорядочивать связанные встречи, создавать базы знаний по сериям разговоров и отслеживать развитие проекта по нескольким сессиям.

Захват основных моментов
Получайте доступ к сохранённым основным моментам вместе с их ИИ-анализом. Составляйте учебные материалы из основных моментов лекций, собирайте точки принятия решений с деловых встреч или извлекайте ключевые цитаты из интервью.

Интеграция задач
Переносите задачи прямо в свой рабочий процесс. ИИ-ассистенты могут собирать задачи по проектам, находить просроченные или составлять сводные списки задач по нескольким встречам.

Техническая реализация

MCP-сервер работает по адресу https://api.hedy.bot/mcp (аккаунты ЕС используют https://eu-api.hedy.bot/mcp) и выполняет вход через OAuth 2.1. Ключа API для сервера нет. Настройка занимает около двух минут:

1. Добавьте URL сервера в настройки коннекторов или MCP вашего ИИ-клиента
2. Войдите в свой аккаунт Hedy в открывшемся окне браузера
3. Проверьте разрешения и нажмите Allow
4. Начинайте спрашивать о ваших встречах простым языком

Клиенты, которые принимают только ключ API или работают только с локальными серверами, могут подключаться через мост mcp-remote с открытым исходным кодом. В руководстве по настройке он описан с шагами для каждого клиента.

Интеграция поддерживает как запросы на уровне сессии («Что мы обсуждали по ценам?»), так и анализ по нескольким сессиям («Покажи все задачи со встреч с клиентами в этом месяце»).

Архитектура приватности

Данные шифруются при передаче и хранении. Ассистенты читают ваши данные, только когда вы об этом просите, а инструменты записи ограничены упорядочиванием: резюме, задачи, темы, контексты сессий и словарь. Ни один инструмент не может удалить запись или транскрипт.

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

Доступные инструменты

MCP-сервер предоставляет 25 инструментов. 14 читают ваши данные, 11 их изменяют.

Сессии

• GetSessions: список последних сессий, сначала новые
• GetSessionDetails: транскрипт, резюме и метаданные одной сессии
• GetSessionHighlights, GetSessionToDos: основные моменты и задачи одной сессии
• UpdateSessionSummary: заменить резюме сессии, например чтобы исправить имя, которое транскрипт написал неверно

Основные моменты

• GetHighlights, GetHighlightDetails: сохранённые основные моменты по всем сессиям с анализом Hedy

Задачи

• GetToDos: задачи по всем вашим сессиям
• UpdateToDoCompletion, UpdateToDoDueDate: отметить задачу выполненной или задать срок

Темы

• GetAllTopics, GetTopicDetails, GetTopicSessions: просмотр тем и сессий в них
• CreateTopic, UpdateTopic, DeleteTopic: управление темами, включая контекст темы, который Hedy использует во время сессий в реальном времени (при удалении темы её сессии сохраняются)
• AssignSessionToTopic: привязать сессию к теме

Контексты сессий

• ListSessionContexts, GetSessionContext: чтение сохранённой справки, которую Hedy использует для подсказок в реальном времени
• CreateSessionContext, UpdateSessionContext, DeleteSessionContext: создать или изменить её, например брифинг для завтрашнего звонка

Аккаунт и словарь

• GetAccount: текущий аккаунт, в который выполнен вход
• GetVocabulary, SetVocabulary: прочитать или заменить пользовательские термины, которые слушает Hedy

У каждого инструмента есть аннотации MCP, которые сообщают клиенту, только ли он читает, перезаписывает ли данные и обращается ли за пределы Hedy. Клиент может использовать их, чтобы спросить вас, прежде чем запускать инструмент, который что-то изменяет.

Практическое применение

Исследовательский анализ
Учёные используют интеграцию, чтобы обобщать выводы по циклам лекций. Попросите Claude «сравнить три теоретические концепции, обсуждавшиеся на 4–6 неделях», и он достанет нужное из нескольких сессий, сопоставит понятия и подготовит сравнительный анализ.

Работа с клиентами
Консультанты ведут подробную историю по каждому клиенту. ИИ может «подготовиться к завтрашней встрече с [клиентом], изучив все прежние обсуждения его стратегии на четвёртый квартал», и создать документ-брифинг с нужным контекстом, невыполненными обязательствами и предлагаемыми темами для разговора.

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

Автоматизация рабочих процессов
Разработчики встраивают данные Hedy в собственные системы. Сочетайте доступ через MCP с n8n или Make.com, чтобы строить автоматические процессы, которые передают выводы со встреч в инструменты управления проектами, обновляют CRM или запускают последующие действия.

Требования и совместимость

Сервер работает с любым MCP-клиентом, поддерживающим удалённые серверы со входом через OAuth. Подтверждено:

• Claude (веб, десктоп и Claude Code)
• ChatGPT
• Cursor, Windsurf, Zed и Cline
• Perplexity на платных тарифах
• Собственные клиенты на основе MCP SDK

Доступ к MCP входит в Hedy Pro и Hedy Team и требует включённой синхронизации с облаком, потому что сервер читает ваши сессии из облака Hedy. Если синхронизация с облаком выключена, сессии остаются на вашем устройстве, и ни одна интеграция не может до них добраться. Бесплатный тариф MCP не включает.

Начало работы

В руководстве по настройке есть шаги для каждого клиента, мост mcp-remote для клиентов без поддержки OAuth и решение проблем.

Для собственного кода, а не ИИ-ассистента, используйте API Hedy с ключом API, а веб-хуки — чтобы отправлять события сессий в ваши системы по мере их появления.

Что это даёт

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

Это важно, потому что профессиональная работа всё чаще происходит в разговорах. Знания, зафиксированные во встречах, звонках и обсуждениях, — значительный объём организационного интеллекта. Интеграция MCP делает их доступными для ИИ-инструментов, которыми вы уже пользуетесь для анализа, письма и принятия решений.

Для организаций это значит, что данные встреч становятся базой знаний, к которой можно обращаться запросами. Для отдельных людей — что каждый разговор, который вы вели с Hedy, становится доступен, чтобы помогать в текущей работе, без ручной организации.

Техническая основа

Сервер работает по протоколу MCP поверх потокового HTTP (streamable HTTP). Он реализует OAuth 2.1 с PKCE и динамической регистрацией клиентов, поэтому клиент регистрируется сам, а вам не нужно вставлять ключ. Инструменты возвращают структурированные результаты вместе с текстом для клиентов, которые их читают.

Дальнейшее развитие

Набор инструментов растёт вместе с тем, о чём люди просят своих ассистентов. Расскажите, что бы вы хотели получить дальше, на доске пожеланий.

Помощь

В руководстве по настройке описаны все клиенты, типичные проблемы с конфигурацией и примеры запросов. Если есть вопросы, присоединяйтесь к сообществу Hedy в Slack.

Доступ к MCP входит в Hedy Pro и Hedy Team. Добавьте https://api.hedy.bot/mcp в своего ИИ-ассистента и войдите в аккаунт Hedy, чтобы подключить его.

Часто задаваемые вопросы

Сколько инструментов предоставляет Hedy MCP Server?

25 инструментов в семи группах: сессии, основные моменты, задачи, темы, контексты сессий, аккаунт и пользовательский словарь. 14 из них читают данные, 11 их изменяют.

Поддерживает ли Hedy MCP Server операции записи?

Да. ИИ-ассистенты могут переписывать резюме сессии, отмечать задачи выполненными и задавать сроки, создавать, редактировать и удалять темы, привязывать сессии к темам, управлять контекстами сессий и заменять ваш пользовательский словарь. Ни один инструмент не может удалить запись или транскрипт. Веб-хуки настраиваются через API Hedy, а не через MCP.

Как работает аутентификация в Hedy MCP?

Hedy MCP Server использует OAuth 2.1. Ваш ИИ-клиент открывает окно браузера для входа и проверки разрешений и после вашего подтверждения получает токен доступа. Статических ключей API, которые нужно менять, нет. Доступ можно отозвать в любой момент в настройках Hedy.

Каков URL Hedy MCP Server?

https://api.hedy.bot/mcp для аккаунтов в США. Аккаунты с хранением данных в ЕС используют https://eu-api.hedy.bot/mcp. Добавьте URL в свой MCP-совместимый клиент (Claude, ChatGPT, Cursor, Windsurf, Zed, Cline, Claude Code) и пройдите аутентификацию через OAuth.

В чём разница между Hedy MCP Server, API и веб-хуками?

MCP Server предназначен для ИИ-ассистентов: они входят через OAuth и вызывают инструменты во время разговора. API Hedy нужен вашему собственному коду и работает по ключу API. Веб-хуки отправляют события сессий на выбранную вами конечную точку по мере их появления. Для всех трёх нужен платный тариф Hedy с включённой синхронизацией с облаком.