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

# Интеграция с AI-агентом

> Как дать Claude, Cursor или другому агенту всё нужное, чтобы он написал интеграцию с AiGenda.

Документация доступна агентам в машиночитаемом виде:

| Что | Адрес |
| - | - |
| Вся документация одним файлом | [`https://docs.aigenda.tech/llms-full.txt`](https://docs.aigenda.tech/llms-full.txt) |
| Оглавление со ссылками | [`https://docs.aigenda.tech/llms.txt`](https://docs.aigenda.tech/llms.txt) |
| Любая страница в Markdown | добавьте `.md` к адресу страницы |

Кнопка в шапке каждой страницы копирует её в Markdown или открывает в ChatGPT, Claude, Cursor и VS Code.

## MCP-сервер документации

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

<CodeGroup>
  ```bash Claude Code theme={null}
  claude mcp add --transport http aigenda-docs https://docs.aigenda.tech/mcp
  ```

  ```json Cursor (.cursor/mcp.json) theme={null}
  {
    "mcpServers": {
      "aigenda-docs": {
        "url": "https://docs.aigenda.tech/mcp"
      }
    }
  }
  ```

  ```json VS Code (.vscode/mcp.json) theme={null}
  {
    "servers": {
      "aigenda-docs": {
        "type": "http",
        "url": "https://docs.aigenda.tech/mcp"
      }
    }
  }
  ```
</CodeGroup>

Сервер только читает документацию. Доступа к вашему аккаунту AiGenda у него нет.

## Промпт

Скопируйте и допишите под свою задачу:

```text Промпт для агента theme={null}
Напиши интеграцию с API AiGenda: загрузка записи встречи, обработка, получение протокола.

Документация: https://docs.aigenda.tech/llms-full.txt. Прочитай её целиком перед тем, как писать код.

Где запись: <файл на диске / ссылка / YouTube / бот на встречу>
Язык и стек: <Python 3.12 + requests / Node.js 20 / ...>
Куда положить результат: <файл protocol.md / наша база / ...>

Обязательные правила из документации:
1. Токен: POST /api/token/ с полями username (почта) и password. Заголовок Authorization: Bearer <access>.
2. title записи заканчивается расширением файла (.mp3, .m4a, .wav, .ogg, .webm, .mp4).
3. Файл грузится частями по ссылкам из массива url методом PUT; ETag каждой части передаётся в complete_upload с кавычками.
4. Перед classify дождаться is_uploaded: true в GET .../info/.
5. Результат опрашивать раз в 15 секунд: 200 + classified: true = готово; 500 дольше 3 минут = упало; 404 = обработку не запускали.
6. Не повторять вслепую POST создания записи: каждый вызов создаёт новую запись.
7. Почту и пароль брать из переменных окружения AIGENDA_EMAIL и AIGENDA_PASSWORD.
8. Бот на встречу: POST /api/space/{space_id}/meeting/ всегда с meeting_service (telemost, zoom или google_meet), иначе бот уйдёт как в Google Meet. Обработка записи бота запускается сама.

Начни с плана, потом код, потом инструкцию по запуску.
```

## С чего агенту начать

Полный рабочий скрипт на Python лежит на странице [Полный пример](/reference/full-example). Агенту проще всего взять его за основу и переписать под ваш стек.


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