> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ahaslides.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AhaSlides MCP — руководство по началу

> Сервер AhaSlides MCP позволяет ИИ-ассистентам, таким как Claude и ChatGPT, управлять AhaSlides: создавать презентации, викторины и анализировать ответы.

Когда AhaSlides подключён, ваш ИИ-ассистент может создавать и редактировать слайды, задавать лимиты времени и баллы, применять тему к презентации и даже собирать файл PowerPoint с живыми слайдами AhaSlides внутри. Model Context Protocol — это открытый стандарт, который связывает ИИ-ассистентов с внешними инструментами и сервисами. Вместо переключения между приложениями вы описываете, что вам нужно, а ИИ делает работу внутри AhaSlides за вас. Представьте, что вы даёте Claude место в своём аккаунте AhaSlides.

## Перед началом

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

* Аккаунт AhaSlides (бесплатный или платный)
* ИИ-ассистент, поддерживающий пользовательские коннекторы MCP — Claude, ChatGPT или Claude Code

API-ключ не нужен — при первом подключении вы войдёте в свой аккаунт AhaSlides. URL сервера везде одинаковый:

```
https://mcp.ahaslides.com/mcp
```

<Frame>
  <img src="https://mintcdn.com/ahaslides/6CVhPWzTIuc8yS1q/images/marketplace-mcp-server.png?fit=max&auto=format&n=6CVhPWzTIuc8yS1q&q=85&s=e2513a99a8b966134f3bddca8d41b0f1" alt="Раздел «ИИ и автоматизация» в AhaSlides Marketplace с выделенной карточкой MCP Server" width="1920" height="1080" data-path="images/marketplace-mcp-server.png" />
</Frame>

## Настройка: добавление AhaSlides в Claude (без кода)

Это самый простой способ для большинства — несколько щелчков мышью, без терминала.

<Frame>
  <video controls loop muted playsInline className="w-full aspect-video rounded-xl" src="https://mintcdn.com/ahaslides/JFkN7cNlylxp1Zjf/images/claude-ahaslides-mcp.mp4?fit=max&auto=format&n=JFkN7cNlylxp1Zjf&q=85&s=3a736e7de3ca7e3923e9225d35643002" data-path="images/claude-ahaslides-mcp.mp4" />
</Frame>

<Steps>
  <Step title="Откройте настройки коннекторов">
    Нажмите на свой профиль, затем перейдите в **Settings → Connectors**.
  </Step>

  <Step title="Добавьте пользовательский коннектор">
    Нажмите **Add custom connector**, вставьте `https://mcp.ahaslides.com/mcp` в поле **Remote server URL**, затем нажмите **Добавить** (Add).
  </Step>

  <Step title="Войдите в AhaSlides">
    При первом использовании инструмента AhaSlides Claude откроет окно браузера, где вы войдёте в свой аккаунт AhaSlides (e-mail и пароль, Google или Microsoft). После входа всё готово.
  </Step>
</Steps>

<Note>
  Для добавления коннекторов в Claude нужен платный тарифный план Claude.
</Note>

## Настройка: добавление AhaSlides в ChatGPT (без кода)

ChatGPT тоже может работать с AhaSlides, и для этого не нужен платный аккаунт ChatGPT.

<Frame>
  <video controls loop muted playsInline className="w-full aspect-video rounded-xl" src="https://mintcdn.com/ahaslides/JFkN7cNlylxp1Zjf/images/chatgpt-ahaslides-mcp.mp4?fit=max&auto=format&n=JFkN7cNlylxp1Zjf&q=85&s=594fe2c3b4a5c47f28ebc55f09d24e72" data-path="images/chatgpt-ahaslides-mcp.mp4" />
</Frame>

