Перейти к основному содержанию
Документация для разработчиков и ИИОнлайн · сервер v1.0.0

Подключите вашего ИИ-ассистента

Подключите Claude, ChatGPT или другой MCP-клиент к вашему клиентскому порталу. Ассистент может читать ваши проекты, счета, заявки в поддержку, состояние сайта и файлы. На тарифах Pro и Ultra он также может открывать заявки или отправлять запросы на изменения, но только после того, как вы подтвердите точный предпросмотр.

Инструменты и лимиты

Каждый тариф задаёт свои лимиты. Сервер применяет количество ключей, запросы в минуту на каждый ключ и месячные единицы на весь аккаунт.

Basic

Бесплатно

Только чтение. На этом тарифе запись недоступна

КлючиАктивные ключи на аккаунт: до 1
Частота30 запросов в минуту на каждый ключ
Квота1,000 единиц на аккаунт в месяц

Просмотр проектов, счетов, тикетов поддержки, статуса сайта, файлов проекта и ежемесячного отчета.

Pro

3,000,000 Toman / мес.

Чтение и подтверждённая запись

КлючиАктивные ключи на аккаунт: до 3
Частота60 запросов в минуту на каждый ключ
Квота5,000 единиц на аккаунт в месяц

Все инструменты чтения и подтверждённая запись: открытие и ответы на заявки в поддержку, отправка запросов на изменения и сообщений Farr, загрузка файлов, создание и обновление черновиков контента, принятие или отклонение предложений. Каждая запись сначала показывается в предпросмотре и применяется только после вашего одобрения.

Ultra

5,000,000 Toman / мес.

Всё из Pro, а также массовые действия и веб-хуки

КлючиАктивные ключи на аккаунт: до 10
Частота120 запросов в минуту на каждый ключ
Квота20,000 единиц на аккаунт в месяц

Всё из Pro, а также массовые действия с заявками (bulk_ticket_reply, bulk_ticket_close и bulk_actions, до 20 заявок за вызов), веб-хуки (webhook_list, webhook_create и webhook_delete) и запланированные ежемесячные отчёты (scheduled_reports и scheduled_reports_get).

Безопасность: никаких финансовых операций и смены владельца

В API ассистента нет инструментов для оплаты счетов, перевода средств, изменения владельца аккаунта или управления ключами. Счета доступны только для чтения. Оплату вы производите самостоятельно в клиентском портале.

Как создать ключ ассистента

Создайте ключ в клиентском портале за три шага.

1. Войдите в портал

Войдите в клиентский портал и откройте раздел «Доступ ассистента» в меню.

2. Создайте ключ

Нажмите «Создать ключ». Введите название от 3 до 60 символов (например, «Claude Code - ноутбук»), выберите права доступа и срок действия. Для создания потребуется повторный вход.

3. Скопируйте ключ сразу

Полный ключ отображается только один раз сразу после создания. Сервер сохраняет только SHA-256 хеш его секретной части. В случае утери отзовите его и создайте новый.

Как подключить Claude и ChatGPT

Подключайтесь по протоколу MCP Streamable HTTP с помощью Bearer-ключа или через авторизацию OAuth.

Claude Code и другие MCP-клиенты

В инструментах с поддержкой URL сервера и заголовков (например, в файле .mcp.json в Claude Code) добавьте эту запись и укажите ваш ключ вместо плейсхолдера:

{
  "mcpServers": {
    "sajjad-portal": {
      "type": "http",
      "url": "https://sajjad.blog/api/client/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_AGENT_KEY>"
      }
    }
  }
}

ChatGPT и веб-ассистенты

Добавьте этот адрес как пользовательский коннектор и выполните вход по запросу (OAuth). Ключ в этом случае не требуется. Названия пунктов меню могут различаться в зависимости от ассистента.

URL MCP-сервера
https://sajjad.blog/api/client/mcp
Заголовок авторизации (для клиентов на основе ключа)
Bearer <ВАШ_КЛЮЧ_АССИСТЕНТА>
Two-Step Write Architecture

Что означает «Предпросмотр с подтверждением» для операций записи

