> ## Documentation Index
> Fetch the complete documentation index at: https://onlytraffic.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# AI-ассистенты
> Подключите Claude или ChatGPT к аккаунту OnlyTraffic Partners: спрашивайте о кампаниях, подписчиках, доходе и офферах обычным языком и выполняйте действия с кампаниями с ключом Full.
К партнёрскому аккаунту можно подключить Claude или ChatGPT. Ассистент отвечает на вопросы о ваших кампаниях, подписчиках, доходе и офферах по вашим реальным данным. С ключом **Full** он также может выполнять 7 действий с кампаниями из [Write API](/docs/ru/partners/api/write-api), предварительно спросив вас.
Ассистент видит только тот аккаунт, который вы подключили. Он использует один из ваших API-ключей, поэтому всё, что он может, ограничено этим ключом.
## Endpoint
```text theme={null}
https://partners.onlytraffic.com/mcp
```
Этот же URL показан в кабинете: **Tools -> API** ([partners.onlytraffic.com/tools/api](https://partners.onlytraffic.com/tools/api)), карточка **AI assistants (MCP)**, с кнопкой **Copy**.
## Поддерживаемые ассистенты
| Ассистент | Поддерживается |
| ----------------------------------------------------------- | -------------- |
| Claude (claude.ai и Claude Desktop) | Да |
| ChatGPT | Да |
| Локальные клиенты (Claude Code, Cursor, собственные агенты) | Пока нет |
## Подключение в Claude
В Claude откройте **Settings -> Connectors**.
Нажмите **Add custom connector** и вставьте URL:
```text theme={null}
https://partners.onlytraffic.com/mcp
```
Claude откроет страницу OnlyTraffic Partners. Если вы не вошли в кабинет, войдите как обычно. API-ключ никуда вставлять не нужно.
Страница согласия показывает, какой ассистент запрашивает доступ и что он сможет делать. В блоке **Key the assistant will use** выберите один из существующих API-ключей либо **Create a key for this assistant** и задайте имя, доступ (**Read-only** или **Full access**) и срок действия (30, 90, 180 или 365 дней, либо бессрочно). По умолчанию: Read-only и 90 дней.
Нажмите **Allow**. Страница закроется, коннектор готов. **Deny** отменяет подключение.
## Подключение в ChatGPT
В ChatGPT откройте **Settings -> Security & Login** и включите **Developer mode**. Без него ChatGPT не даёт добавить собственный коннектор.
Откройте [chatgpt.com/plugins](https://chatgpt.com/plugins), добавьте новый и вставьте тот же URL как адрес сервера:
```text theme={null}
https://partners.onlytraffic.com/mcp
```
Дальше всё так же, как в Claude: войдите в кабинет, если потребуется, выберите или создайте ключ на странице согласия, нажмите **Allow**.
Developer mode доступен только на тарифах ChatGPT, которые поддерживают кастомные коннекторы. Если переключателя нет, сначала проверьте свой тариф ChatGPT.
## Примеры вопросов
* Какие CPL-кампании ждут моего решения?
* Мой доход за последние 30 дней по моделям оплаты.
* Покажи мои активные CPL-офферы со свободными слотами.
* Какие RevShare-кампании привели больше всего фанов в этом месяце?
* Сколько подписчиков я доставил по `#cplo_…` и сколько осталось?
* Какие офферы клиентов в Find Offers платят больше всего за первую покупку и на которых у меня ещё нет кампании?
* CPC-клики и доход по дням за последнюю неделю.
## Что ассистент может читать
| Данные | Что в них |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| RevShare-кампании | Ваши кампании с id `#revc_…`: креатор, тип, статус, доля %, визиты, фаны, доход, ссылка |
| CPL-кампании | Кампании с id `#cplo_…`: статус, целевое действие, заказано и доставлено подписчиков, цена за подписчика, доход, ссылка после принятия, какие кампании ждут вашего решения |
| CPL-офферы | Ваши собственные офферы по номеру (`#350`): слоты, цена, статус (активен, на паузе, в архиве, эксклюзивный), показатели эффективности |
| Офферы клиентов | Каталог Find Offers: id оффера, сколько вы зарабатываете за подписчика и за другие целевые действия, правила пробного заказа, есть ли у вас уже кампания на этом оффере |
| RevShare-офферы | Каталог креаторов, которых можно продвигать: доля %, гарантия, тип страницы, ARPU, трафик за 7 дней, можно ли запустить кампанию |
| Подписчики и фаны | Фаны из ваших RevShare- и CPL-кампаний: бейджи, потраченная сумма, доля покупок и сообщений, ARPU |
| Транзакции | Что заплатили фаны и ваша доля дохода, проведено или возвращено, выплачено или ожидает |
| Дневная статистика | Фаны, визиты, доход и выручка по дням, для RevShare и CPL |
| CPC-заказы | Заказано и доставлено кликов, цена за клик, доход, статус |
| Дневная статистика CPC | Клики и доход CPC-заказов по дням |
| Доход CPC-виджетов | Доход по площадкам по дням: на холде, выплачен, аннулирован |
| CPC-категории | Справочник категорий |
Ограничения на то, что доступно:
* **Никаких персональных данных.** Имена фанов, логины и контакты клиентов ассистенту недоступны. Креаторы показаны по username в OnlyFans, клиенты только по публичному id.
* **Ваш собственный аккаунт.** Ассистент видит ваш username, замаскированный e-mail (`e***@domain.com`) и публичное имя, если вы его задали. Внутренний id аккаунта и полный e-mail он не видит.
* **Тот же каталог, что и в кабинете.** Офферы клиентов, которые клиент закрыл для вашего аккаунта, не показываются, а у закрытого для вас формата выплаты нет цены, так же как в Find Offers. Цены — это то, что зарабатываете вы.
* **Списки строк ограничены.** Список отдельных строк (например, фанов или транзакций) возвращает не более 100 строк за запрос. На итоги, доли и разбивки по дням, кампаниям или статусам это не влияет, поэтому просите их, а не полные выгрузки.
## Действия
С ключом **Full** ассистент может выполнять эти 7 действий:
| Действие | То же, что |
| ------------------------------------------------------ | ------------------------------------------------------------------------------------------- |
| Запустить RevShare-кампанию | [`POST /api/marketer/revshare/campaigns/start`](/docs/ru/partners/api/revshare-campaign-start) |
| Остановить RevShare-кампанию | [`POST /api/marketer/revshare/campaigns/stop`](/docs/ru/partners/api/revshare-campaign-stop) |
| Обновить RevShare-кампанию (имя, заметка, теги) | [`POST /api/marketer/revshare/campaigns/update`](/docs/ru/partners/api/revshare-campaign-update) |
| Принять CPL-кампанию | [`POST /api/marketer/cpl/campaigns/accept`](/docs/ru/partners/api/cpl-campaign-accept) |
| Отклонить CPL-кампанию | [`POST /api/marketer/cpl/campaigns/reject`](/docs/ru/partners/api/cpl-campaign-reject) |
| Остановить CPL-кампанию | [`POST /api/marketer/cpl/campaigns/stop`](/docs/ru/partners/api/cpl-campaign-stop) |
| Запустить кампанию на CPL-оффере клиента (Find Offers) | [`POST /api/marketer/cpl/campaigns/start`](/docs/ru/partners/api/cpl-campaign-start) |
* **Те же операции, что и в Write API.** Действуют те же проверки владельца, лимиты, кулдауны и сообщения валидации, что и в кабинете. См. [Write API](/docs/ru/partners/api/write-api).
* **Только ключ Full.** С ключом Read-only действия скрыты от ассистента. Он может отвечать на вопросы и строить отчёты, больше ничего.
* **Ассистент сначала спрашивает.** Перед любым действием он сообщает, что произойдёт, и ждёт вашего подтверждения.
* **Дубликаты отбрасываются.** Если ассистент повторяет идентичный запуск или принятие в течение 15 минут, кампания не запускается дважды: он получает результат первого выполнения с пометкой о повторе.
* **Пробные заказы.** На оффере клиента с пробным заказом кампания сразу начинает доставку. Когда число доставленных подписчиков достигает объёма пробного заказа, она ставится на холд, пока клиент её не одобрит или не отклонит. До этого запустить ещё одну кампанию на этого креатора нельзя.
Действия меняют реальные кампании. Прочитайте сообщение-подтверждение ассистента, прежде чем соглашаться, так же как вы проверили бы форму в кабинете.
## Ключи
Подключение привязано ровно к одному API-ключу, тому, который вы выбрали на странице согласия.
* Уровень доступа ключа — это уровень доступа ассистента: **Read-only** читает, **Full** читает и выполняет действия.
* У аккаунта может быть до **5** активных ключей. Когда их уже 5, страница согласия не может создать новый: выберите существующий ключ или отзовите один в **Tools -> API**.
* Отзыв ключа отключает всех ассистентов, которые его используют. То же происходит, когда срок действия ключа истекает.
* В списке ключей ключ, которым пользуется ассистент, отмечен меткой **MCP**.
Как работают ключи, описано на странице [Аутентификация](/docs/ru/partners/api/authentication).
## Лимиты запросов
Лимиты считаются на аккаунт, в минуту и в час. Они отделены от лимитов REST API, поэтому ассистент не может израсходовать бюджет вашей собственной интеграции.
| Что делает ассистент | В минуту | В час |
| ------------------------------------------------------------- | -------- | ----- |
| Вопрос по данным | 60 | 1000 |
| Составной вопрос по данным (несколько чтений в одном запросе) | 20 | 200 |
| Просмотр доступных данных, информация об аккаунте | 120 | 1000 |
| Остановка, отклонение или обновление кампании | 20 | 100 |
| Запуск кампании или принятие CPL-кампании | 5 | 10 |
Кроме того, все ассистенты одного аккаунта вместе могут отправить не более 120 запросов в минуту. При достижении лимита ассистенту сообщается, сколько нужно подождать, после чего он продолжает.
Запуски кампаний выполняются по одному на аккаунт, так же как в кабинете и в REST API.
## Часовой пояс и деньги
Все суммы в USD. Временные метки даны в часовом поясе API (UTC+03:00) и содержат смещение (`2026-09-18T10:40:38+03:00`), так же как в REST API. Дни в дневной статистике и диапазоны вроде «сегодня» или «последние 7 дней» тоже следуют этому поясу.
## Отключение
Любой из этих способов прекращает доступ:
* **В ассистенте.** Удалите коннектор в настройках Claude или ChatGPT.
* **В кабинете.** Откройте **Tools -> API**, найдите ассистента в карточке **AI assistants (MCP)** и нажмите **Disconnect**. Ассистент сразу теряет доступ. Ключ остаётся.
* **Отзовите ключ.** В **Tools -> API** отзовите ключ, который использует ассистент. Отключаются все ассистенты на этом ключе, а также любые скрипты с тем же ключом.
Подключить ассистента снова можно в любой момент из его настроек.
## Аудит
Каждое действие, выполненное ассистентом, показано в **Request log** ключа, который он использует, в **Tools -> API**, с меткой **MCP**, так что вызовы ассистента можно отличить от ваших собственных скриптов. Вопросы на чтение там не показываются.
Карточка **AI assistants (MCP)** показывает каждого подключённого ассистента, его ключ, когда он был подключён и когда использовался в последний раз.
## Решение проблем
* Подключаться могут только Claude и ChatGPT. Локальные клиенты пока не поддерживаются.
* После **Disconnect** в кабинете или после отзыва ключа старый коннектор больше не работает. Удалите его в настройках ассистента и добавьте снова с тем же URL.
Ключ, на котором держится подключение, отозван или истёк, либо ассистент был отключён в кабинете. Подключение, которым не пользовались 30 дней, тоже завершается. Подключитесь снова и выберите рабочий ключ.
Подключение использует ключ Read-only. Для действий нужен ключ Full: отключите ассистента, подключитесь снова и выберите или создайте ключ **Full access**.
Подождите время, которое он называет. У запусков и принятий самый маленький бюджет: 5 в минуту и 10 в час.
Сообщения те же, что в кабинете и в Write API. См. [Write API](/docs/ru/partners/api/write-api).