NodaroAccount
Docs do Nodaro
DocumentaçãoReferência de nósModelosTemplatesAgentes de IA (MCP)DesenvolvedoresAuto-hospedagemPesquisaComparações
Referência das ferramentas

Referência das ferramentas MCP

Todas as ferramentas do servidor MCP do Nodaro, por finalidade: a permissão de cada uma, como as tarefas informam o resultado e como ler cada ferramenta.

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

GrupoPara que servem
TarefasVerificar, aguardar, listar, avaliar e diagnosticar tarefas e execuções
UploadsTrazer suas próprias imagens, áudios e vídeos para o Nodaro
Galeria e mídiasNavegar pela galeria e pelos uploads, mostrar um resultado no chat e marcar favoritos
Modelos, créditos e predefiniçõesListar os modelos com seus recursos e preços, ler o seu saldo, e salvar e aplicar predefinições de nó
Espaços de trabalhoEscolher o espaço de trabalho da organização em que uma sessão trabalha
Projetos e workflowsCriar, editar, importar, exportar e executar workflows, aprender como os nós são montados e organizar sessões de criação
Apps e componentesExecutar apps publicados e componentes salvos
PipelinesIniciar, orientar e aprovar pipelines do História → vídeo
Prompts e textoEscrever prompts melhores, perguntar a qualquer LLM sobre imagens, vídeos, áudios e PDFs, escrever roteiros e escolher o melhor entre vários resultados
ImagemGerar, transformar, editar, compor e descrever imagens, e salvar paletas e painéis de inspiração
VídeoGerar, estender, mudar o estilo e aumentar a resolução de vídeos, e fazer pessoas falarem e se moverem
Edição de vídeoCortar, juntar, repetir em loop, legendar, sobrepor e montar vídeos
Análise e listas de ediçãoAnalisar um vídeo cena a cena, detectar planos e silêncio, sincronizar gravações, renderizar listas de decisões de edição e transformar podcasts em episódios, capítulos, trailers e clipes
ÁudioFala, diálogos, vozes, dublagem, efeitos sonoros, transcrição e limpeza
MúsicaMúsicas e instrumentais com o Suno e outros modelos de música
PersonagensCriar personagens, gerar seus retratos e variações, animá-los e treinar modelos de personagem
LocaisCriar locais e gerar planos de estabelecimento e clipes de atmosfera
Objetos e criaturasAdereços, produtos, animais e criaturas com aparência fixa
Sequência de tomadas e Diretor de vídeoVídeos narrados de gráficos animados, sincronizados com a narração
Produções do StudioFilmes que você pode continuar editando no editor do Studio
RecastUm filme escrito como um único roteiro JSON e renderizado como um projeto do Recast
Cenas 3DCenas 3D editáveis, renderizadas em vídeo
Utilitários, receitas e skillsTestar a conexão, carregar receitas e skills, capturar páginas da web e montar vídeos UGC

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.

EscopoFerramentas
workflows:readlist_projects, get_project, list_workflows, get_workflow, get_workflow_json, export_workflow, list_components, get_component_inputs, get_recast_status, validate_studio_plan, list_studio_productions, get_studio_production, plan_studio_export
workflows:writecreate_workflow, delete_workflow, update_workflow_json, import_workflow, import_recast_script, create_studio_production, import_studio_production, edit_studio_production, share_studio_production, clone_studio_production
workflows:executerun_workflow, render_final, run_app, retry_app_run, run_component, delete_app_run, mix_audio, capture_site, todas as ferramentas de geração, edição e análise de imagem, vídeo, áudio, música, entidades e cenas 3D, as ferramentas de prompt, generate_text, reduce, as ferramentas de sequência de tomadas, create_explainer, create_launch_video, start_recast, resolve_recast_gate, video_remake, estimate_trend, run_trend, shot_cuts, speaker_map, speaker_view, tighten_episode, make_chapters, make_trailer, make_clip_pack, speaker_layout, estimate_use_case, continue_use_case
workflows:write e workflows:execute juntasdescribe_studio_production, generate_studio_still, generate_studio_keyframe, generate_studio_clip, new_studio_shot_from_frame, voice_studio_shot, revoice_studio_clip, score_studio_production
workflows:execute e assets:write juntastrain_character
jobs:readlist_jobs, get_job, wait_for_job, diagnose_run, list_sessions, read_session, list_trash, list_trends, get_trend
assets:readbrowse_gallery, browse_uploads, list_favorites, get_asset, display_asset, get_app_run, list_characters, get_character, list_locations, get_location, list_objects, get_object, list_creatures, get_creature, list_palettes, list_moodboards, list_voice_favorites, get_dubbing, get_dubbing_captions
assets:writefavorite_asset, create_character, update_character, approve_portrait, recaption_character, create_location, update_location, approve_main_image, recaption_location, approve_object_main_image, recaption_object, approve_creature_main_image, recaption_creature, rate_job, create_session, update_session, restore_job, save_palette, save_moodboard, save_node_preset, delete_node_preset, favorite_node_preset, favorite_voice, add_dubbing_language e as nove ferramentas de upload
credits:readcheck_balance, credit_transactions
apps:readlist_apps, get_app_inputs
presets:readlist_node_presets, get_node_preset
pipelines:readget_pipeline_stage_chat, get_pipeline_status, pipeline_pending_approvals
pipelines:executebranch_pipeline, start_pipeline
pipelines:approvechat_pipeline_stage, apply_chat_proposal
workspaces:readlist_workspaces
workspaces:writeselect_workspace

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, build_ugc_cards, ugc_split_speech e ugc_finish_clips.

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.

