Conexões locais no aplicativo desktop
O aplicativo desktop pode iniciar servidores MCP locais via stdio. Isso dá à IA acesso a funcionalidades mais avançadas do Google e Microsoft, Nextcloud e outras ferramentas que um navegador não pode executar. O acesso a arquivos locais é incorporado e não requer um servidor MCP.
Integração inicial
Na primeira configuração, você passa pelos seguintes passos:
- Escolhe uma pasta padrão local para as ferramentas de arquivos incorporadas.
- Opcionalmente, pode escolher uma conexão local para Nextcloud.
- Opcionalmente, pode adicionar outros servidores MCP da loja de ferramentas.
Você pode adiar toda a integração inicial. A pasta padrão e quaisquer conexões adicionais podem ser configuradas posteriormente. Todas as escolhas de pasta são armazenadas apenas localmente.
A loja de ferramentas
Clique em Adicionar ferramentas ou Adicionar servidor MCP. Primeiro, você verá presets seguros que combinam com o aplicativo desktop. Somente ao escolher Adicionar um servidor MCP manualmente o formulário manual será aberto.
Presets comuns incluem:
| Preset | Funcionalidades | Autenticação |
|---|---|---|
| Nextcloud | Arquivos, agenda e contatos | Endereço do servidor, nome de usuário e senha de app |
| Memory | Armazenar e recuperar conhecimento | Armazenamento local |
A loja também pode mostrar presets para serviços como GitHub, Canva, Notion, Supabase, Mailchimp e outros servidores MCP adequados. A disponibilidade depende da plataforma, autenticação e catálogo atual.
Google e Microsoft
Google Workspace e Microsoft 365 são conexões incorporadas do AI-School. Funcionam na web, móvel e desktop e não dependem do OpenAI nem de um preset MCP local. Após a autorização única do Google ou Microsoft, as ferramentas disponíveis podem ser usadas com OpenAI, Claude, Gemini e Mistral, desde que o modelo escolhido suporte o uso de ferramentas.
Seleção dinâmica de ferramentas
Um servidor MCP pode oferecer dezenas de ferramentas. Por isso, o Desktop Deep Agent carrega primeiro informações compactas das ferramentas e seleciona as relevantes durante a tarefa. Assim, vários grandes servidores MCP podem estar ativos sem colocar todas as ferramentas simultaneamente no contexto do modelo.
Instalação segura
A instalação local do MCP tem uma separação rigorosa entre a interface Angular e o Electron:
- o renderer não inicia comandos shell arbitrários;
- comando, argumentos, chaves de ambiente e acessos solicitados são verificados;
- um diálogo nativo mostra o que está sendo iniciado;
- configurações aprovadas recebem uma prova de integridade;
- segredos são criptografados com o armazenamento seguro do sistema operacional;
- processos param ao desligar, remover, sair ou fechar.
Ao remover um servidor, as credenciais armazenadas localmente também são excluídas.
Status e testes
Em Neste computador você vê todos os servidores locais ativos em um só lugar. Nas configurações do chat, conexões locais e remotas ficam juntas em Conexões.
Teste um servidor com uma pergunta concreta, por exemplo:
- “Quais pastas estão no meu Nextcloud?”
- “Procure os últimos e-mails sobre o projeto.”
- “Quais arquivos estão nesta pasta local?”
Em caso de problemas, verifique o log do desktop. Uma conexão bem-sucedida mostra o nome do servidor e o número de ferramentas carregadas.
Solução de problemas
- Servidor ativo, mas a IA não vê ferramentas: reinicie o runtime local e verifique se o ID do servidor está na requisição do chat.
- Autenticação ausente: abra o servidor em Preferências → Ferramentas e escolha reconectar.
- Nextcloud não funciona: use a URL base do ambiente Nextcloud e uma senha de app separada.
- Arquivos locais inacessíveis: verifique se a pasta de trabalho ativa ainda existe e escolha-a novamente pelo dashboard, se necessário.
- Muitas ferramentas: mantenha a seleção dinâmica ativada e indique claramente na sua pergunta qual fonte é necessária.
Adicionar um servidor stdio manualmente
Prefira usar um preset. Adicione um servidor manualmente somente se confiar na origem e no comando. Antes de aprovar, verifique:
- executável e argumentos;
- chaves de ambiente;
- acesso ao sistema de arquivos;
- capacidades de leitura e escrita.
Veja também
Acesso a pastas locais
As ferramentas de arquivos incorporadas só podem ler ou modificar arquivos dentro da pasta de trabalho que você aprova explicitamente via o seletor de pastas nativo.
Cada caminho é resolvido para a localização canônica. Truques com prefixos semelhantes de uma pasta vizinha e links simbólicos que saem de uma pasta aprovada são rejeitados. Após reiniciar o runtime local, as permissões são sincronizadas novamente; sem uma pasta aprovada, o acesso a arquivos é negado por padrão.
Se você pedir à IA para excluir um arquivo ou subpasta, o aplicativo desktop move o item para a lixeira do sistema. Isso funciona no Windows, macOS e Linux. A própria pasta principal aprovada não pode ser movida para a lixeira via IA.
