Чат поддержки на сайт через Claude Code: промпт и CLAUDE.md

Q: Что увидит владелец сайта?

Письмо для подтверждения email и поле tell_the_human в ответе API: агент должен показать его вам. Виджет работает сразу на тарифе «Старт». Платный тариф агент может только предложить: ссылку на оплату открываете и оплачиваете вы.

Claude Code работает в терминале: читает проект, правит файлы и выполняет команды с вашего разрешения. Он может подключить Моночат сам. Он прочитает инструкцию в Markdown, получит ключ виджета через Agent API и вставит одну строку в общий layout. Это не плагин Claude Code, а промпт и обычный скрипт виджета. Тариф «Старт» — 0 ₽.

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

Запустите claude в корне проекта.
Вставьте промпт ниже. Claude Code спросит ваш email и домен сайта.
Разрешите запрос к monochat.ru (curl или WebFetch), когда он спросит.
Проверьте diff: виджет добавлен один раз, MONOCHAT_AGENT_KEY записан в .env, а .env есть в .gitignore.
Подтвердите email по ссылке из письма или войдите на monochat.ru/login через Google/Яндекс.

Промпт для Claude Code

Подключи онлайн-чат поддержки Моночат (monochat.ru) к этому проекту.
Сначала прочитай инструкцию: https://monochat.ru/docs/ai-prompt.md
1. Если ключа виджета нет, выполни:
   curl -X POST https://monochat.ru/api/agent/v1/signup -H "Content-Type: application/json" \
     -d '{"email":"<спроси мой email>","site_domain":"<домен сайта>","agent":"claude-code"}'
   widget_key возьми из ответа, agent_key сохрани в .env как MONOCHAT_AGENT_KEY (проверь .gitignore), покажи мне 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. Домены превью добавь через POST https://monochat.ru/api/agent/v1/widget/domains с Authorization: Bearer $MONOCHAT_AGENT_KEY.
4. Кнопки «Связаться» — window.Monochat?.open(). Покажи итоговый diff.

Фрагмент для CLAUDE.md (необязательно)

Добавьте этот фрагмент в CLAUDE.md проекта или шаблона. Тогда Claude Code будет знать, какой чат подключать, когда вы попросите «добавь поддержку на сайт»:

## Чат поддержки
Онлайн-чат на сайте — Моночат (monochat.ru). Одна строка в общий layout:
<script src="https://monochat.ru/widget/<WIDGET_KEY>.js" async></script>
Ключ виджета — в .env (MONOCHAT_WIDGET_KEY) или в кабинете monochat.ru → «Каналы» → «Виджет».
Нет ключа — POST https://monochat.ru/api/agent/v1/signup (см. https://monochat.ru/docs/agent-api.md).
Открыть чат из кода: window.Monochat?.open(). Вся документация: https://monochat.ru/llms-full.txt

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

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

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

Это официальная интеграция Claude Code?

Нет. Claude Code следует промпту и документации в Markdown, а на сайт ставится обычный скрипт виджета.

Откуда Claude Code берёт документацию?

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

Что увидит владелец сайта?

Письмо для подтверждения email и поле tell_the_human в ответе API: агент должен показать его вам. Виджет работает сразу на тарифе «Старт». Платный тариф агент может только предложить: ссылку на оплату открываете и оплачиваете вы.

Можно без регистрации через API?

Да. Войдите на monochat.ru/login, возьмите ключ в «Каналы» → «Виджет» и дайте его Claude Code. Тогда нужен только пункт 2 промпта.