Referência das ferramentas MCP

As ferramentas MCP do Nodaro são as ações que um assistente de IA pode realizar na sua conta do Nodaro depois de se conectar ao servidor MCP do Nodaro. São cerca de 200, agrupadas aqui por finalidade: gerar mídia, editá-la, gerenciar entidades, criar e executar workflows e dirigir produções completas. Cada página lista os nomes exatos das ferramentas, a permissão de que cada uma precisa, os principais parâmetros, o que ela retorna e quanto custa.

Os grupos de ferramentas

Permissões

Cada ferramenta precisa de uma ou mais permissões OAuth (escopos), que você concede na tela de consentimento ao se conectar. Uma ferramenta cujas permissões não foram concedidas fica totalmente fora da lista de ferramentas. O assistente nunca a vê, então não pode chamá-la e falhar.

Estas ferramentas não precisam de permissão e ficam sempre visíveis, nas edições que as têm: ping, list_models, start_film_director, start_video_director, start_workflow_editor, get_node_skill, get_picker_catalog, list_shot_shapes, get_shot_shape, list_brand_presets, get_recipe, get_studio_production_skill, get_recast_authoring_skill, validate_recast_script, build_ugc_creator, build_ugc_clips e build_ugc_cards.

As ferramentas que precisam de duas permissões só aparecem quando as duas foram concedidas. Uma conexão com apenas uma das duas não vê nenhuma dessas ferramentas.

Como um job informa o resultado

A maioria das ferramentas de geração inicia um job e responde na hora com uma linha como image collage started (id 7f3c…). O job é executado no Nodaro, e o resultado também é sempre salvo na sua biblioteca.

• Nos clientes que exibem MCP Apps, como o Claude na web, a ferramenta mostra um cartão. O cartão mostra o progresso em tempo real e depois o resultado pronto. As ferramentas de imagem, vídeo e áudio têm cartões próprios. Todas as outras ferramentas de job compartilham um cartão que detecta o tipo de saída. Ele mostra um player de vídeo, imagem ou áudio, um texto com o botão Copy para roteiros, letras, transcrições e dados de alinhamento, ou as saídas empilhadas de um componente.
• Nos outros clientes, o assistente verifica o job com get_job a cada 5 a 10 segundos, ou fica em espera por até 120 segundos com wait_for_job. Uma imagem costuma ficar pronta em até um minuto. Um vídeo costuma levar de 2 a 10 minutos.
• As execuções de workflows e apps retornam um ID de execução em vez de um ID de job. Verifique-o com get_app_run.

Os clientes compatíveis com a API tasks do MCP também recebem o progresso por ela. Quando um job aguarda revisão humana, numa implantação que revisa os resultados, a task do MCP mostra o status input_required. Essa decisão cabe ao revisor: não execute o job de novo.

O projeto mcp

As ferramentas de workflow trabalham dentro de um único projeto chamado mcp. O Nodaro cria esse projeto na primeira vez que um assistente precisa dele, e o painel lista os workflows dele em Workflows MCP. Nessa aba, você pode abri-los, movê-los ou excluí-los como qualquer outro workflow.

Para que um assistente trabalhe num workflow de outro projeto, exporte-o com export_workflow e importe o pacote com import_workflow. A cópia vai para o projeto mcp, e o original continua intacto.

Como ler a seção de uma ferramenta

Todas as ferramentas destas páginas seguem o mesmo formato:

• O título é o nome exato da ferramenta, por exemplo generate_image. Os assistentes chamam as ferramentas por esses nomes.
• As primeiras linhas dizem o que a ferramenta faz, a permissão de que ela precisa, quanto custa e se ela existe somente no Nodaro Cloud.
• A tabela de parâmetros lista os principais parâmetros com o tipo de cada um. Os parâmetros obrigatórios estão marcados como Obrigatório. Os valores padrão e os limites ficam nas observações.
• Retorna diz o que volta: na maioria das vezes, um ID de job; às vezes, um resultado, como um plano ou uma lista.

A descrição da própria ferramenta, que o assistente lê ao se conectar, é a palavra final sobre parâmetros e limites. O preço na descrição de uma ferramenta pode ser diferente do valor cobrado numa execução. list_models retorna os preços atuais dos modelos. O botão Executar de um nó mostra o preço da execução.

Convenções comuns a muitas ferramentas

• Mídia por URL ou por ID. As ferramentas que recebem mídia aceitam uma URL https pública, como image_url, ou um ID do Nodaro, como image_asset_id. O ID pode ser o do job que gerou a mídia ou o de um upload.
• Modelos por ID. Um parâmetro model recebe um ID de modelo de list_models, que também retorna as proporções, resoluções, durações e preços de cada modelo.
• Predefinições. generate_image, generate_video, generate_music, generate_speech e text_to_audio aceitam um presetId de list_node_presets. Os campos que você mesmo informa substituem os da predefinição.
• Tokens de nova tentativa. run_workflow, run_app, run_component e várias ferramentas de produção aceitam client_request_id: de 8 a 128 caracteres entre letras, dígitos e _ - . :. Reutilize o mesmo valor ao repetir uma chamada que expirou, e o Nodaro não inicia nem cobra o trabalho duas vezes.
• Cotações antes de gastar. Algumas ferramentas calculam o preço de um trabalho sem iniciá-lo, por exemplo as ferramentas do Studio com dry_run: true e start_recast sem confirm.

Ferramentas somente no Nodaro Cloud

Estas ferramentas existem somente no Nodaro Cloud: check_balance, credit_transactions, plan_edit, voice_changer_pro, voice_changer_pro_analyze, voice_changer_pro_export, create_explainer, create_launch_video, start_film_director e pro_3d_render. O mesmo vale para as ferramentas de espaço de trabalho, as ferramentas do Recast, as ferramentas de produção do Studio, as ferramentas de pipeline e os montadores de UGC. As ferramentas de espaço de trabalho também exigem que as organizações estejam ativadas, e pro_3d_render só aparece enquanto o mecanismo de renderização dela estiver disponível.