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

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

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

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

## Промпт для Claude Code

```text
Подключи онлайн-чат поддержки Моночат (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 будет знать, какой чат подключать, когда вы попросите «добавь поддержку на сайт»:

```text
## Чат поддержки
Онлайн-чат на сайте — Моночат (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-сервер](https://monochat.ru/docs/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](https://monochat.ru/login), возьмите ключ в «Каналы» → «Виджет» и дайте его Claude Code. Тогда нужен только пункт 2 промпта.

## Ещё по теме

- [Универсальный промпт для ИИ-агентов](https://monochat.ru/docs/ai-prompt)
- [Agent API](https://monochat.ru/docs/agent-api)
- [Cursor](https://monochat.ru/docs/cursor)
- [Демо виджета](https://monochat.ru/demo)