# Ноя ИИ

> Платформа ИИ-агентов для переписки с клиентами в мессенджерах, на сайтах и в маркетплейсах.
> Управляется программно: агенты и их инструкции, каналы связи, базы знаний, диалоги,
> рассылки, статистика. Есть готовый MCP-сервер для ИИ-помощников.

Авторизация: заголовок `Authorization: Bearer nk_live_...` — аккаунтный ключ. Выдать его может
владелец аккаунта, администратор или интегратор (Настройки → «API и подключение
ИИ-помощника»).
Базовый адрес: https://noya-ai.ru

## Документация

- [Полная документация API](https://noya-ai.ru/docs/api.md): авторизация, права, все основные
  адреса с телами запросов, форматы ответов, ошибки, ограничения
- [Спецификация OpenAPI](https://noya-ai.ru/api/openapi.yaml): полное машиночитаемое описание
  всех доступных адресов — поля тела запроса, параметры, обязательность, требуемые права
- [Справочник всех адресов](https://noya-ai.ru/api/mcp-routes): все адреса платформы, поиск
  через `?q=<слово>`. Список собирается из живого сервера, поэтому не отстаёт от платформы

## Подключение ИИ-помощника

- [Информация о MCP-пакете](https://noya-ai.ru/api/mcp-info): актуальная версия и адрес пакета
- Установка: `claude mcp add noya --env NOYA_API_KEY=<ключ> -- npx -y <адрес пакета>`
- Инструменты помощника: агенты, каналы, базы знаний, диалоги, статистика, исходящие кампании,
  рассылки, выгрузка переписок, действия и триггеры агента, справочники данных, интеграции с
  проверкой связи, список доступных моделей, телефония (настройки звонков и журнал), сброс
  памяти диалога, плюс универсальные `api_reference` и `api_request` для всего остального
- Скилл «Настройка агентов» (методичка по промптам агентов для Claude Code):
  <https://noya-ai.ru/skill/noya-agent.zip>, распаковать в `.claude/skills/`. Тот же текст —
  MCP-инструмент `instruction_guide`
- Несколько кабинетов = папка на проект: в каждой свой `.mcp.json` с ключом нужного кабинета
  (готовый файл выдаётся в кабинете после создания ключа), `.mcp.json` — в `.gitignore`

## Что нужно знать сразу

- **Начинайте работу с `whoami` (`GET /api/key/info`)**: `account_name` — с каким кабинетом вы
  работаете, `sections` — права ключа. У человека может быть много клиентов и своя папка под
  каждого; убедитесь, что кабинет тот, прежде чем что-либо менять
- `GET /api/dialogs/:id/messages` отдаёт всю переписку от старых к новым, постраничности нет
- `GET /api/stats` принимает `from`/`to` в ISO; параметра `period` не существует
- `POST /api/knowledge/documents` принимает только multipart с файлом, не JSON
- `GET /api/channels` без `?all=true` вернёт каналы только основного рабочего пространства
- Ключу всегда недоступны: оплата, сотрудники, выпуск ключей, партнёрка, вход, админка