Ligaçõ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 está incorporado e não requer um servidor MCP.
Integração inicial
Na primeira configuração, siga estas etapas:
- Escolha uma pasta padrão local para as ferramentas de arquivos incorporadas.
- Opcionalmente, escolha uma ligação local para Nextcloud.
- Opcionalmente, adicione outros servidores MCP da loja de ferramentas.
Você pode adiar toda a integração inicial. A pasta padrão e quaisquer ligaçõ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.
| 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 GitHub, Canva, Notion, Supabase, Mailchimp e outros servidores MCP adequados. A disponibilidade depende da plataforma, autenticação e política de segurança da informação.
Google e Microsoft
Google Workspace e Microsoft 365 são ligações incorporadas do AI-Public. 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. O Desktop Deep Agent seleciona as ferramentas relevantes durante a tarefa. Isso permite que vários grandes servidores MCP estejam ativos sem colocar todas as ferramentas simultaneamente no contexto do modelo.
Instalação segura
- 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 estão todos os servidores locais ativos. Nas configurações do chat, ligações locais e remotas aparecem juntas em Ligações.
Teste com uma pergunta concreta, por exemplo:
- “Quais pastas estão no nosso Nextcloud?”
- “Encontre os últimos e-mails sobre este caso.”
- “Resuma os documentos nesta pasta local.”
Solução de problemas
- Servidor ativo, mas sem ferramentas: reinicie o runtime local e verifique o status do servidor.
- Autenticação ausente: abra o servidor em Preferências → Ferramentas e escolha reconectar.
- Nextcloud não funciona: use a URL base do ambiente e uma senha de app separada.
- Arquivos locais inacessíveis: verifique se a pasta de trabalho ativa ainda existe e, se necessário, selecione-a novamente pelo painel.
- Muitas ferramentas ativas: mantenha a seleção dinâmica de ferramentas ativada e nomeie a fonte desejada na sua pergunta.
Adicionar um servidor stdio manualmente
Prefira um preset aprovado pela organização. Ao instalar manualmente, verifique executável, argumentos, chaves de ambiente, acesso ao sistema de arquivos e capacidades de leitura ou 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 adjacente e links simbólicos que saem de uma pasta aprovada são recusados. 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 pasta principal aprovada não pode ser movida para a lixeira via IA.
