Nodaro MCP

O servidor MCP do Nodaro permite que um assistente de IA use o Nodaro em seu nome. Você conecta o Claude, o ChatGPT, o Cursor ou outro cliente que fale o Model Context Protocol (MCP) e faz login com sua conta do Nodaro. Então, o assistente pode gerar imagens, vídeo, voz e música, montar e executar workflows, gerenciar seus personagens e dirigir filmes completos a partir de uma conversa. Tudo o que ele cria é salvo na sua biblioteca do Nodaro, e todo workflow que ele monta abre no editor.

A URL do servidor

https://mcp.nodaro.ai/mcp

Todos os clientes usam esta mesma URL. O servidor fala MCP pelo transporte Streamable HTTP e faz o seu login com OAuth, então não há chave de API para copiar.

Dois endereços parecidos não funcionam:

• https://api.nodaro.ai/mcp — esse domínio não existe, então a conexão falha antes de chegar ao Nodaro.
• https://app.nodaro.ai/mcp — esta é uma página web sobre o MCP, não o servidor.

Conectar em cerca de um minuto

O que um assistente pode fazer

O servidor oferece cerca de 200 ferramentas. O assistente as descobre quando se conecta; assim, você pede em palavras simples e ele escolhe as ferramentas.

Algumas ferramentas existem só para ensinar o assistente a trabalhar com o Nodaro. start_workflow_editor, get_node_skill, start_film_director, start_video_director e get_recipe retornam instruções em vez de mídia. Elas são gratuitas e não mudam nada na sua conta.

Login e permissões

O servidor usa o fluxo de código de autorização do OAuth 2.0 com PKCE. Na primeira vez que você se conecta, o cliente se registra no Nodaro e leva você à tela de consentimento.

• A tela de consentimento mostra o app, a conta do Nodaro com a qual ele se conecta e as permissões que ele pede. Clique em Usar outra conta para conectar outra conta.
• O nome do cliente não é verificado. Um cliente que se registrou sozinho escolheu o próprio nome, e a tela de consentimento mostra um aviso sobre isso. Aprove só quando o app for o mesmo que você está usando.
• O acesso dura 90 dias. Não há refresh tokens; por isso, depois de 90 dias, o cliente pede que você faça login de novo.
• Você pode revogar o acesso a qualquer momento. Abra Configurações › Apps conectados, em app.nodaro.ai/settings/connected-apps. A página lista todos os apps e assistentes de IA com acesso à sua conta, com a data em que cada um foi conectado, a data do último uso e as permissões que ele tem. Clique em Revogar acesso ao lado do assistente e confirme. O acesso dele termina na hora.

Permissões (escopos)

Cada ferramenta precisa de uma ou mais permissões. Uma ferramenta cujas permissões você não concedeu fica totalmente de fora da lista de ferramentas: ela não aparece para depois falhar.

Algumas ferramentas não precisam de permissão e estão sempre visíveis, como ping, list_models e as ferramentas de guia. A referência de ferramentas lista a permissão de cada ferramenta.

As permissões de espaço de trabalho não fazem parte das conexões autorizadas antes de os espaços de trabalho existirem. Para usar as ferramentas de espaço de trabalho, remova o conector e adicione-o de novo.

Quanto custa

• Conectar é gratuito. Não existe um plano separado para o MCP.
• As ferramentas de geração gastam créditos da sua conta do Nodaro, pelos mesmos preços do editor e da API. Créditos explica como os preços funcionam, e a página de cada modelo informa o preço dele.
• As ferramentas de descoberta e de guia são gratuitas, por exemplo list_models, get_node_skill, list_shot_shapes e get_recipe.
• Uma geração com falha é reembolsada. Os créditos reservados para um job que falhou voltam automaticamente. A exceção é uma falha no pós-processamento depois que o modelo já entregou o resultado.
• Algumas ferramentas informam o preço antes de gastar. start_recast sem confirm, plan_studio_export e as ferramentas do Studio com dry_run: true retornam um preço e não iniciam nada.
• Repetir é seguro com um token de repetição. run_workflow, run_app, run_component e várias ferramentas de produção aceitam client_request_id. Depois de um timeout, envie o mesmo valor de novo, e o Nodaro não inicia nem cobra a execução duas vezes.

No Nodaro Cloud, check_balance retorna seu saldo e credit_transactions lista suas compras.

Para onde vão seus resultados

• Sua biblioteca. Todo resultado é salvo na sua biblioteca do Nodaro, exatamente como uma execução feita no editor.
• Cartões de job. Em clientes que exibem MCP Apps, como o Claude na web, uma geração mostra um cartão com o progresso ao vivo e depois o resultado. Outros clientes verificam o job com get_job ou wait_for_job.
• O projeto mcp. Os workflows que o assistente cria ficam em um projeto chamado mcp, que o Nodaro cria no primeiro uso. O painel os lista em Workflows MCP. O assistente consegue ver os nomes de todos os seus projetos, mas só edita e executa os workflows do projeto mcp.
• A lista de execuções. Uma execução iniciada por um assistente tem o selo via MCP, ou o nome do cliente quando o Nodaro o conhece, como via Claude.

A página do MCP no nodaro.ai

nodaro.ai/pt-BR/mcp é o jeito rápido de se conectar. A página tem um botão Conectar ao Claude, um campo que copia a URL do servidor e uma aba com três etapas curtas para cada cliente. Esta documentação acrescenta as etapas completas de cada cliente, a referência de todas as ferramentas e guias para os diretores e os pipelines.

Nodaro Cloud e instalações self-hosted

O Nodaro Cloud roda o servidor MCP em mcp.nodaro.ai para todas as contas.

As instalações self-hosted Community e Business incluem o mesmo servidor, desativado por padrão. O operador o ativa e dá a ele um endereço próprio; veja MCP em uma instalação self-hosted. Conecte seu cliente a esse endereço em vez de mcp.nodaro.ai.

Algumas ferramentas só existem no Nodaro Cloud, por exemplo as ferramentas de produções do Studio e de recast, create_explainer, plan_edit e as ferramentas de créditos. Nas outras instalações, essas ferramentas não aparecem ou respondem not_available.

Próximos passos