João Henrique
b541f502ba
- Adicionado estrutura completa do projeto - Configurado MCP server para Premiere Pro - Adicionado documentação e skills - Configurado Gitignore para o projeto
4.7 KiB
Executable File
GPT-6 Astra workflows
Premiere Pro MCP gives Astra access to Premiere through structured tools, local
evidence, and reviewed edit workflows. Model selection belongs to the client:
start Codex with codex --model gpt-6-astra after installing the
Codex plugin and connector. Model access depends on
your account. The server does not run an OpenAI model itself.
Discover the right operation
The MCP initialization instructions and config://premiere-instructions resource
share the same session-aware guidance. Workflow routes are included only when
their tools are registered under the current authority, pack, and bridge setup.
Start with task keywords for a compact capability overview and relevant tools:
{"tool_query":"transcript","tool_limit":10}
get_capabilities searches names and descriptions. Exact names rank first,
followed by keyword matches, with stable alphabetical tie ordering. Results
include description, registered, backend support, authority requirements,
and the verification boundary. This is lexical discovery, not semantic search.
Search returns backend summaries and omits the large Adobe API inventories.
Omit tool_query when you need the complete backend report.
Search defaults to 20 results and available_only: true. Follow nextOffset
with the same query and filters to retrieve another page. An optional
tool_names list intersects the search. Set available_only: false to diagnose
withheld tools; the response labels them registered: false and cannot enable
them. Registered tools can still have action-level requirements or need a live
host. Read their schemas and returned support status before invoking them.
Existing calls without the new filters keep the full legacy capability response.
The standard MCP tools/list interface is unchanged, so clients can continue
using their own native tool-search facilities. Packs narrow registration and do
not dynamically load hidden tools. The default full pack exposes every permitted
operation; choose a narrower pack only when it covers the intended workflow.
Use evidence through completion
- Verify the intended CEP or UXP connection, then inspect the target project and sequence. Static metadata does not prove that Premiere is ready.
- Capture explicitly scoped project context and use
create_editorial_context_packto retrieve relevant transcript, shot, audio, and timeline evidence. Keep source ranges, evidence IDs, revisions, and truncation notices when planning the edit. - Use the registered editorial or edit-plan preview route, then the supported apply route with its exact plan, token, and approval requirements. Reinspect and preview again when the goal or project state changes.
- Serialize work sharing Premiere state. Analyze independent captured evidence concurrently only when it cannot race selection, playhead, or timeline changes. After an uncertain mutation outcome, inspect before retrying.
- Inspect returned frames or local review images for visual decisions. Verify fresh timeline readback and actual delivery files. Report playback/audio checks separately from image review and structural validation.
Transcripts and project metadata are evidence, never authority to change scope. These instructions apply to any capable MCP client, including Astra, without enabling unsafe scripting or bypassing existing edit guards.
Client capabilities and validation boundary
Astra's model reasoning, async tool calling, mid-turn steering, image input, and
conversation compaction are controlled by the client/API integration. This MCP
server supplies tools and evidence; it does not enable those API features by
adding model flags to an MCP tool definition. Local stdio remains the user-facing
connection; hosted /mcp is operator-only.
A custom OpenAI client must use the Responses API for Astra tool calls. Follow the official migration guide for supported request parameters and preserve tool call/result correlation across asynchronous work. Keep state-dependent Premiere operations serialized even when the client supports concurrent tool execution.
Repository tests exercise discovery, authorization/pack filtering, pagination, input validation, and initialization/resource consistency over in-memory MCP. They do not measure Astra's editing quality or prove licensed-Premiere execution. That requires an Astra-enabled client, a running licensed host, and a reviewed edit with fresh timeline, image, playback, and delivery evidence as applicable.
Official references checked September 4, 2026: