# MCP-сервер Моночата

MCP-сервер позволяет ИИ-агенту (Claude Code, Cursor, Windsurf) работать с Моночатом инструментами. Он работает поверх [Agent API](https://monochat.ru/docs/agent-api) и [REST API](https://monochat.ru/docs/api).

```json
{
  "mcpServers": {
    "monochat": {
      "command": "npx",
      "args": ["-y", "monochat-mcp"],
      "env": { "MONOCHAT_AGENT_KEY": "mc_agent_…", "MONOCHAT_API_TOKEN": "mc_live_…" }
    }
  }
}
```

## Инструменты

| Инструмент | Что делает | API |
|---|---|---|
| `create_workspace` | регистрирует аккаунт и проект по email и домену, возвращает виджет | `POST /api/agent/v1/signup` |
| `get_widget_code` | сниппеты установки для html/react/nextjs/vue/tilda | `GET /api/agent/v1/status` |
| `add_widget_domain` | разрешить ещё один домен | `POST /api/agent/v1/widget/domains` |
| `list_plans` | тарифы и цены | `GET /api/agent/v1/plans` |
| `get_payment_link` | разовая ссылка на оплату для человека | `POST /api/agent/v1/payment-link` |
| `list_conversations` | последние диалоги | `GET /api/public/v1/conversations` |
| `read_conversation` | сообщения диалога | `GET /api/public/v1/conversations/{id}/messages` |
| `create_lead` | обращение из формы | `POST /api/public/v1/forms/lead` |

Чтение диалогов требует `MONOCHAT_API_TOKEN` (выдаётся после подтверждения email).