# VS Code

> Instale o servidor MCP do Nodaro no VS Code com um link ou o comando MCP: Add Server, faça login com OAuth e use as ferramentas do Nodaro no modo agente.

Source: https://nodaro.ai/pt-BR/docs/mcp/connect/vs-code

Para conectar o **VS Code** ao Nodaro, instale o servidor MCP do Nodaro, `https://mcp.nodaro.ai/mcp`, como servidor HTTP. Depois que você faz login com sua conta do Nodaro, as ferramentas do Nodaro ficam disponíveis para o agente no modo agente.

## Instalar com um link
Abra o link **Install in VS Code**:

```text
https://vscode.dev/redirect/mcp/install?name=Nodaro&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.nodaro.ai%2Fmcp%22%7D
```

A página entrega o servidor ao VS Code. O VS Code abre com o nome, o transporte e a URL preenchidos e pede que você confirme. Para o VS Code Insiders, adicione `&quality=insiders` ao final do mesmo link.

O link leva esta configuração de servidor:

```json
{ "type": "http", "url": "https://mcp.nodaro.ai/mcp" }
```

## Instalar manualmente
### Adicionar o servidor
Abra a paleta de comandos, execute **MCP: Add Server** e escolha **HTTP**.

### Colar a URL
Cole `https://mcp.nodaro.ai/mcp` e dê ao servidor o nome Nodaro.

### Iniciar o servidor e fazer login
Confirme a instalação e inicie o servidor. 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**.

### Usar as ferramentas no modo agente
Mude o chat para o modo agente. As ferramentas do Nodaro ficam disponíveis. Peça, por exemplo: “Gere uma imagem de um cavaleiro com o Nodaro.”

O VS Code documenta os servidores MCP em [Use MCP servers in VS Code](https://code.visualstudio.com/docs/copilot/customization/mcp-servers).

## Trabalhar com arquivos no editor
Quando o agente tem permissão para executar comandos no terminal, ele consegue enviar arquivos locais diretamente. As ferramentas `prepare_image_upload`, `prepare_audio_upload` e `prepare_video_upload` retornam uma URL de upload pré-assinada, e o agente envia o arquivo para ela com uma requisição `PUT`. Sem acesso ao terminal, use `request_image_upload` e as outras ferramentas de solicitação: elas retornam um link que você abre no navegador para soltar o arquivo. Veja [Ferramentas de upload](https://nodaro.ai/docs/mcp/tools/uploads).

Um agente em um editor também é um bom lugar para montar workflows em JSON. Peça a ele que chame `start_workflow_editor` primeiro; essa ferramenta retorna o formato do workflow e a lista de tipos de nó. Veja [Ferramentas de projetos e workflows](https://nodaro.ai/docs/mcp/tools/projects-and-workflows).

## Se a conexão falhar
- **O servidor não inicia ou o login falha.** Confira se a URL é exatamente `https://mcp.nodaro.ai/mcp`, sem barra no final.
- **O servidor roda, mas nenhuma ferramenta aparece.** Algumas permissões não foram concedidas. Remova o servidor, adicione-o de novo e conceda todas as permissões.

Mais soluções estão em [Solução de problemas](https://nodaro.ai/docs/mcp/troubleshooting).

## Frequently asked questions

### Como adiciono o Nodaro ao VS Code com um clique?

Abra o link Install in VS Code. Ele entrega o servidor ao VS Code com o nome, o transporte e a URL preenchidos, e o VS Code pede que você confirme a instalação.

### Onde as ferramentas do Nodaro aparecem no VS Code?

No modo agente. Inicie o servidor depois da instalação, faça login com o Nodaro quando o navegador abrir, e as ferramentas ficam disponíveis para o agente.

### O link de instalação funciona com o VS Code Insiders?

Sim. Adicione quality=insiders ao mesmo link, e ele abre o VS Code Insiders em vez do VS Code.

### Posso enviar arquivos locais para o Nodaro pelo VS Code?

Sim. As ferramentas que preparam o upload retornam uma URL de upload para a qual um cliente com acesso ao shell pode enviar o arquivo, e as ferramentas que solicitam o upload retornam um link que você abre no navegador.