Instâncias locais
Execute uma instância local pelo app desktop, prepare os requisitos e preserve os dados ao iniciar, parar ou recuperar os serviços.
Comece pelo assistente de instalação passo a passo. Este artigo oferece detalhes técnicos e verificações adicionais.
Iniciar instalaçãoExecutar uma instância local pelo aplicativo desktop
Use um clone dedicado à avaliação com Node.js 24, pnpm 10.28.0, Git, Supabase CLI e Docker em execução. Reserve ao menos 4 GB de RAM livre, dois núcleos e 10 GB livres de SSD; recomendamos 8 GB, quatro núcleos e 20 GB. Instale primeiro o aplicativo assinado pela página de downloads. Windows usa Microsoft Store; macOS e Linux têm downloads próprios. Selecione no clone a versão a avaliar antes de instalar dependências.
git clone https://github.com/mangue-dev/minddy.git
cd minddy
git checkout v0.20.0
corepack enable
corepack prepare pnpm@10.28.0 --activate
pnpm install --frozen-lockfile
As novas instalações locais criptografam o conteúdo do espaço de trabalho por padrão. Para registrar uma escolha explícita, execute pnpm bootstrap:supabase -- --minimal --app-url http://localhost:6463 --encryption enabled (ou --encryption disabled) no clone antes de abri-lo no aplicativo; as inicializações seguintes preservam a escolha salva. Consulte a criptografia do espaço de trabalho.
Deixar o aplicativo controlar os serviços
Abra o menu nativo minddy. No Windows e Linux, Alt mostra a barra; no macOS, use a barra global. Abra o diálogo de conexão a servidor, escolha a opção de instância local e selecione a raiz do clone. O aplicativo executa self-host:local --no-open, prepara Supabase mínimo, aplica migrações e Storage, compila quando necessário e aguarda /api/health antes de abrir cadastro. Ele escuta apenas em loopback na porta 6463, lembra a pasta e controla inicialização e encerramento.
Disponibilidade do MCP e acesso à rede
O MCP está incluído no minddy self-hosted e inicia com a aplicação. Funciona imediatamente em /api/mcp, na origem da instância configurada com MINDDY_PUBLIC_APP_URL. A descoberta OAuth e o registro dinâmico de clientes estão incluídos: não é necessário um servidor MCP separado, um aplicativo OAuth dedicado nem um proxy do minddy Cloud. Conecte o cliente MCP ao endpoint da sua instância, entre na conta e conceda acesso pelo consentimento no navegador.
A disponibilidade do serviço não garante que ele seja acessível pela rede. Tanto o cliente MCP quanto o navegador usado para autorização precisam alcançar as URLs MCP e OAuth anunciadas. Se você definir explicitamente OAUTH_ISSUER, essa origem também precisa ser acessível. O cliente deve aceitar a conexão, o fluxo OAuth e o caminho de rede escolhido; alguns clientes exigem HTTPS mesmo em redes privadas.
Este perfil gerenciado pelo aplicativo desktop escuta apenas na interface de loopback. Um cliente MCP compatível no mesmo computador pode usar http://localhost:6463/api/mcp; localhost e 127.0.0.1 identificam o computador que inicia a conexão. Outro computador ou um agente hospedado na nuvem não pode acessar diretamente este perfil. Para acesso por LAN/VPN, use uma instalação de servidor com uma origem configurada acessível, por exemplo http://192.168.1.50, e permita o acesso à porta da aplicação pelo endereço de escuta, firewall e roteamento. Fora dessa rede, o cliente precisa de uma origem HTTPS acessível como https://tickets.example.com, ou de outro caminho de rede aceito. A instalação local não oferece automaticamente acesso pela Internet.
Leia a orientação de acesso à rede do MCP antes de conectar um cliente remoto.
Recuperar após uma falha
Fechar uma janela mantém o aplicativo desktop ativo; use o comando para sair do aplicativo para parar também os serviços locais. Confira Docker, CLI, espaço e outros processos na 6463.
pnpm self-host:local é uma alternativa de diagnóstico no terminal. Pare com Ctrl+C antes de devolver o controle ao aplicativo, que não assume processos alheios. Sair do aplicativo normalmente também para Supabase; --keep-backend muda isso explicitamente.
Nunca use supabase db reset --local para recuperar dados: ele apaga os dados de avaliação. Teste conta nova, projeto, issue e anexo antes de confiar na instância.