PreviewSend

npx add-mcp 'https://previewsend.com/api/mcp'

Implante um site estático a partir do seu agente de codificação.

Quando habilitado para o seu ambiente, o servidor MCP PreviewSend oferece ao Claude Code, Codex, Cursor e clientes compatíveis uma superfície de implantação pequena e segura. Seu cliente envia o ZIP diretamente para o armazenamento de objetos, então os bytes do site nunca passam pela solicitação MCP.

Configuração

Conecte uma vez, implante repetidamente.

Crie uma chave de API com capacidade de implantação nas configurações do workspace e adicione o endpoint e o token bearer ao seu cliente MCP. O token completo é exibido apenas uma vez.

Gerenciar chaves de API

01

Crie uma chave

Use uma chave de implantação de usuário para alterações de senha, ou uma chave de serviço do workspace para automação de implantação.

02

Armazene-a com segurança

Coloque o token pvs_ no armazenamento de segredos do seu cliente. Nunca o envie para um repositório ou cole-o em um arquivo de projeto.

03

Envie um ZIP

Chame start_deploy, faça o PUT do arquivo com os cabeçalhos retornados e, em seguida, chame finalize_deploy.

Endpoint

https://previewsend.com/api/mcp

O endpoint usa HTTP Streamable e suporta o protocolo MCP estável negociado pelo cliente. As solicitações devem incluir o token bearer e uma mensagem JSON-RPC.

Fluxo de implantação

1. 1. Chame create_project quando um novo projeto for necessário.
2. 2. Chame start_deploy com o tamanho do ZIP e o digest SHA-256.
3. 3. Envie diretamente para a URL pré-assinada retornada usando seus cabeçalhos exatos.
4. 4. Chame finalize_deploy para verificar, extrair e publicar a versão.

Claude Code

Conecte-se pelo terminal.

Crie uma chave com capacidade de implantação e adicione PreviewSend com o comando MCP integrado do Claude Code. Cole a chave quando read aguardar entrada; ela não é gravada no histórico do seu shell.

O Claude Code armazena o cabeçalho Authorization na sua configuração de usuário. Use uma chave com escopo e revogue-a no PreviewSend sempre que essa máquina perder o acesso.

1. Adicione o servidor

read -s PREVIEWSEND_API_KEY
claude mcp add --scope user --transport http previewsend https://previewsend.com/api/mcp \
  --header "Authorization: Bearer $PREVIEWSEND_API_KEY"
unset PREVIEWSEND_API_KEY
claude mcp list

O sucesso aparece como previewsend ... Connected. Um 401 significa que a chave está ausente, inválida, expirada ou revogada. Um 503 significa que o MCP ainda não está habilitado para esse ambiente PreviewSend.

2. Verifique o acesso somente leitura

Use the PreviewSend MCP server to call get_account and list_projects.
Do not create or deploy anything. Report the workspace and project count.

3. Execute uma implantação real

Build this static site and deploy the output through PreviewSend MCP.
Create a project if needed, ZIP the output directory, call start_deploy,
upload with every returned header, call finalize_deploy, then fetch the
returned preview URL and confirm it responds with HTTP 200.

Uma implantação completa retorna uma URL de pré-visualização estável. Mantenha o ID do projeto para reutilizar a mesma página PreviewSend em versões futuras.

Referência de ferramentas

Oito ferramentas focadas.

A referência abaixo é gerada a partir do mesmo catálogo usado pelo registro MCP, então nomes e descrições permanecem alinhados com o servidor ativo.

get_account

leitura · chave de usuário / workspace

Leia a identidade do workspace, limites do plano, contagem de projetos ativos e a URL de cobrança no aplicativo. Limites ilimitados no plano são relatados como a string "unlimited".

Argumentos: Nenhum argumento.

list_projects

leitura · chave de usuário / workspace

Liste os projetos visíveis para esta chave, incluindo URLs de pré-visualização ativas e versões ativas.

Argumentos: Nenhum argumento.

get_project

leitura · chave de usuário / workspace

Leia um projeto visível e suas últimas dez versões, com um cursor de versão opcional.

Argumentos: Exatamente um de projectId ou slug, além de versionsCursor opcional.

get_billing_url

leitura · chave de usuário / workspace

Retorne a URL de cobrança determinística no aplicativo para que um proprietário humano revise atualizações.

Argumentos: Nenhum argumento.

create_project

implantação · chave de usuário / workspace

Crie um projeto ativo sob a cota de projetos do workspace. Requer uma chave de idempotência.

Argumentos: name, slug opcional e idempotencyKey.

start_deploy

implantação · chave de usuário / workspace

Inicie uma implantação ZIP pré-assinada. Envie o arquivo retornado para R2 com os cabeçalhos exatos e finalize-o.

Argumentos: projectId, sizeBytes, sha256 em minúsculas, message opcional e idempotencyKey.

finalize_deploy

implantação · chave de usuário / workspace

Verifique, extraia com segurança, publique e ative uma implantação ZIP concluída.

Argumentos: projectId, versionId e o sha256 em minúsculas declarado no início.

set_password

implantação · chave de usuário

Defina ou limpe uma senha de pré-visualização do projeto. Requer uma chave de implantação em nível de usuário, nunca uma chave de serviço do workspace.

Argumentos: projectId e password, ou null para limpar a senha.

Uploads somente pré-assinados

Os dados do ZIP vão do cliente para R2. O servidor MCP recebe metadados, verifica o objeto, extrai entradas seguras e publica o resultado.

Implantações limitadas

Os arquivos usam o limite de produto de 100 MB: exatamente 100 MiB (104.857.600 bytes) compactados, com extração limitada e chamadas de início e finalização idempotentes.

Acesso com escopo

As chaves são vinculadas ao workspace. Listas de permissão de projetos, verificações de capacidade, expiração, revogação e suspensão do workspace são aplicadas em cada solicitação.