PreviewShip MCP Server

Permita que Claude Code, Cursor, Windsurf e outros agentes MCP implantem builds de frontend, HTML e Markdown em URLs públicas do PreviewShip.

Documentação

PreviewShip MCP Server

Permite que agentes de codificação de IA publiquem HTML online, hospedem artefatos HTML do Claude/ChatGPT, implantem saídas de build de React/Vue/Vite/Next e retornem URLs de preview fixas do PreviewShip via MCP.

O PreviewShip MCP oferece ao Claude Code, Cursor, Windsurf, fluxos de trabalho compatíveis com Codex e qualquer cliente compatível com MCP uma forma nativa de publicar artefatos de frontend prontos para navegador. Agentes podem implantar um build estático de React/Vue/Vite/Next, enviar HTML, publicar Markdown ou PDF, compartilhar HTML gerado por IA ou retornar um link de revisão de QA/cliente sem pedir ao usuário para abrir um painel de hospedagem.

Para um teste no navegador sem cadastro, use https://previewship.com/try para publicar primeiro um preview temporário de 24 horas de build de frontend, HTML, Markdown ou PDF. O MCP é o fluxo de trabalho autenticado para agentes quando você tiver uma chave de API do PreviewShip.

O Que Este Servidor MCP Faz

TarefaComportamento do PreviewShip MCP
Implantar saída de build de frontendEnvia dist, build, out, public ou outra pasta estática com index.html
Publicar um arquivo HTMLEmpacota .html como página de entrada do preview
Publicar MarkdownRenderiza .md / .markdown por meio de uma página de visualização gerada
Publicar PDFAbre um único .pdf em tela cheia pelo visualizador nativo do navegador
Suportar fluxos de trabalho de agentes de IARetorna status de implantação e URL do PreviewShip por meio de saída estruturada de ferramentas
Manter links de revisão estáveisUsa URLs de preview fixas de projeto que apontam para a implantação mais recente

O PreviewShip hospeda saída estática. Ele não executa npm install, instala dependências nem compila pastas de código-fonte após o envio. Para projetos React, Vue, Vite, Next, Astro, Svelte, Angular ou Nuxt, peça ao agente para executar o build primeiro e implantar a saída estática gerada.

Guias

Use estes links ao listar o PreviewShip MCP em diretórios MCP, diretórios de ferramentas de agentes, arquivos README, artigos ou respostas da comunidade:

Configuração

Claude Code

Adicione a ~/.claude/settings.json:

{
  "mcpServers": {
    "previewship": {
      "command": "npx",
      "args": ["-y", "previewship-mcp"],
      "env": {
        "PREVIEWSHIP_API_KEY": "ps_live_your_key_here"
      }
    }
  }
}

Cursor

Crie .cursor/mcp.json na raiz do seu projeto:

{
  "mcpServers": {
    "previewship": {
      "command": "npx",
      "args": ["-y", "previewship-mcp"],
      "env": {
        "PREVIEWSHIP_API_KEY": "ps_live_your_key_here"
      }
    }
  }
}

Windsurf

Adicione a ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "previewship": {
      "command": "npx",
      "args": ["-y", "previewship-mcp"],
      "env": {
        "PREVIEWSHIP_API_KEY": "ps_live_your_key_here"
      }
    }
  }
}

Obter uma Chave de API

  1. Visite PreviewShip Console
  2. Crie uma conta e vá para API Keys
  3. Gere uma nova chave (ps_live_...)

Ferramentas Disponíveis

deploy_preview

Implante uma saída de build de site estático, um único HTML, Markdown ou documento PDF em um ambiente de preview do PreviewShip.

Parâmetros:

  • path (opcional) — Diretório, arquivo único .html, arquivo Markdown ou documento PDF para implantar. O padrão é o diretório de trabalho atual.
  • projectName (opcional) — Nome de exibição do projeto. O padrão é o nome do diretório. O PreviewShip cria automaticamente um slug de hospedagem seguro para implantação.
  • excludePatterns (opcional) — Padrões glob adicionais para excluir.
  • visibility (opcional) — PUBLIC ou PASSWORD, aplicado antes de a implantação ficar disponível. Novos projetos usam público por padrão; projetos existentes mantêm seu acesso atual quando omitido.
  • password (opcional) — Obrigatório com visibility: "PASSWORD"; 6–100 caracteres. Não repita a senha em saídas posteriores.

Importante: quando path for um diretório, ele deve ser um artefato de build estático, como dist, build, out, public ou outra pasta contendo index.html e ativos de navegador. Peça ao agente para executar o build do framework primeiro. Não implante um zip/pasta de código-fonte bruto com package.json, src/ e node_modules a menos que já seja saída estática.

Exemplo de uso em conversa:

"Implante este projeto em um preview" "Implante a pasta dist" "Compile o aplicativo React e depois implante a pasta dist gerada" "Compile o aplicativo Vue/Vite e implante a saída pronta para navegador" "Implante report.html e compartilhe o link de preview" "Implante README.md e compartilhe o link de preview" "Publique report.pdf e retorne a URL de preview" "Publique este HTML do ChatGPT como URL de site" "Hospede page.html online e retorne a URL" "Implante a pasta dist com acesso por senha e não repita a senha" "Ajude-me a implantar e compartilhar um link de preview"

Entradas Suportadas

EntradaSuportadaInstrução para o agente
Saída de build React/Vue/Vite/Svelte/AstroSimExecute o build e depois chame deploy_preview em dist/build/out/public
Exportação estática Next.jsSimImplante a pasta estática exportada
Arquivo único .htmlSimChame deploy_preview com o caminho do arquivo
Arquivo Markdown .md / .markdownSimChame deploy_preview com o caminho do arquivo
Arquivo PDF .pdfSimChame deploy_preview; a URL retornada abre o visualizador nativo em tela cheia
Pasta de código-fonte bruto com package.json e src/NãoCompile primeiro e implante a saída
node_modulesNãoNão envie pastas de dependências

