# ИИ-агенты и MCP

Документация подготовлена для ИИ-помощников: у каждой страницы есть Markdown, вся документация собрана в один файл, а готовый промпт задает агенту правила интеграции.

Промпт для ИИ-агента: https://docs.melioralab.io/agent-prompt.txt

## Файлы для агентов

| Файл | Что внутри |
|---|---|
| [llms.txt](https://docs.melioralab.io/llms.txt) | Оглавление: ссылки на Markdown каждой страницы с кратким описанием. |
| [llms-full.txt](https://docs.melioralab.io/llms-full.txt) | Вся документация одним Markdown-файлом: руководства и справочник. |
| [openapi.json](https://docs.melioralab.io/openapi.json) | Спецификация OpenAPI 3.1: маршруты, параметры, схемы ответов и примеры. |
| `/md/<страница>.md` | Markdown отдельной страницы, например [/md/events-polling.md](https://docs.melioralab.io/md/events-polling.md) или [/md/reference/leads.md](https://docs.melioralab.io/md/reference/leads.md). |
| [agent-prompt.txt](https://docs.melioralab.io/agent-prompt.txt) | Промпт для ИИ-агента текстом. |

На каждой странице руководства и справочника справа от заголовка есть меню «Копировать страницу»: скопировать Markdown страницы, открыть его отдельно или открыть страницу в ChatGPT или Claude с готовым вопросом.

## Как подключить документацию

### Claude, ChatGPT и другие чаты

Вставьте в чат [промпт](https://docs.melioralab.io/agent-prompt.txt) кнопкой «Скопировать промпт». Если у помощника есть доступ в интернет, он сам прочитает `llms-full.txt` и `openapi.json`. Если доступа нет, приложите файл [llms-full.txt](https://docs.melioralab.io/llms-full.txt) к сообщению.

Для вопроса по одной странице откройте меню «Копировать страницу» и выберите «Открыть в ChatGPT» или «Открыть в Claude».

### Cursor

Добавьте документацию как источник: в настройках документации Cursor укажите адрес `https://docs.melioralab.io/llms-full.txt`, затем ссылайтесь на нее в чате через `@`. Промпт можно сохранить в правилах проекта, в папке `.cursor/rules`.

### Claude Code и другие агенты в терминале

Сохраните промпт в файл инструкций проекта, например `CLAUDE.md` или `AGENTS.md`, или передайте его в начале сессии. Агент с доступом к сети прочитает документацию по ссылкам из промпта. Без сети скачайте файлы в проект:

```bash
curl -o docs/meliora-llms-full.txt https://docs.melioralab.io/llms-full.txt
curl -o docs/meliora-openapi.json https://docs.melioralab.io/openapi.json
```

## Ключ и агент

Агенту нужен ключ, только если он сам выполняет запросы к API. Чтобы прочитать документацию и написать код, ключ не нужен.

> **Внимание.** Не вставляйте ключ в чат с моделью и не пишите его в промпт. Переписка с моделью может храниться у поставщика, а ключ дает доступ к данным вашего кабинета.

Если агент должен выполнять запросы:

1. Выпустите для него **отдельный ключ**, не тот, что работает в вашей интеграции.
2. Дайте **минимальные права**: обычно хватает «Кампании» и «Лиды». Текст сообщений включайте, только если он действительно нужен.
3. Ограничьте **охват** одной тестовой кампанией.
4. Задайте **срок действия**, например на неделю, и при возможности список разрешенных IP.
5. Передайте ключ через **переменную окружения** `MELIORA_API_KEY` в среде, где агент запускает код. Промпт требует от агента брать ключ оттуда и не выводить его.
6. После работы **отзовите ключ**.

Подробнее о правах, охвате и отзыве в руководстве [Аутентификация и ключи](https://docs.melioralab.io/authentication/).

## Сервер MCP

Собственного сервера MCP у Meliora пока нет: он есть в планах на странице [Что дальше](https://docs.melioralab.io/roadmap/). Агенты с поддержкой MCP могут работать с документацией через свой инструмент чтения веб-страниц или файлов: дайте им ссылки на `llms-full.txt` и `openapi.json` или промпт.

Сторонние серверы MCP, которые выдают себя за сервер Meliora, к нам отношения не имеют. Не передавайте им ключи.