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
- Confira se a URL é exatamente
https://mcp.nodaro.ai/mcp, sem barra no final. - Confira se
mcp.nodaro.aié resolvido na sua rede. - Confira o documento de descoberta. Este comando deve retornar
200com JSON:
curl https://mcp.nodaro.ai/.well-known/oauth-protected-resourceO 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. UmPOSTnela retorna405com o código de errowrong_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.
A tela de consentimento mostra um aviso laranja sobre o nome do cliente
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:
- Usar um cliente compatível, como Claude, ChatGPT, Cursor, Cline, Continue ou Goose.
- Registrar um app de desenvolvedor em app.nodaro.ai/settings/developer-apps e usar o ID do cliente e o segredo dele. Veja Seu próprio cliente.
- Na sua própria instância, pedir ao operador que adicione o nome do cliente a
MCP_DCR_ALLOWLISTou que definaMCP_DYNAMIC_REGISTRATION=open. Veja MCP em uma instalação auto-hospedada.
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:
| Onde | O 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 consentimento | 403 mcp_client_not_allowed. A página mostra a mensagem e nenhum botão Permitir. |
| A troca do código | 400 unauthorized_client |
| O endpoint do MCP, com o token de outro cliente, uma sessão com login ou um token de API pessoal | 403 mcp_client_not_allowed |
| O endpoint do MCP, enquanto o cliente não pode ser verificado | 503 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:writee deworkflows:execute. Com só uma delas, nenhuma dessas ferramentas aparece. - As ferramentas de espaço de trabalho precisam de
workspaces:readeworkspaces: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.
Uma chamada responde link_imports_disabled
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:
- Envie o arquivo com
request_image_upload,request_video_upload,request_audio_uploadou um widget de upload. Quando o seu cliente consegue enviar o arquivo sozinho, use uma ferramentaprepare_*_upload. - Passe o
public_urlque 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ódigo | Ferramenta | O que significa | O que fazer |
|---|---|---|---|
wrong_mcp_host | O servidor | O cliente chamou a página web em app.nodaro.ai/mcp | Use https://mcp.nodaro.ai/mcp |
client_not_allowed | Registro | O nome do cliente não é aceito | Use um cliente compatível ou um app de desenvolvedor |
too_many_open_registrations | Registro | Registros não usados demais de um mesmo cliente no modo aberto | Use os registros que você já tem ou espere |
dcr_disabled | Registro | A instância desativou o autorregistro, ou aceita só os clientes que ela configurou | Use um ID de cliente e um segredo fornecidos pelo operador, ou o app da própria implantação |
mcp_client_not_allowed | Login e servidor | A implantação aceita só os clientes MCP que ela configurou | Conecte-se pelo app que a implantação oferece |
node_not_available, model_not_available, world_not_available | Qualquer ferramenta | A implantação não oferece esse nó, modelo ou o Studio à sua conta | Atualize as ferramentas do cliente, ou fale com o administrador da implantação |
link_imports_disabled | Qualquer ferramenta com um link | A implantação não importa mídia por links para outros sites | Envie o arquivo e passe o que o upload retornar |
voice_not_found | Ferramentas de fala | O ID da voz não existe | Use o nome de uma voz pronta ou uma voz que você clonou |
advanced_mode_unsupported | Ferramentas de prompt e de texto | advanced_mode foi usado com um modelo que não é Gemini nem Claude | Escolha um modelo Gemini ou Claude, ou desative o modo avançado |
advanced_mode_unavailable | Ferramentas de prompt e de texto | O 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 reembolsados | Desative o modo avançado para executar o modelo, ou tente de novo mais tarde |
locked_field | run_app | inputOverrides tentou mudar para onde vai uma saída | Deixe os destinos como o app os define |
portrait_required | generate_character | O personagem não tem um retrato aprovado | Aprove um retrato com approve_portrait primeiro |
main_image_required | Ferramentas de locais, objetos e criaturas | Não há uma imagem principal aprovada | Aprove uma imagem principal primeiro |
candidate_object_mismatch, candidate_creature_mismatch | Ferramentas de aprovação | O candidato foi feito para outro objeto ou outra criatura | Aprove um candidato feito para ele |
scene_overlap | resolve_shot_sequence | Duas cenas têm revelações no mesmo trecho de tempo | Mantenha as deixas de cada cena antes das deixas da cena seguinte |
not_available | Ferramentas de produções do Studio | A implantação não oferece produções do Studio | Não tente de novo; o recurso não está disponível ali |
studio_preview_unavailable | edit_studio_production | A implantação não consegue pré-visualizar um lote | Nada foi enviado; decida com o usuário se o lote deve ser aplicado sem prévia |
not_finished | import_studio_production | A tarefa do plano ainda está em execução | Espere a tarefa terminar e depois importe |
cloud_only_feature | combine_videos | smart_cut foi usado em uma instalação auto-hospedada | Junte os clipes sem smart_cut |
payer_balance_jwt_only | check_balance, credit_transactions | A conta de cobrança compartilhada da implantação não pode ser lida por um cliente conectado | Veja 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.
Páginas relacionadas
Conectar um cliente
Tarefas
Seu próprio cliente
Nodaro MCP
Última atualização