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

Solução de problemas

Resolva problemas comuns do Nodaro MCP, de URL errada, login com falha e ferramentas ausentes a tarefas com falha, uploads e códigos como client_not_allowed.

Esta página lista os problemas mais comuns com o servidor MCP do Nodaro e como resolvê-los. Ela cobre erros de conexão e de login, ferramentas que não aparecem, tarefas que falham ou parecem travadas, uploads e os códigos de erro que as ferramentas retornam. Comece pela seção que corresponde ao que você vê.

Conexão e login

O cliente mostra um erro de OAuth quando você adiciona o conector

  1. Confira se a URL é exatamente https://mcp.nodaro.ai/mcp, sem barra no final.
  2. Confira se mcp.nodaro.ai é resolvido na sua rede.
  3. Confira o documento de descoberta. Este comando deve retornar 200 com JSON:
curl https://mcp.nodaro.ai/.well-known/oauth-protected-resource

O mesmo host também serve /.well-known/oauth-authorization-server, que também deve retornar 200 com JSON.

O login nunca termina, ou a URL está errada

O servidor só responde em https://mcp.nodaro.ai/mcp. Dois erros comuns falham antes de o login chegar ao Nodaro:

  • https://api.nodaro.ai/mcp: esse domínio não existe, então a conexão falha na consulta do nome.
  • https://app.nodaro.ai/mcp: esta é a página web do MCP, não o servidor. Um POST nela retorna 405 com o código de erro wrong_mcp_host, que informa a URL correta.

O Claude não permite editar a URL de um conector. Exclua o conector com problema e adicione-o de novo com https://mcp.nodaro.ai/mcp.

Isso é esperado. Um cliente que se registra sozinho escolhe o próprio nome, como “Claude”, e o Nodaro não verifica esse nome. O aviso lembra você de conferir se o app que pede acesso é o mesmo que você está configurando antes de clicar em Permitir.

O registro falha com “Client not allowed”

Seu cliente se registrou com um nome que não está na lista de clientes aceitos. Você pode:

A implantação aceita conexões MCP somente dos clientes que ela configurou

Algumas implantações só deixam conectar os clientes MCP que elas mesmas configuraram. O operador lista esses clientes em MCP_ALLOWED_CLIENT_IDS. Em uma implantação assim, qualquer outro cliente é barrado onde quer que tente:

OndeO que volta
Registro (POST /v1/oauth/register)403 dcr_disabled
Login (GET /v1/oauth/authorize)O navegador volta para o callback do cliente com error=unauthorized_client. Nenhuma tela de consentimento é mostrada.
A página de consentimento403 mcp_client_not_allowed. A página mostra a mensagem e nenhum botão Permitir.
A troca do código400 unauthorized_client
O endpoint do MCP, com o token de outro cliente, uma sessão com login ou um token de API pessoal403 mcp_client_not_allowed
O endpoint do MCP, enquanto o cliente não pode ser verificado503 mcp_client_check_failed. Tente de novo.

Não há nada a mudar no seu cliente. Em uma implantação assim, conecte-se pelo app que a implantação oferece.

O assistente parou de funcionar depois de um tempo

O acesso dura 90 dias, e não há tokens de atualização. Quando ele expira, as chamadas retornam 401. Faça login de novo pelo seu cliente ou remova o conector e adicione-o de novo.

Execuções que você não iniciou mostram “via MCP”

Um cliente MCP conectado as iniciou em seu nome. 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 e usado pela última vez.

  • Um assistente que se registrou sozinho aparece como “Assistente de IA (MCP) — o nome foi definido pelo assistente”. O Nodaro não verificou esse nome.
  • Para remover um app que você não reconhece, clique em Revogar acesso e confirme. O acesso dele termina na hora, e os tokens dele param de funcionar.

Ferramentas ausentes

O cliente está conectado, mas não mostra nenhuma ferramenta, ou só algumas

Uma ferramenta cuja permissão você não concedeu fica totalmente de fora da lista de ferramentas. Remova o conector, adicione-o de novo e conceda todas as permissões na tela de consentimento. Algumas ferramentas também precisam de mais de uma permissão:

  • As ferramentas de geração do Studio precisam de workflows:write e de workflows:execute. Com só uma delas, nenhuma dessas ferramentas aparece.
  • As ferramentas de espaço de trabalho precisam de workspaces:read e workspaces:write, que as conexões autorizadas antes de os espaços de trabalho existirem não têm. Conecte-se de novo para obtê-las.

Permissões lista qual ferramenta precisa de qual permissão.

Uma ferramenta da documentação não aparece na sua lista

Algumas ferramentas só existem no Nodaro Cloud, como as ferramentas de pipeline, de produções do Studio, de recast e de espaço de trabalho, start_film_director, create_explainer, plan_edit, voice_changer_pro, pro_3d_render e as ferramentas de créditos. 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. Veja Ferramentas só no Nodaro Cloud.

Uma ferramenta falta em uma implantação, ou responde node_not_available

