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
| Tarefa | Comportamento do PreviewShip MCP |
|---|---|
| Implantar saída de build de frontend | Envia dist, build, out, public ou outra pasta estática com index.html |
| Publicar um arquivo HTML | Empacota .html como página de entrada do preview |
| Publicar Markdown | Renderiza .md / .markdown por meio de uma página de visualização gerada |
| Publicar PDF | Abre um único .pdf em tela cheia pelo visualizador nativo do navegador |
| Suportar fluxos de trabalho de agentes de IA | Retorna status de implantação e URL do PreviewShip por meio de saída estruturada de ferramentas |
| Manter links de revisão estáveis | Usa 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:
- Implantar pelo Claude Code
- Implantar pelo Claude Code — Español
- Compartilhar artefatos HTML do Claude como URLs ao vivo
- Alternativa ao Netlify Drop para um arquivo HTML ou ZIP
- Enviar um arquivo HTML para um site
- Comparar PreviewShip com Netlify Drop
- Español: desplegar una preview desde Cursor
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
- Visite PreviewShip Console
- Crie uma conta e vá para API Keys
- 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) —PUBLICouPASSWORD, 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 comvisibility: "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
| Entrada | Suportada | Instrução para o agente |
|---|---|---|
| Saída de build React/Vue/Vite/Svelte/Astro | Sim | Execute o build e depois chame deploy_preview em dist/build/out/public |
| Exportação estática Next.js | Sim | Implante a pasta estática exportada |
Arquivo único .html | Sim | Chame deploy_preview com o caminho do arquivo |
Arquivo Markdown .md / .markdown | Sim | Chame deploy_preview com o caminho do arquivo |
Arquivo PDF .pdf | Sim | Chame deploy_preview; a URL retornada abre o visualizador nativo em tela cheia |
Pasta de código-fonte bruto com package.json e src/ | Não | Compile primeiro e implante a saída |
node_modules | Não | Não envie pastas de dependências |
Guias de Publicação
- Enviar HTML, ZIP ou saída de build
- Implantar pelo Claude Code
- Compartilhar artefatos HTML do Claude
- Publicar HTML gerado por IA online
- Markdown para site
- Enviar e compartilhar um PDF
- Hospedagem de preview vs hospedagem de produção
- Alternativa ao Netlify Drop para um arquivo HTML ou ZIP
- Comparar PreviewShip com Netlify Drop
check_deployment
Verifique o status da implantação.
Parâmetros:
deploymentId(obrigatório) — ID da implantação dedeploy_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
| Free | Pro Mensal | Pro 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árias | 5 | 50 | 80 |
| Implantações mensais | 20 | 300 | 500 |
| Hospedagem | Expira após 3 dias | Contínua enquanto assinado | Contínua enquanto assinado |
| Garantia de hospedagem atual | 3 dias | 1 mês, contínuo | 12 meses, contínuo |
| Histórico de versões | 3 versões retidas | 10 versões retidas | 40 versões retidas |
| Acesso por senha do projeto | Não incluído | Incluído | Incluído |
| Alternância de acesso público/senha | Somente público | Incluído | Incluído |
| Marca d'água do PreviewShip | Incluída | Removida | Removida |
Ver preços e elegibilidade verificados · Ler documentação de preços e limites
Licença
MIT