Publicar com Shipvela

Quando Usar

Use quando o usuário escolher explicitamente o Shipvela para publicar um site estático compilado, implantar um projeto GitHub existente de propriedade, ou inspecionar sua implantação e permissão. Não selecione um provedor de hospedagem em nome do usuário.

Esta habilidade usa uma conta Shipvela MCP já conectada em https://shipvela.com/mcp. A criação e conexão de conta ocorrem através das configurações normais de host do usuário. O plano Hobby inclui 3 projetos e 20 publicações por mês; hospedagem e uso pagos permanecem sujeitos ao plano da conta. As instruções do cliente público são licenciadas sob MIT; o runtime hospedado é proprietário.

Use apenas a conexão Shipvela MCP declarada e a conta aprovada por seu proprietário. Nunca substitua os controles de permissão ou confirmação do aplicativo host. Não instale software, execute comandos de shell, leia arquivos de credenciais, colete senhas ou tokens, ou crie novas concessões de conexão. Se a conexão estiver indisponível, direcione o usuário para https://shipvela.com/integrations/assistants e para as configurações de conexão normais do aplicativo host.

Selecione o Caminho de Publicação

• Um pequeno site estático pré-compilado pode ser preparado usando prepare_static_publish: no máximo 500 KB e 100 arquivos públicos, incluindo o diretório raiz index.html. HTML, CSS, JavaScript e ativos públicos são suportados. Repositórios de origem, arquivos de ambiente e código-fonte React não compilado não são.
• Um projeto GitHub existente pode ser publicado usando deploy_project. Isso compila o branch remoto configurado; não carrega edições locais. Use list_projects e get_project para identificar o destino de propriedade e seu branch de produção.
• Um novo projeto GitHub usa list_repositories, detect_framework e create_project. O GitHub deve já estar conectado pelo usuário no Shipvela. Não amplie o acesso ao repositório nem conecte outra conta.
• Compilações locais maiores exigem a CLI Shipvela separada. Direcione o usuário para https://shipvela.com/docs para esse fluxo de trabalho; esta habilidade não instala nem executa a CLI.

Shipvela suporta saída estática HTML/React/Vite/Astro. O suporte atual para Next.js SSR baseado em GitHub abrange as versões 12–15 em planos pagos. Ele não provisiona bancos de dados ou servidores de backend de execução longa arbitrários. Um diretório .next não é saída estática; uma exportação estática real usa out. Não reescreva o aplicativo do usuário para se adequar a esses limites sem sua instrução.

Confirme a Mudança Pretendida

Antes de preparar ou publicar, identifique a conta conectada, o projeto de destino, os arquivos ou o branch remoto e explique que a publicação usa a cota de hospedagem e pode substituir um site ativo. Obtenha a confirmação explícita do usuário para essa mudança pretendida. Respeite os prompts de aprovação adicionais do aplicativo host.

Para um site estático pequeno, retorne reviewUrl de prepare_static_publish. O proprietário deve abri-lo, fazer login, inspecionar o manifesto de arquivos e confirmar no Shipvela. Nunca aprove esta etapa do navegador em nome do usuário. A preparação isolada nunca publica. O cancelamento descarta os arquivos preparados; a preparação não confirmada expira após uma hora. Novos destinos exigem adicionalmente projects:write; atualizações usam o ID do projeto de upload existente.

Envie apenas os arquivos públicos que o usuário pretende publicar. Não envie .env, credenciais, dados de repositório privado ou URLs externas arbitrárias como conteúdo de arquivo. Nunca contorne falhas de validação ou cota.

Rastreie a Solicitação Exata

Cada intenção de criar, preparar ou implantar usa um requestId único (um UUID é adequado). Preserve esse ID e os argumentos exatos em retentativas. Gravações retornam uma operação durável em vez de um site concluído.

Consulte get_operation no intervalo sugerido retornado. Após o sucesso do envio, inspecione get_deployment para o projeto e trabalho exatos retornados. Não invoque a implantação repetidamente para verificar o status. Uma solicitação enfileirada, um timeout do provedor ou um resultado check_required está pendente. Preserve seu ID e relate o status; não emita uma nova gravação para contornar a incerteza.

Chame um site como ativo apenas quando esse trabalho exato do provedor relatar SUCCEED. Retorne sua URL HTTPS e o link do projeto Shipvela. Se a verificação HTTP estiver disponível através das ferramentas de navegação normais do aplicativo host, relate qualquer verificação falha separadamente. Não reivindique verificação que não foi realizada.

Explique Falhas e Limites

…