Uma implantação pode oferecer menos nós, modelos e recursos que o Nodaro Cloud. A lista de ferramentas dela então acompanha o que ela oferece à sua conta: uma ferramenta só aparece quando tudo de que ela precisa é oferecido a você. Um cliente que guardou uma lista de ferramentas mais antiga ainda pode chamar uma ferramenta assim. A chamada é recusada antes de qualquer execução ou cobrança, com 403 node_not_available, model_not_available, link_imports_disabled ou world_not_available. Peça ao seu cliente que atualize as ferramentas, ou peça ao administrador da implantação que ofereça o que você precisa. A lista acompanha uma mudança na implantação em cerca de um minuto.

Tarefas e resultados

Uma geração falhou

Peça ao assistente que chame get_job ou diagnose_run com o ID da tarefa. Leia retryable e guidance: quando retryable é false, o mesmo pedido vai falhar de novo se nada mudar; por isso, mude as configurações ou a entrada. Quando suggestedProvider estiver presente, execute o mesmo prompt e as mesmas referências nesse modelo. Quando uma tarefa falha traz os detalhes. Os créditos reservados para uma tarefa com falha são reembolsados, exceto depois de uma falha no pós-processamento.

Uma tarefa mostra pending_review

A implantação retém os resultados para uma pessoa revisar. A tarefa ainda está em andamento, não falhou. Continue verificando a tarefa e não a execute de novo: uma duplicata também ficaria retida.

wait_for_job retorna timeout

Isso não é um erro. A tarefa ainda estava em execução quando a espera terminou, depois de no máximo 120 segundos. Chame wait_for_job de novo ou consulte get_job periodicamente, a cada 5 a 10 segundos. Os vídeos costumam levar de 2 a 10 minutos.

Uma recusa por saldo diz para falar com o operador da implantação

Algumas implantações gerenciam elas mesmas o saldo dos usuários, por exemplo sem compra por conta própria ou com uma carteira externa. Nelas, uma ferramenta recusada por falta de saldo diz que a implantação gerencia o saldo e que o usuário pode pedir mais ao operador dela. Em uma implantação assim, nada pode ser comprado a partir de um cliente conectado. check_balance mostra o que resta ao usuário, na unidade própria da implantação quando ela tem uma. Um valor que não pôde ser lido é null, nunca 0.

O cartão do resultado não aparece

Os cartões precisam de um cliente que exiba MCP Apps, como o Claude na web. Em outros clientes, peça ao assistente que verifique a tarefa com get_job. O resultado é sempre salvo na sua biblioteca.

Uma execução foi cobrada duas vezes depois de um timeout

Passe um client_request_id em run_workflow, run_app, run_component e nas ferramentas de produção, e reutilize o mesmo valor quando repetir a chamada. Assim, o Nodaro retorna a primeira execução em vez de iniciar e cobrar uma segunda.

Uploads

prepare_image_upload falha no Claude na web

O upload pré-assinado precisa de um cliente que consiga acessar o host de armazenamento por um shell, como Cursor, Cline, Claude Desktop ou Claude Code. No Claude na web e no Android, use upload_image_widget, ou request_image_upload, que dá a você um link para abrir no navegador. Veja Ferramentas de upload.

Request failed (403 link_imports_disabled): Importing media from a link to another site is turned off on this deployment. Upload the file instead.

A implantação não importa mídia de outros sites, e um dos argumentos da chamada é um link para outro site. O link pode ser a URL de uma imagem, de um clipe ou de um som, uma referência, uma página, ou um link nas entradas de um app, em um plano ou nos nós de um workflow. A chamada foi recusada antes de qualquer execução ou cobrança. Para continuar:

  1. Envie o arquivo com request_image_upload, request_video_upload, request_audio_upload ou um widget de upload. Quando o seu cliente consegue enviar o arquivo sozinho, use uma ferramenta prepare_*_upload.
  2. Passe o public_url que o upload retornou, ou o ID do arquivo, onde estava o link.

Um resultado que a implantação criou, um ID de arquivo, um ID de tarefa e o ID de um personagem, objeto ou local são sempre aceitos. Um link para o armazenamento da própria implantação também é recusado quando não está escrito exatamente como a implantação o forneceu, por exemplo com um host em maiúsculas, um espaço, uma barra invertida ou ... Passe o link exatamente como um resultado ou um upload o retornou. Um link dentro de um prompt é texto e nunca é recusado.

Workflows

update_workflow_json diz que o workflow foi modificado

Alguém alterou o workflow depois que você o leu. Leia-o de novo com get_workflow_json e envie a alteração de novo com a nova versão.

Uma configuração que você enviou não é a que foi salva

Um modelo não aceita todas as proporções, resoluções ou qualidades. O Nodaro troca um valor não suportado por um suportado, ou o remove, e lista cada mudança em adjustments. Não envie o valor original de novo; escolha um modelo que o aceite, usando list_models.

O canvas do Film Director continua vazio