Изменение никогда не применяется при первом вызове.

Когда ассистент вызывает инструмент записи, сервер сохраняет точный запрос и возвращает предпросмотр с одноразовым токеном подтверждения, действительным 10 минут. Изменение применяется только тогда, когда ассистент вызывает инструмент подтверждения с этим токеном с вашего согласия. Каждый токен действует один раз, только для выдавшего его ключа и аккаунта и с теми же аргументами. Каждое запланированное действие протоколируется.

Step 1
1. Ассистент готовит проект изменения
Step 2
2. Вы проверяете предпросмотр и даете согласие
Step 3
3. Сервер проверяет токен и фиксирует результат

Справочник проверенных инструментов

Основные инструменты, которые предоставляет клиентская конечная точка, а также инструмент подтверждения, используемый после предпросмотра. Инструмент, которого нет в вашем тарифе, отклоняется с сообщением plan_required.

Имя инструментаТип доступаОписание функции
projects_listЧтениеСписок до 50 ваших проектов: код, название, статус, прогресс и срок завершения.
invoices_listЧтениеСписок до 25 счетов со сроком оплаты, суммой, оплаченной частью, остатком и статусом. Параметр openOnly показывает только неоплаченные. Черновики и ссылки на оплату исключены.
tickets_listЧтениеСписок до 50 ваших тикетов поддержки со статусом, приоритетом и временем последнего ответа.
ticket_getЧтениеИстория сообщений тикета поддержки (до 100 сообщений). Внутренние заметки исключены.
ticket_createПодтвержденная записьПодготовка нового тикета поддержки с низким или обычным приоритетом. Создается только после подтверждения предпросмотра.
ticket_replyПодтвержденная записьПодготовка ответа на открытый тикет. Ответы на закрытые тикеты заблокированы. Отправляется только после подтверждения.
change_request_createПодтвержденная записьПодготовка запроса на изменение по проекту. Применяется только после подтверждения предпросмотра.
site_statusЧтениеСтатус домена, количество посетителей и просмотров страниц (за 24 часа и 7 дней), процент аптайма и количество нерешенных ошибок подключенного сайта. Данные последней синхронизации телеметрии.
files_listЧтениеСписок файлов в хранилище проектов, до 100 на страницу, с возможностью фильтрации по папке.
file_linkЧтениеСоздание ссылки на скачивание файла из хранилища. Ссылка действительна 15 минут.
report_monthlyЧтениеЕжемесячная сводка (до 12 месяцев назад): проекты, открытые и закрытые тикеты, снимок сайта, счета к оплате и ссылка на PDF, действующая 15 минут.

Часто задаваемые вопросы

Ответы на популярные вопросы о клиентских ассистентах, безопасности и лимитах.

Может ли ИИ-ассистент автоматически оплачивать счета?

Нет. В API ассистента отсутствуют инструменты для оплаты счетов или перевода средств. Счета доступны только для просмотра, а оплату вы производите сами в клиентском портале.

Что происходит при исчерпании ежемесячной квоты единиц?

Каждый тариф задаёт месячный бюджет единиц на весь аккаунт. Чтение стоит 1 единицу, предпросмотр записи — 3. Когда использование аккаунта за месяц достигает бюджета тарифа, следующие вызовы возвращают ошибку quota_exceeded внутри результата инструмента (HTTP 200, не 429) до смены календарного месяца по UTC.

Как отозвать скомпрометированный ключ ассистента?

Откройте раздел «Доступ ассистента» в клиентском портале, выберите «Отозвать ключ» и подтвердите действие. Любой последующий запрос с этим ключом будет немедленно отклонен. Ассистентов, подключенных через OAuth, можно отключить на этой же странице.

Требуется ли локальный мост для подключения ChatGPT?

Нет. Конечная точка — это стандартный HTTPS-адрес: клиент отправляет сообщения JSON-RPC через POST и получает JSON-ответы. Облачные ассистенты подключаются напрямую без локального ПО.

Готовы подключить ассистента к работе?

Выберите подходящий тариф или откройте клиентский портал и создайте ключ ассистента.