<Steps>
  <Step title="Включите режим разработчика">
    Нажмите на свой профиль, затем перейдите в **Settings → Security and login** и включите **Developer mode** — это позволит добавлять пользовательские подключения.
  </Step>

  <Step title="Откройте каталог плагинов">
    Откройте вкладку **Plugins** и выберите **Browse plugin**.
  </Step>

  <Step title="Добавьте подключение">
    Нажмите значок плюса (**+**), вставьте `https://mcp.ahaslides.com/mcp` в поле **Connection**, затем нажмите **Создать** (Create).
  </Step>

  <Step title="Войдите в AhaSlides">
    При первом использовании инструмента AhaSlides вам предложат войти в свой аккаунт AhaSlides. После входа всё готово.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/ahaslides/6CVhPWzTIuc8yS1q/images/dashboard-chatgpt-setup-card.png?fit=max&auto=format&n=6CVhPWzTIuc8yS1q&q=85&s=fd6df78a188aa5984fe90e3f5cdcfceb" alt="Карточка «Создавайте презентации AhaSlides прямо в ChatGPT» на боковой панели AhaSlides со ссылкой на руководство по настройке" width="1920" height="1080" data-path="images/dashboard-chatgpt-setup-card.png" />
</Frame>

## Настройка: добавление AhaSlides в Claude Code (для разработчиков)

Если вы используете Claude Code (CLI, настольное приложение или расширение для VS Code / JetBrains), вы можете добавить сервер напрямую.

### Вариант 1. Быстрое добавление через CLI

Выполните эту команду в терминале:

```bash theme={null}
claude mcp add ahaslides --transport http https://mcp.ahaslides.com/mcp
```

### Вариант 2. Ручная настройка

Добавьте следующее в настройки MCP в Claude Code (settings.json или .mcp.json):

```json theme={null}
{
  "mcpServers": {
    "ahaslides": {
      "type": "url",
      "url": "https://mcp.ahaslides.com/mcp"
    }
  }
}
```

### Вход в Claude Code

При первом использовании инструмента AhaSlides Claude Code откроет окно браузера, где вы войдёте в свой аккаунт AhaSlides (e-mail и пароль, Google или Microsoft). После входа всё готово.

## Что можно делать с AhaSlides MCP

После подключения просто опишите, что вам нужно. Вот всё, что поддерживает сервер MCP:

**Презентации** (Presentations)

* Создать новую презентацию
* Посмотреть полные сведения о презентации (слайды, тема, структура)

**Слайды** (Slides)

* Создавать слайды более чем 17 типов — викторины, опросы, облака слов, мозговые штурмы, слайды с содержанием и другие
* Редактировать содержимое слайдов (заголовки, варианты, ответы, абзацы, изображения)
* Настраивать свойства слайдов (таймеры, оценивание, параметры отображения, типы диаграмм)
* Менять порядок слайдов в презентации
* Удалять слайды
* Пропускать слайды во время презентации в реальном времени (скрыть от аудитории без удаления)

**Темы** (Themes)

* Просматривать все доступные темы (официальные, пользовательские и общие для команды)
* Применять тему к любой презентации

**Аналитика** (Analytics)

* Запрашивать данные об ответах аудитории по всем вашим презентациям
* Анализировать данные сессии конкретной презентации (участие, баллы за викторину, результаты опросов)

**Файлы PowerPoint**

