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

В Cursor агент сам правит код и может выполнять команды в терминале. Поэтому он может подключить Моночат целиком: получить ключ виджета через 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 через Google/Яндекс с тем же email).

Промпт для Cursor

Подключи онлайн-чат поддержки Моночат (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 будет сам предлагать Моночат, когда понадобится чат поддержки:

---
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-сервер.

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

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

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

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

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

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

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

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

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

Ещё по теме

• Универсальный промпт для ИИ-агентов
• Agent API
• Next.js, React, Vue/Nuxt
• Демо виджета