Em uma implantação que oferece menos nós, modelos ou recursos que o Nodaro Cloud, uma ferramenta só aparece na lista quando tudo de que ela precisa é oferecido a você. Uma ferramenta que executa um nó aparece enquanto esse nó é oferecido. As ferramentas que leem os seus próprios dados, agem sobre trabalhos já feitos, tratam envios, executam os seus workflows, apps e componentes salvos ou fornecem documentação aparecem sempre. Uma chamada a uma ferramenta que não é mais oferecida é recusada antes de qualquer início ou cobrança, com 403 node_not_available, model_not_available, link_imports_disabled ou world_not_available.

Como uma tarefa informa o resultado

A maioria das ferramentas de geração inicia uma tarefa e responde na hora com uma linha como image collage started (id 7f3c…). A tarefa é executada 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 tarefa compartilham um cartão que detecta o tipo de saída. Ele mostra um vídeo, uma imagem ou um áudio para reproduzir, 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 a tarefa com get_job a cada 5 a 10 segundos, ou fica em espera por até 45 segundos por chamada 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 tarefa. Verifique-o com get_app_run.

Os clientes compatíveis com a API tasks do MCP também recebem o progresso por ela. Quando uma tarefa aguarda revisão humana, numa implantação que revisa os resultados, a API tasks do MCP mostra o status input_required para ela. Essa decisão cabe ao revisor: não execute a tarefa 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.

FerramentasO que podem acessar
list_projects, get_projectTodos os seus projetos, somente leitura
list_workflows, get_workflow, get_workflow_jsonWorkflows do projeto mcp
create_workflow, delete_workflow, update_workflow_json, import_workflowWorkflows do projeto mcp
export_workflowQualquer um dos seus workflows
run_workflow, render_finalWorkflows do projeto mcp

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 tarefa; à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 da tarefa que gerou a mídia ou o de um upload. É aceita a tarefa de qualquer nó que produza esse tipo de mídia, por exemplo uma tarefa de still_to_video ou de slideshow como video_asset_id. Uma tarefa sem essa mídia é recusada.
  • 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, video_remake, run_trend e full_quality sem confirm, e estimate_use_case para as ferramentas de podcast.

Ferramentas somente no Nodaro Cloud

Estas ferramentas existem somente no Nodaro Cloud: check_balance, credit_transactions, train_character, plan_edit, switch_cameras, speaker_view, voice_changer_pro, voice_changer_pro_analyze, voice_changer_pro_export, create_explainer, create_launch_video, start_film_director, pro_3d_render e video_remake. O mesmo vale para as ferramentas de trends, as ferramentas de espaço de trabalho, as ferramentas do Recast, as ferramentas de produção do Studio, as ferramentas de pipeline e as ferramentas de UGC. O mesmo vale para estimate_full_quality e full_quality. 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.

Perguntas frequentes

Quantas ferramentas o servidor MCP do Nodaro tem?

Cerca de 200 no Nodaro Cloud. A lista exata depende das permissões que você concedeu e da sua edição, porque uma ferramenta que você não pode usar fica fora da lista de ferramentas.

Como o meu assistente recebe o resultado de uma geração?

Uma ferramenta de geração inicia uma tarefa e retorna o ID dela na hora. Os clientes que exibem MCP Apps mostram um cartão com o progresso em tempo real e o resultado; os outros clientes chamam get_job ou wait_for_job com esse ID.

Por que o assistente só pode editar workflows do projeto mcp?

As ferramentas de workflow trabalham dentro de um único projeto chamado mcp, então um assistente nunca altera os seus próprios projetos. Ainda assim, ele pode ler qualquer workflow com export_workflow e importar uma cópia para o projeto mcp.

Quais ferramentas são grátis?

As ferramentas de descoberta e de guia, como ping, list_models, get_node_skill, get_picker_catalog, list_shot_shapes e get_recipe, não custam nada. Toda ferramenta que gera, edita ou analisa mídia gasta créditos.

Última atualização

Nesta página