Проверено 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_accounts | read | Учитывает список разрешенных аккаунтов ключа |
get_capabilities | read | Форматы, лимиты, требования согласия |
create_upload_intent | mutate | Возвращает инструкции прямой загрузки; байты медиа никогда не идут через инструменты |
finalize_upload | mutate | ID сессии (+ квитанции multipart-частей); сервер сам наблюдает байты/MIME |
create_draft | mutate | Источник + варианты назначений |
validate_post | read | Структурированные проблемы по назначениям |
schedule_post | mutate | Один момент, ≤90 дней вперед, требуется expectedVersion |
publish_post | mutate | Семантика 202; не доказательство публикации |
get_post_status | read | Состояния по назначениям и нативные ссылки |
list_posts | read | Курсорная пагинация |
cancel_delivery | mutate | Только пока безопасно не взято в работу |
retry_delivery | mutate | Только известные сбои; никогда дубликаты |
get_usage | read | Счетчика оставшихся постов не существует |
Обязательные аргументы инструментов
| Инструмент | Обязательные аргументы |
|---|---|
list_accounts | Нет |
get_capabilities | Нет |
create_upload_intent | filename, declaredMime, declaredBytes |
finalize_upload | assetId, sessionId |
create_draft | caption, destinations |
validate_post | postId |
schedule_post | postId, scheduledAt, timezone, expectedVersion |
publish_post | postId |
get_post_status | postId |
list_posts | Нет |
cancel_delivery | deliveryId |
retry_delivery | deliveryId |
get_usage | Нет |
Необязательные аргументы включают пагинацию в list-инструментах, idempotencyKey в мутациях,
multipart.parts для multipart-финализации, а также медиа черновика и варианты
назначений. Схема инструментов времени выполнения, возвращаемая tools/list, авторитетна
для необязательных полей, вложенных форм и лимитов проверки.
Мутирующие инструменты принимают необязательный аргумент idempotencyKey. Когда он опущен,
сервер генерирует его и возвращает его в каждом результате: в том числе при ошибках
транспорта, где операция могла уже дойти до API (ошибка несет
transport_outcome_unknown плюс ключ). Инструменты никогда не повторяют
мутации автоматически; повторяйте с тем же самым ключом идемпотентности, чтобы не создать
дублирующую операцию.
Пример рабочего процесса агента
list_accounts+get_capabilities→ выберите действительные назначения.create_upload_intent→ загрузите байты напрямую →finalize_upload.create_draft→validate_post→ исправьте или снимите недействительные назначения.publish_post(илиschedule_post) → запишите ID доставок.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 валидируются, чтобы ключ не мог уйти по редиректу
или вырваться за пределы настроенного источника.