AiVideoEditor
Начните бесплатно
Меню

Проверено 2026-11-10 · версия API 2026-11-09 · Читать Markdown

Настройка MCP

Локальный stdio MCP-сервер, который оборачивает те же общие сервисы, что и UI и REST API, через /api/v1. Адаптер отправляет ваш ключ продукта только в настроенный API AiVideoEditor. Учетные данные Supabase или провайдеров не используются.

Предварительные требования

Это адаптер из проверки исходников, а не опубликованный пакет или размещенное подключение. Получите авторизованный доступ к репозиторию AiVideoEditor, установите Node 22+ и выполните npm ci в корне репозитория. Создайте ключ продукта рабочего пространства в /app/developers только с нужными правами и доступом к назначениям. Ключ только для черновиков не может публиковать или планировать. Никогда не вставляйте ключ в чат-промпт.

Запуск

export PUBLISHER_API_URL=https://app.example.com   # HTTPS; http://localhost is allowed for dev
export PUBLISHER_API_KEY=pk_v1_…                   # create in /app/developers
node packages/mcp/bin/publisher-mcp.mjs            # or: npm start --workspace packages/mcp

Бинарник — это настоящий исполняемый лаунчер (TypeScript и импорты без расширений разрешаются через tsx). Вся диагностика идет в stderr; stdout несет только трафик протокола. PUBLISHER_API_URL должен быть HTTPS (обычный HTTP только для loopback-разработки) и не должен содержать учетных данных, запросов или фрагментов.

Универсальная конфигурация клиента

{
  "mcpServers": {
    "autoposted": {
      "command": "node",
      "args": ["/absolute/path/to/packages/mcp/bin/publisher-mcp.mjs"],
      "env": {
        "PUBLISHER_API_URL": "https://app.example.com",
        "PUBLISHER_API_KEY": "pk_v1_…"
      }
    }
  }
}

Лаунчеру требуются Node 22+ и зависимости рабочего пространства (tsx, @modelcontextprotocol/sdk). Размещенный MCP-транспорт с OAuth — будущая работа; не считайте, что каждый десктопный или размещенный клиент поддерживает вставленные bearer-ключи.

Инструменты

ИнструментЧтение/МутацияПримечания
list_accountsreadУчитывает список разрешенных аккаунтов ключа
get_capabilitiesreadФорматы, лимиты, требования согласия
create_upload_intentmutateВозвращает инструкции прямой загрузки; байты медиа никогда не идут через инструменты
finalize_uploadmutateID сессии (+ квитанции multipart-частей); сервер сам наблюдает байты/MIME
create_draftmutateИсточник + варианты назначений
validate_postreadСтруктурированные проблемы по назначениям
schedule_postmutateОдин момент, ≤90 дней вперед, требуется expectedVersion
publish_postmutateСемантика 202; не доказательство публикации
get_post_statusreadСостояния по назначениям и нативные ссылки
list_postsreadКурсорная пагинация
cancel_deliverymutateТолько пока безопасно не взято в работу
retry_deliverymutateТолько известные сбои; никогда дубликаты
get_usagereadСчетчика оставшихся постов не существует

Обязательные аргументы инструментов

ИнструментОбязательные аргументы
list_accountsНет
get_capabilitiesНет
create_upload_intentfilename, declaredMime, declaredBytes
finalize_uploadassetId, sessionId
create_draftcaption, destinations
validate_postpostId
schedule_postpostId, scheduledAt, timezone, expectedVersion
publish_postpostId
get_post_statuspostId
list_postsНет
cancel_deliverydeliveryId
retry_deliverydeliveryId
get_usageНет

Необязательные аргументы включают пагинацию в list-инструментах, idempotencyKey в мутациях, multipart.parts для multipart-финализации, а также медиа черновика и варианты назначений. Схема инструментов времени выполнения, возвращаемая tools/list, авторитетна для необязательных полей, вложенных форм и лимитов проверки.

Мутирующие инструменты принимают необязательный аргумент idempotencyKey. Когда он опущен, сервер генерирует его и возвращает его в каждом результате: в том числе при ошибках транспорта, где операция могла уже дойти до API (ошибка несет transport_outcome_unknown плюс ключ). Инструменты никогда не повторяют мутации автоматически; повторяйте с тем же самым ключом идемпотентности, чтобы не создать дублирующую операцию.

Пример рабочего процесса агента

  1. list_accounts + get_capabilities → выберите действительные назначения.
  2. create_upload_intent → загрузите байты напрямую → finalize_upload.
  3. create_draft → validate_post → исправьте или снимите недействительные назначения.
  4. publish_post (или schedule_post) → запишите ID доставок.
  5. get_post_status (ограниченный опрос или клиентские вебхуки): считайте ответы requires_action инструкциями к действию, например согласие TikTok.

Протестированные клиенты

  • Официальный TypeScript-клиент @modelcontextprotocol/sdk, реальный stdio подпроцесса против документированного бинарника (initialize → tools/list → tools/call): протестирован в packages/mcp/tests/stdio.test.ts, включая проверки чистого stdout и сбоя при запуске.
  • Официальный SDK-клиент через in-memory транспорт: также покрыт.
  • Десктопные клиенты (Claude Desktop, Cursor и т.д.): еще не протестированы: настройте по универсальному фрагменту выше и сообщите результаты, прежде чем заявлять о поддержке.

Совместимость клиентов

Клиент или транспортСтатусНастройка
Официальный TypeScript SDK, stdio подпроцессаАвтоматизированное тестовое покрытиеЛаунчер репозитория показан выше
Официальный SDK через in-memory транспортАвтоматизированное тестовое покрытиеТолько тестовый стенд
Claude Desktop / другие десктопные клиентыНе проверено вручнуюЛокальный клиент с поддержкой stdio; используйте абсолютный путь лаунчера
ChatGPT размещенное подключениеНе предоставляется этим адаптеромТребуется размещенный транспорт; локальный stdio JSON — не размещенный коннектор
Размещенный MCP с OAuthНе реализованоОтдельная продуктовая работа

Поиск и устранение неисправностей

  • Лаунчер не может разрешить зависимости: выполните npm ci в авторизованной проверке исходников и проверьте версию Node. Не заменяйте несвязанным публичным пакетом.
  • Клиент никогда не инициализируется: используйте абсолютный путь лаунчера и осмотрите stderr. Не пишите отладочный вывод в stdout.
  • 401: убедитесь, что настроенный ключ продукта актуален; создайте замену в UI, если он отозван. 403: проверьте права и ограничения аккаунтов.
  • transport_outcome_unknown: сохраните возвращенный ключ идемпотентности и повторите идентичную операцию с этим ключом, но никогда с новым.
  • requires_action: передайте предоставленные инструкции уполномоченному человеку; агент не может дать согласие человека на TikTok.

Обращение с учетными данными

Ключ продукта отправляется только в ваш настроенный API AiVideoEditor (Authorization: Bearer). Он никогда не отправляется поставщикам моделей или социальным сетям, никогда не логируется, а URL валидируются, чтобы ключ не мог уйти по редиректу или вырваться за пределы настроенного источника.