# Nodaro MCP

> Conecte Claude, ChatGPT, Cursor ou qualquer cliente MCP ao Nodaro e gere mídia, crie e execute workflows, gerencie personagens e dirija filmes no chat.

Source: https://nodaro.ai/pt-BR/docs/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
```text
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
### Copiar a URL
Copie `https://mcp.nodaro.ai/mcp`.

### Adicionar a URL ao cliente
Abra as configurações de conectores ou de MCP do seu cliente e adicione um servidor remoto com a URL. O Claude, o VS Code, o Cursor e o Goose também têm um link que abre a caixa de diálogo com os dados preenchidos. [Conectar um cliente](https://nodaro.ai/docs/mcp/connect) traz as etapas exatas de cada cliente.

### Fazer login e permitir o acesso
O navegador abre a página de login do Nodaro. Faça login, revise as permissões na tela de consentimento e clique em **Permitir**.

### Fazer um pedido
Peça ao assistente, por exemplo: “Gere uma imagem de um cavaleiro com o Nodaro.” Para testar só a conexão, peça que ele chame a ferramenta `ping`. A ferramenta responde com seu ID de usuário do Nodaro e o nome do seu cliente.

## 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.

| Objetivo | Principais ferramentas | Saiba mais |
| --- | --- | --- |
| Criar e editar imagens | `generate_image`, `modify_image`, `edit_image`, `image_overlay` | [Ferramentas de imagem](https://nodaro.ai/docs/mcp/tools/image) |
| Criar vídeo a partir de texto ou de uma imagem | `generate_video`, `animate_image`, `extend_video`, `lip_sync` | [Ferramentas de vídeo](https://nodaro.ai/docs/mcp/tools/video) |
| Cortar, legendar e montar vídeos | `trim_video`, `combine_videos`, `add_captions`, `overlay_images` | [Ferramentas de edição de vídeo](https://nodaro.ai/docs/mcp/tools/video-editing) |
| Voz, efeitos sonoros e música | `generate_speech`, `generate_dialogue`, `text_to_audio`, `suno_generate` | [Ferramentas de áudio](https://nodaro.ai/docs/mcp/tools/audio), [Ferramentas de música](https://nodaro.ai/docs/mcp/tools/music) |
| Montar, editar e executar workflows | `create_workflow`, `update_workflow_json`, `run_workflow` | [Ferramentas de projetos e workflows](https://nodaro.ai/docs/mcp/tools/projects-and-workflows) |
| Executar seus apps publicados e componentes salvos | `run_app`, `run_component` | [Ferramentas de apps e componentes](https://nodaro.ai/docs/mcp/tools/apps-and-components) |
| Manter consistente um personagem, um lugar ou um adereço | `create_character`, `generate_location`, `generate_object`, `generate_creature` | [Ferramentas de personagens](https://nodaro.ai/docs/mcp/tools/characters) |
| Dirigir um filme | `start_film_director`, as ferramentas de produções do Studio, as ferramentas de recast | [Film Director](https://nodaro.ai/docs/mcp/film-director), [Produções do Studio](https://nodaro.ai/docs/mcp/studio-productions), [Recast](https://nodaro.ai/docs/mcp/recast) |
| Fazer um vídeo narrado de motion graphics | `create_explainer`, `create_launch_video` | [Diretor de vídeo](https://nodaro.ai/docs/mcp/video-director) |
| Montar e renderizar uma cena 3D | `generate_3d_scene`, `edit_3d_scene`, `render_3d_scene` | [Cenas 3D](https://nodaro.ai/docs/mcp/3d-scenes) |
| Seguir um guia testado de várias etapas | `get_recipe` | [Receitas de conteúdo](https://nodaro.ai/docs/mcp/recipes) |

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](https://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.

| Escopo | O que permite |
| --- | --- |
| `workflows:read` | Ler seus projetos, workflows, componentes salvos e produções do Studio |
| `workflows:write` | Criar, alterar, importar e excluir workflows no projeto mcp, e criar e editar produções |
| `workflows:execute` | Executar workflows, apps e componentes, e usar todas as ferramentas de geração |
| `jobs:read` | Ler seus jobs e execuções, esperar por um job e diagnosticar uma falha |
| `assets:read` | Navegar pela sua galeria, seus uploads e favoritos, e ler seus personagens, locais, objetos e criaturas |
| `assets:write` | Enviar arquivos, criar e atualizar personagens e locais, aprovar imagens e marcar favoritos |
| `credits:read` | Ler seu saldo de créditos e seu histórico de compras |
| `apps:read` | Listar apps publicados e ler as entradas deles |
| `presets:read` | Listar e ler predefinições de nós |
| `pipelines:read`, `pipelines:execute`, `pipelines:approve` | Ler, executar e aprovar pipelines do Story to Video |
| `workspaces:read`, `workspaces:write` | Listar seus espaços de trabalho e escolher aquele em que a sessão trabalha |

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](https://nodaro.ai/docs/mcp/tools) 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](https://nodaro.ai/docs/concepts/credits) 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](https://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](https://nodaro.ai/docs/self-hosting/mcp). 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
  - [Conectar um cliente](https://nodaro.ai/docs/mcp/connect): Configuração passo a passo para Claude, ChatGPT, VS Code, Cursor, Cline, Continue, Goose e seu próprio cliente.
  - [Referência de ferramentas](https://nodaro.ai/docs/mcp/tools): Cada ferramenta, com seus parâmetros, sua permissão e seu preço.
  - [Film Director](https://nodaro.ai/docs/mcp/film-director): Descreva um filme e veja o assistente montá-lo no seu canvas.
  - [Solução de problemas](https://nodaro.ai/docs/mcp/troubleshooting): Resolva erros de login, ferramentas ausentes e jobs com falha.

## Frequently asked questions

### Qual é a URL do servidor MCP do Nodaro?

A URL é https://mcp.nodaro.ai/mcp, e ela é a mesma para todos os clientes. Os clientes se conectam por Streamable HTTP e fazem login com OAuth, então você nunca cola uma chave de API.

### Usar o Nodaro por um assistente de IA custa mais?

Não. Conectar é gratuito. As ferramentas que geram mídia gastam créditos da sua conta do Nodaro pelos mesmos preços do editor, e as ferramentas de descoberta e de guia não custam nada.

### Quais assistentes de IA podem se conectar ao Nodaro?

Claude, ChatGPT no Developer mode, VS Code, Cursor, Cline, Continue, Goose e outros clientes compatíveis com servidores MCP remotos por Streamable HTTP com login OAuth.

### Por que meu assistente não vê algumas ferramentas do Nodaro?

Uma ferramenta cuja permissão você não concedeu fica totalmente de fora da lista de ferramentas, e algumas ferramentas só existem no Nodaro Cloud. Remova o conector, adicione-o de novo e conceda todas as permissões na tela de consentimento.

### Posso usar o MCP com uma instalação self-hosted do Nodaro?

Sim, quando o operador ativa o servidor MCP nessa instância. Seu assistente então se conecta ao endereço MCP da própria instância, em vez de mcp.nodaro.ai.