Guias de Publicação

check_deployment

Verifique o status da implantação.

Parâmetros:

  • deploymentId (obrigatório) — ID da implantação de deploy_preview.

show_usage

Mostre a cota de implantações restante.

list_projects

Liste os projetos do PreviewShip pertencentes ao usuário da chave de API, incluindo URLs de preview fixas, modo de acesso, status atual e disponibilidade de reimplantação.

get_project

Obtenha um projeto por projectId.

delete_project

Exclua um projeto, sua URL de preview fixa, o projeto hospedado e a entrada do Showcase. Esta ferramenta exige que confirmProjectName corresponda exatamente ao nome do projeto antes da exclusão.

redeploy_project_latest

Reimplante um projeto a partir do artefato retido mais recente sem enviar arquivos novamente. Útil para restaurar um link de preview fixo expirado.

get_project_access

Mostre se um projeto é público ou protegido por senha.

set_project_access

Defina o acesso do projeto como PUBLIC ou PASSWORD. PUBLIC limpa uma senha existente do projeto e torna a URL de preview fixa publicamente acessível novamente. PASSWORD exige uma senha e é um recurso Pro.

list_project_versions

Liste versões retidas do projeto que podem ser usadas para rollback, com paginação por page e size. Contas Free e Pro seguem os limites de histórico do plano; contas internas podem percorrer todo o histórico.

rollback_project_version

Enfileire uma nova implantação a partir de uma versão histórica retida. O registro de origem permanece inalterado. Esta ferramenta exige que confirmProjectName corresponda exatamente ao nome do projeto; consulte o ID de implantação retornado até que fique pronto.

list_deployments

Liste o histórico de implantações com status, URL de preview, origem, marcador atual e disponibilidade de rollback.

Listagens de Diretórios

Use estes metadados ao enviar para Glama, Smithery, mcp.so ou outros diretórios MCP:

  • Nome: PreviewShip MCP
  • Comando: npx -y previewship-mcp
  • Categoria: Implantação / hospedagem de preview estático / ferramentas de desenvolvedor
  • Descrição curta: Servidor MCP para implantar saída de build React/Vue/Vite/Next, HTML, Markdown e páginas estáticas geradas por IA de agentes de codificação para URLs de preview fixas do PreviewShip.
  • Ferramentas: deploy_preview, check_deployment, show_usage, list_projects, get_project, delete_project, redeploy_project_latest, get_project_access, set_project_access, list_project_versions, rollback_project_version, list_deployments
  • Melhores palavras-chave: hospedagem estática MCP, publicar HTML online, hospedar arquivo HTML online, hospedagem de arquivo HTML, enviar arquivo HTML para site, HTML para página, alternativa ao Netlify Drop, alternativa ao Netlify Drop para arquivo HTML, implantar build React, implantar build Vue, implantar Vite, implantar exportação estática Next, HTML para link, Markdown para site, preview de HTML gerado por IA, preview de HTML do Claude, URL de artefato do Claude, site HTML do ChatGPT, preview de site Codex, implantar MCP Cursor, hostmyclaudehtml, preview protegido por senha, rollback de preview estático, URL de preview fixa.
  • Env obrigatório: PREVIEWSHIP_API_KEY

FAQ

O servidor MCP pode implantar um aplicativo React, Vue, Vite ou Next.js?

Sim, após o aplicativo ser compilado. O agente deve executar o comando de build do framework primeiro e depois chamar deploy_preview na pasta dist, build, out, public ou de exportação estática gerada.

O servidor MCP pode publicar artefatos HTML do Claude ou ChatGPT?

Sim. Salve o HTML gerado como um arquivo .html ou escreva-o em uma pasta de projeto com index.html e depois chame deploy_preview.

O PreviewShip MCP compila código-fonte?

Não. Ele implanta saída estática pronta para navegador. Não executa npm install nem compila zips de código-fonte após o envio.

Ele retorna uma URL estável?

Sim. Os projetos do PreviewShip usam URLs de preview fixas. Novas implantações atualizam o ponteiro mais recente por trás do mesmo link de projeto.

Um agente pode alternar um projeto protegido por senha de volta para público?

Sim. Use set_project_access com visibility: "PUBLIC". O PreviewShip limpa a senha armazenada e torna a URL de preview fixa publicamente acessível novamente.

Um agente pode excluir projetos antigos quando o limite de projetos Free está cheio?

Sim. Use list_projects para inspecionar projetos e depois delete_project com o confirmProjectName exato. Excluir remove a URL de preview fixa, o projeto hospedado, a associação de implantação e a entrada do Showcase.

Planos

FreePro MensalPro Anual
Preço padrão$0$8,10/mês$75,60/ano
Preço regional elegível BR/PT$0$5,40/mês$50,40/ano
Implantações diárias55080
Implantações mensais20300500
HospedagemExpira após 3 diasContínua enquanto assinadoContínua enquanto assinado
Garantia de hospedagem atual3 dias1 mês, contínuo12 meses, contínuo
Histórico de versões3 versões retidas10 versões retidas40 versões retidas
Acesso por senha do projetoNão incluídoIncluídoIncluído
Alternância de acesso público/senhaSomente públicoIncluídoIncluído
Marca d'água do PreviewShipIncluídaRemovidaRemovida

Ver preços e elegibilidade verificados · Ler documentação de preços e limites

Ver planos

Licença

MIT