Documentação / Instalação

Conectar o app local

Abra o Bee Team no navegador e conecte-o ao serviço Bee Team em execução neste computador.

Por que a conexão local é necessária

O site fornece a interface e se conecta à API local. O binário do Bee Team executa a API e o MCP no seu computador; por padrão, os dados das tarefas ficam armazenados localmente em SQLite. Abrir o site não instala nem inicia esse serviço. A tela de conexão indica que a interface não conseguiu verificá-lo: o serviço pode estar parado, o navegador pode ter bloqueado o acesso ou outra porta pode estar em uso.

Use o navegador no mesmo computador do serviço. O endereço 127.0.0.1 se refere ao dispositivo que abre a página: um celular não alcança o serviço do seu computador por esse endereço.

O binário oficial já serve o painel na mesma porta da API. Se o navegador do assistente bloquear a conexão pelo site, abra o painel local diretamente. Se você mudou APP_PORT, substitua 59865 no endereço. Se configurou BEE_FRONTEND_MODE=disabled, remova essa configuração e reinicie o serviço. Abrir painel local

Conecte passo a passo

Inicie o serviço Bee Team instalado
Se ele já estiver em execução, mantenha esse processo e siga para o próximo passo. Caso contrário, abra um terminal na pasta que contém o binário instalado e execute o comando do seu sistema. Se o Bee Team ainda não estiver instalado, siga primeiro o guia de instalação.
Ler o guia de instalação
PowerShell
```
$env:APP_PORT = '59865'
.\beeteam.exe
```
Terminal · macOS / Linux
```
APP_PORT=59865 ./beeteam
```
Mantenha o terminal aberto enquanto usa o Bee Team, a menos que sua instalação já o execute como serviço em segundo plano. Esses comandos usam a porta padrão sem redefinir seu banco de dados.
Confira se a API local responde
Em um segundo terminal, execute estas consultas de saúde e identificação do serviço, sem alterar seus dados:
PowerShell
```
Invoke-RestMethod http://127.0.0.1:59865/health
Invoke-RestMethod http://127.0.0.1:59865/api/v1/info
```
Terminal · macOS / Linux
```
curl -fsS http://127.0.0.1:59865/health
curl -fsS http://127.0.0.1:59865/api/v1/info
```
As duas consultas devem retornar JSON; info inclui apiVersion. Isso confirma que o serviço responde nessa porta. O navegador ainda precisa de permissão, e as versões da interface e do serviço devem ser iguais.
Permita que o navegador acesse o serviço local
Abra https://getbee.team/app/ e permita a solicitação de conexão ao dispositivo ou à rede local, se o navegador a exibir. Isso permite que o site alcance o serviço Bee Team no seu computador. O nome e a disponibilidade da permissão dependem da versão do navegador.
Verifique a conexão novamente
Volte ao app e selecione “Verificar conexão novamente”. Quando o serviço responder e sua versão for igual à da interface, o app abrirá automaticamente. Se ele solicitar uma atualização, siga essa orientação de versão separadamente.
Abrir painel local

Três problemas comuns de conexão

1. O app local não está em execução

Sintoma: health e info não conseguem conectar, ou o terminal que iniciou o Bee Team foi fechado.

Inicie o binário instalado seguindo o passo 1, mantenha-o em execução e repita as consultas no terminal e no navegador. Se a inicialização mostrar um erro, leia-o antes de iniciar outro processo. Uma falha de conexão não exige reinstalar nem apagar seus dados.

2. O navegador bloqueou o acesso local

Sintoma: as consultas no terminal funcionam, mas o site não consegue verificar o serviço, ou você negou a solicitação de acesso anteriormente.

Com getbee.team aberto, acesse os controles do site ao lado da barra de endereço e abra as permissões/configurações do site.
Procure acesso à rede local ou apps neste dispositivo. Permita para getbee.team ou redefina a permissão negada para que o navegador possa perguntar novamente.
Recarregue o app, aceite a solicitação se ela aparecer e selecione “Verificar conexão novamente”.

Chrome e Edge podem usar nomes diferentes, e navegadores gerenciados podem bloquear essa permissão. Se a opção estiver indisponível ou gerenciada, consulte a ajuda do navegador ou seu administrador. Não desative a segurança do navegador nem o firewall.

Ajuda de permissões de sites no Chrome · Ajuda de acesso à rede local no Edge

3. O serviço está usando outra porta

Sintoma: o log de inicialização mostra uma porta diferente de 59865, ou health responde em outra porta enquanto o endereço padrão falha.

O app hospedado se conecta a http://127.0.0.1:59865/api/v1. Confira o endereço de inicialização e APP_PORT. Para usar o app hospedado, encerre com segurança seu processo Bee Team atual e inicie a mesma instalação com APP_PORT=59865, como mostrado acima. Não inicie uma segunda cópia com os mesmos dados. Se outro programa ocupar a porta, resolva o conflito antes de tentar novamente.

O app hospedado não possui seletor de porta em tempo de execução. Outro endereço de API exige um build próprio do frontend configurado com VITE_API_BASE_URL. Mudar somente APP_PORT não altera o endereço usado pelo site público.

Referência de variáveis