* Собирать колоду PowerPoint (.pptx) со встроенными живыми викторинами, опросами и другими интерактивными слайдами AhaSlides — см. [Создание колоды PowerPoint с живыми слайдами AhaSlides](#создание-колоды-powerpoint-с-живыми-слайдами-ahaslides)

## Создание колоды PowerPoint с живыми слайдами AhaSlides

Попросите своего ИИ-ассистента создать презентацию PowerPoint с интерактивными слайдами, и он выдаст один файл .pptx со встроенными живыми викторинами, опросами, облаками слов и другими интерактивными слайдами AhaSlides. Когда вы показываете её в PowerPoint, эти слайды работают в реальном времени: аудитория подключается со своих телефонов и отвечает так же, как в AhaSlides.

За кулисами ассистент создаёт интерактивные слайды в новой презентации в вашем аккаунте AhaSlides, собирает колоду PowerPoint и размещает в ней каждый интерактивный слайд с помощью [надстройки AhaSlides для PowerPoint](/ru/integrations/using-powerpoint-s-ahaslides-add-in).

### Что вам понадобится

* AhaSlides MCP, подключённый к вашему ИИ-ассистенту. См. шаги настройки для Claude, ChatGPT или Claude Code на этой странице.
* ИИ-ассистент, который умеет создавать файлы и запускать код, например Claude или Claude Code. Файл .pptx собирается на стороне ассистента.
* Настольное приложение PowerPoint для Windows или Mac с установленной надстройкой AhaSlides. См. [Установка надстройки](/ru/integrations/using-powerpoint-s-ahaslides-add-in#установка-надстройки).

### Примеры запросов

* *«Создай презентацию PowerPoint с интерактивными викторинами о нашей новой линейке продуктов.»*
* *«Сделай мне колоду .pptx для командной встречи в понедельник с живым опросом и облаком слов.»*
* *«Собери PowerPoint для моего воркшопа с несколькими вопросами для участия аудитории между темами.»*

### Где слайды работают в реальном времени

Интерактивные слайды работают в реальном времени только в настольном приложении PowerPoint с надстройкой AhaSlides. Во всех остальных случаях — PowerPoint для веб, экспорт в PDF или распечатка, компьютер без надстройки — вместо пустого слайда каждый из них показывает изображение-заглушку.

<Note>
  Если вы отправляете файл другому человеку для показа, ему нужно установить надстройку AhaSlides в собственную копию PowerPoint, чтобы слайды работали в реальном времени.
</Note>

Поскольку интерактивные слайды сохраняются как презентация в вашем аккаунте AhaSlides, вы можете редактировать их там как обычно. Чтобы подтянуть изменения в PowerPoint, нажмите **Перезагрузить** (Reload) в надстройке. См. [Перезагрузка слайдов](/ru/integrations/using-powerpoint-s-ahaslides-add-in#перезагрузка-слайдов).

## Поддерживаемые типы слайдов

| Категория | Типы слайдов |
| - | - |
| **Викторина** (Quiz) | Pick Answer, Short Answer, Match Pairs, Correct Order, Categorise |
| **Интерактивное** (Interactive) | Poll, Word Cloud, Brainstorm, Open Ended, Scale, Q\&A, Spinner Wheel |
| **Содержание** (Content) | Presentation Title, Content, Listing, Content with Image (слева или справа) |
| **Utility** | QR Code, Leaderboard |

## Примеры запросов для MCP

Вот примеры запросов для начала работы:

| Задача | Запрос |
| - | - |
| Создать презентацию | *«Создай новую презентацию AhaSlides „Командный отчёт за II квартал“ со слайдом приветствия и повесткой.»* |
| Добавить опрос или викторину | *«Добавь в мою презентацию вопрос с выбором ответа „Какая самая большая сложность у вас на работе?“ с четырьмя вариантами.»* |
| Построить викторину | *«Создай викторину из 5 вопросов о возможностях нашего продукта для командного тренинга.»* |
| Добавить облако слов | *«Добавь слайд Word Cloud с вопросом к участникам „Как для вас выглядит отличное сотрудничество?“»* |
| Редактировать существующие слайды | *«Измени заголовок слайда 3 в моей презентации на „Итоги квартала“.»* |
| Изменить порядок слайдов | *«Перемести слайд с таблицей лидеров сразу после последнего вопроса викторины.»* |
| Изменить оформление | *«Покажи все доступные темы, а затем примени к моей презентации тёмную.»* |
| Проанализировать ответы аудитории | *«Сколько человек участвовало в моей презентации „Sales Kickoff 2025“? Покажи разбивку баллов за викторину.»* |
| Пропустить слайд | *«Пропусти слайд Brainstorm во время сессии в реальном времени — я хочу его сохранить, но сегодня не показывать.»* |
| Собрать колоду PowerPoint | *«Создай презентацию PowerPoint с интерактивными викторинами и живым опросом для моего тренинга по продажам.»* |

## Советы для лучших результатов с MCP

**Чётко формулируйте, что вам нужно:**

* Вместо «Сделай викторину» попробуйте «Сделай викторину из 10 вопросов с выбором ответа по технике безопасности на работе для новых сотрудников, по 4 варианта ответа в каждом»

**Называйте презентации по имени:**

* «Добавь опрос в мою презентацию „Sales Kickoff 2025“»

**Сначала попросите структуру, затем дорабатывайте:**

* «Составь план 15-минутного тренинга по продукту, а затем создай его в AhaSlides»

**Комбинируйте с другими инструментами:**

* «Прочитай повестку моей встречи из Google Docs, а затем создай на её основе презентацию AhaSlides»

**Используйте аналитику для улучшения:**

* «Покажи, на какие вопросы викторины в моём последнем тренинге давали меньше всего правильных ответов»

## Устранение неполадок AhaSlides MCP

| Проблема | Решение |
| - | - |
| **Не появляется окно входа** | Перезапустите Claude Code и попробуйте снова |
| **Ошибка «Not authenticated»** | Возможно, срок действия сессии истёк — Claude Code предложит войти снова |
| **Страница «Connect your app» просит подключиться** | Приложение, которым вы пользуетесь, запросило подключение к вашему аккаунту AhaSlides. Убедитесь, что код совпадает с кодом в этом приложении, и нажмите **Подключить** (Connect). Срок действия кодов ограничен, поэтому, если на странице сказано, что код недействителен или истёк, начните вход заново из приложения. Если вы только что не начинали вход, закройте вкладку. |
| **Инструменты не отображаются** | Перезапустите Claude Code после добавления сервера |
| **Ошибка «Presentation not found»** | Убедитесь, что вы указываете правильное имя или ID презентации |
| **Медленные ответы** | Это нормально для больших презентаций с большим количеством слайдов — немного подождите |

## Безопасность и конфиденциальность MCP

* Не нужно управлять API-ключами — для аутентификации используется безопасный OAuth 2.0 (тот же стандарт, что у Google, GitHub и других)
* Вы входите в свой существующий аккаунт AhaSlides — не нужно создавать и хранить дополнительные учётные данные
* ИИ имеет доступ только к презентациям в вашем аккаунте
* Сервер MCP выполняет только те действия, которые вы явно запросили
* Вы можете в любой момент отозвать доступ в настройках аккаунта AhaSlides
* Сессия входа истекает автоматически — при необходимости вам предложат пройти аутентификацию заново

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

<AccordionGroup>
  <Accordion title="Где найти мой API-ключ?">
    У AhaSlides нет публичного REST API, поэтому API-ключа, который можно найти, не существует. Если вы хотите, чтобы ИИ-ассистент, например Claude, работал с вашим аккаунтом AhaSlides, используйте AhaSlides MCP — он подключается через вход в ваш существующий аккаунт AhaSlides, API-ключ не нужен. Как добавить его в Claude Code, см. в разделе **Настройка** выше.
  </Accordion>
</AccordionGroup>

**Остались вопросы?**

Свяжитесь с нашей службой поддержки: если вы вошли в аккаунт, нажмите на значок чата в правом нижнем углу панели управления; в остальных случаях [напишите нам здесь](https://ahaslides.com/contact-us/) или отправьте письмо на [hi@ahaslides.com](mailto:hi@ahaslides.com).

Хотите пообщаться с другими пользователями? Присоединяйтесь к [сообществу AhaSlides](https://community.ahaslides.com/): делитесь советами, предлагайте новые функции и смотрите, как другие вовлекают свою аудиторию.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.