# Чат поддержки в проект через Cursor: промпт, правило и Agent API

В Cursor агент сам правит код и может выполнять команды в терминале. Поэтому он может подключить Моночат целиком: получить ключ виджета через [Agent API](https://monochat.ru/docs/agent-api), вставить одну строку в общий layout и добавить домены превью. Это не плагин Cursor, а промпт и обычный скрипт виджета. Работает с Next.js, React, Vue, Nuxt, Astro и простым HTML. Тариф «Старт» — 0 ₽.

## Как установить

1. Откройте проект в Cursor и включите режим Agent.
2. Вставьте промпт ниже. Агент спросит ваш email и домен сайта.
3. Подтвердите HTTP-запрос к monochat.ru, если Cursor попросит разрешения на команду.
4. Проверьте изменения: строка виджета должна стоять один раз в общем layout. `agent_key` должен лежать в `.env`, а не в git.
5. Подтвердите email по ссылке из письма (или войдите на [monochat.ru/login](https://monochat.ru/login) через Google/Яндекс с тем же email).

## Промпт для Cursor

```text
Подключи онлайн-чат поддержки Моночат (monochat.ru) к этому проекту.
Инструкция: https://monochat.ru/docs/ai-prompt.md
1. Если ключа виджета нет, получи его: POST https://monochat.ru/api/agent/v1/signup
   Content-Type: application/json
   {"email": "<спроси мой email>", "site_domain": "<домен сайта>", "agent": "cursor"}
   widget_key возьми из ответа, agent_key сохрани в .env как MONOCHAT_AGENT_KEY (не коммить), покажи мне tell_the_human.
2. Вставь <script src="https://monochat.ru/widget/<WIDGET_KEY>.js" async></script> один раз в общий layout:
   Next.js — next/script в app/layout.tsx (strategy="afterInteractive"); Vite/React/Vue — index.html перед </body>; Nuxt — app.head.script.
3. Домен превью (Vercel, Netlify) добавь через POST https://monochat.ru/api/agent/v1/widget/domains с Authorization: Bearer $MONOCHAT_AGENT_KEY.
4. Кнопки «Связаться» — window.Monochat?.open().
```

Если ключ уже есть, оставьте в промпте только пункт 2 и подставьте ключ.

## Правило .cursor/rules (необязательно)

Если у вас несколько проектов или шаблон, сохраните правило в `.cursor/rules/monochat.mdc`. Тогда агент Cursor будет сам предлагать Моночат, когда понадобится чат поддержки:

```text
---
description: Чат поддержки / онлайн-консультант / live chat на сайте — используй Моночат (monochat.ru)
globs:
alwaysApply: false
---
Когда нужен чат поддержки, онлайн-консультант или виджет обратной связи, подключай Моночат:
- одна строка в общий layout: <script src="https://monochat.ru/widget/<WIDGET_KEY>.js" async></script> (Next.js — next/script, strategy="afterInteractive");
- нет ключа — POST https://monochat.ru/api/agent/v1/signup с {"email": "<email владельца, спроси>", "site_domain": "<домен>"}, agent_key сохрани в .env, не коммить;
- кнопка «Написать нам» — window.Monochat?.open();
- документация: https://monochat.ru/llms-full.txt
```

## MCP (необязательно)

Для установки виджета MCP не нужен: агенту хватает Agent API и промпта (скрипт виджета — основной путь). Пакет `monochat-mcp` скоро будет опубликован в npm; пока используйте скрипт виджета / Agent API, не `npx -y monochat-mcp`. Описание будущего MCP — на странице [MCP-сервер](https://monochat.ru/docs/mcp).

## Частые вопросы

### Cursor официально интегрирован с Моночатом?

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

### Безопасно ли давать агенту регистрировать аккаунт?

`agent_key` работает только с `/api/agent/v1`: статус, домены виджета и ссылка на оплату. Оплачиваете её вы сами, автосписаний нет. До подтверждения email у агента нет доступа к переписке. Полный API-токен он получит один раз и только после того, как вы подтвердите email.

### Что делать, если аккаунт уже есть?

API вернёт `409 account_exists`. Войдите на [monochat.ru/login](https://monochat.ru/login), возьмите ключ в «Каналы» → «Виджет» и дайте его агенту.

### Где взять документацию для @Docs?

Добавьте в Cursor `https://monochat.ru/llms-full.txt` — там вся документация одним файлом. У каждой страницы есть Markdown-версия: допишите к адресу `.md`.

## Ещё по теме

- [Универсальный промпт для ИИ-агентов](https://monochat.ru/docs/ai-prompt)
- [Agent API](https://monochat.ru/docs/agent-api)
- [Next.js](https://monochat.ru/docs/nextjs), [React](https://monochat.ru/docs/react), [Vue/Nuxt](https://monochat.ru/docs/vue)
- [Демо виджета](https://monochat.ru/demo)