A skill adiciona os nós de uma etapa de uma só vez, depois que você aprova a etapa. Espere o Claude dizer que os adicionou e então atualize a página. Mais soluções estão em Film Director.

Códigos de erro

CódigoFerramentaO que significaO que fazer
wrong_mcp_hostO servidorO cliente chamou a página web em app.nodaro.ai/mcpUse https://mcp.nodaro.ai/mcp
client_not_allowedRegistroO nome do cliente não é aceitoUse um cliente compatível ou um app de desenvolvedor
too_many_open_registrationsRegistroRegistros não usados demais de um mesmo cliente no modo abertoUse os registros que você já tem ou espere
dcr_disabledRegistroA instância desativou o autorregistro, ou aceita só os clientes que ela configurouUse um ID de cliente e um segredo fornecidos pelo operador, ou o app da própria implantação
mcp_client_not_allowedLogin e servidorA implantação aceita só os clientes MCP que ela configurouConecte-se pelo app que a implantação oferece
node_not_available, model_not_available, world_not_availableQualquer ferramentaA implantação não oferece esse nó, modelo ou o Studio à sua contaAtualize as ferramentas do cliente, ou fale com o administrador da implantação
link_imports_disabledQualquer ferramenta com um linkA implantação não importa mídia por links para outros sitesEnvie o arquivo e passe o que o upload retornar
voice_not_foundFerramentas de falaO ID da voz não existeUse o nome de uma voz pronta ou uma voz que você clonou
advanced_mode_unsupportedFerramentas de prompt e de textoadvanced_mode foi usado com um modelo que não é Gemini nem ClaudeEscolha um modelo Gemini ou Claude, ou desative o modo avançado
advanced_mode_unavailableFerramentas de prompt e de textoO provedor do próprio modelo não consegue aceitar requisições do modo avançado agora. Os créditos não são cobrados, ou são reembolsadosDesative o modo avançado para executar o modelo, ou tente de novo mais tarde
locked_fieldrun_appinputOverrides tentou mudar para onde vai uma saídaDeixe os destinos como o app os define
portrait_requiredgenerate_characterO personagem não tem um retrato aprovadoAprove um retrato com approve_portrait primeiro
main_image_requiredFerramentas de locais, objetos e criaturasNão há uma imagem principal aprovadaAprove uma imagem principal primeiro
candidate_object_mismatch, candidate_creature_mismatchFerramentas de aprovaçãoO candidato foi feito para outro objeto ou outra criaturaAprove um candidato feito para ele
scene_overlapresolve_shot_sequenceDuas cenas têm revelações no mesmo trecho de tempoMantenha as deixas de cada cena antes das deixas da cena seguinte
not_availableFerramentas de produções do StudioA implantação não oferece produções do StudioNão tente de novo; o recurso não está disponível ali
studio_preview_unavailableedit_studio_productionA implantação não consegue pré-visualizar um loteNada foi enviado; decida com o usuário se o lote deve ser aplicado sem prévia
not_finishedimport_studio_productionA tarefa do plano ainda está em execuçãoEspere a tarefa terminar e depois importe
cloud_only_featurecombine_videossmart_cut foi usado em uma instalação auto-hospedadaJunte os clipes sem smart_cut
payer_balance_jwt_onlycheck_balance, credit_transactionsA conta de cobrança compartilhada da implantação não pode ser lida por um cliente conectadoVeja o saldo no app

Perguntas frequentes

Por que meu cliente mostra o Nodaro como conectado, mas não lista nenhuma ferramenta?

As permissões concedidas na tela de consentimento não cobrem as ferramentas. Remova o conector, adicione-o de novo e conceda todas as permissões.

Qual URL devo usar para o servidor MCP do Nodaro?

Exatamente https://mcp.nodaro.ai/mcp, sem barra no final. api.nodaro.ai não existe, e app.nodaro.ai/mcp é uma página web, não o servidor.

O que significa client_not_allowed?

Seu cliente se registrou com um nome que não está na lista de clientes aceitos. Use um cliente compatível ou registre um app de desenvolvedor nas suas configurações do Nodaro e use o ID do cliente e o segredo dele.

Meu assistente parou de funcionar depois de alguns meses. Por quê?

O acesso de um cliente MCP dura 90 dias, e não há tokens de atualização. Faça login de novo pelo seu cliente ou remova o conector e adicione-o de novo.

Vejo execuções marcadas com via MCP que eu não iniciei. O que devo fazer?

Um cliente conectado as iniciou em seu nome. Abra Configurações › Apps conectados, em app.nodaro.ai/settings/connected-apps, revise todos os apps e assistentes com acesso à sua conta e revogue os que você não reconhece. A revogação encerra o acesso na hora.

O que significa link_imports_disabled?

A implantação à qual você está conectado não importa mídia por links para outros sites. Envie o arquivo com uma ferramenta de upload e passe o public_url ou o ID do arquivo que ela retornar, no lugar do link. Nada foi executado nem cobrado.

Última atualização

Nesta página