PreviewSend

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

Implementa un sitio estático desde tu agente de codificación.

Cuando está habilitado para tu entorno, el servidor MCP de PreviewSend ofrece a Claude Code, Codex, Cursor y clientes compatibles una superficie de implementación pequeña y segura. Tu cliente sube el ZIP directamente al almacenamiento de objetos, por lo que los bytes del sitio nunca pasan por la solicitud MCP.

Configuración

Conéctate una vez, implementa repetidamente.

Crea una clave de API con capacidad de implementación en la configuración del espacio de trabajo, luego agrega el endpoint y el token de portador a tu cliente MCP. El token completo se muestra solo una vez.

Gestionar claves de API

01

Crea una clave

Usa una clave de implementación de usuario para cambios de contraseña, o una clave de servicio del espacio de trabajo para automatización de implementación.

02

Guárdala de forma segura

Coloca el token pvs_ en el almacén de secretos de tu cliente. Nunca lo confirmes ni lo pegues en un archivo de proyecto.

03

Envía un ZIP

Llama a start_deploy, haz PUT del archivo con los encabezados devueltos, luego llama a finalize_deploy.

Endpoint

https://previewsend.com/api/mcp

El endpoint usa HTTP Streamable y soporta el protocolo MCP estable negociado por el cliente. Las solicitudes deben incluir el token de portador y un mensaje JSON-RPC.

Flujo de implementación

1. 1. Llama a create_project cuando se necesite un nuevo proyecto.
2. 2. Llama a start_deploy con el tamaño del ZIP y el digest SHA-256.
3. 3. Sube directamente a la URL presignada devuelta usando sus encabezados exactos.
4. 4. Llama a finalize_deploy para verificar, extraer y publicar la versión.

Claude Code

Conéctate desde la terminal.

Crea una clave con capacidad de implementación, luego agrega PreviewSend con el comando MCP integrado de Claude Code. Pega la clave cuando read espere entrada; no se escribe en el historial de tu shell.

Claude Code almacena el encabezado Authorization en su configuración de usuario. Usa una clave con alcance y revócala en PreviewSend siempre que esa máquina deba perder acceso.

1. Agrega el 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

El éxito se ve como previewsend ... Connected. Un 401 significa que la clave falta, es inválida, expiró o fue revocada. Un 503 significa que MCP aún no está habilitado para ese entorno de PreviewSend.

2. Verifica el acceso de solo lectura

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. Ejecuta una implementación 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.

Una implementación completa devuelve una URL de vista previa estable. Conserva el ID del proyecto para reutilizar la misma página de PreviewSend en versiones posteriores.

Referencia de herramientas

Ocho herramientas enfocadas.

La referencia a continuación se genera desde el mismo catálogo utilizado por el registro MCP, por lo que los nombres y descripciones se mantienen alineados con el servidor en vivo.

get_account

lectura · clave de usuario / espacio de trabajo

Lee la identidad del espacio de trabajo, los límites del plan, el recuento de proyectos en vivo y la URL de facturación dentro de la aplicación. Los límites que son ilimitados en el plan se informan como la cadena "unlimited".

Argumentos: Sin argumentos.

list_projects

lectura · clave de usuario / espacio de trabajo

Lista los proyectos visibles para esta clave, incluyendo URLs de vista previa en vivo y versiones activas.

Argumentos: Sin argumentos.

get_project

lectura · clave de usuario / espacio de trabajo

Lee un proyecto visible y sus últimas diez versiones, con un cursor de versión opcional.

Argumentos: Exactamente uno de projectId o slug, más versionsCursor opcional.

get_billing_url

lectura · clave de usuario / espacio de trabajo

Devuelve la URL de facturación determinista dentro de la aplicación para que un propietario humano revise las actualizaciones.

Argumentos: Sin argumentos.

create_project

implementación · clave de usuario / espacio de trabajo

Crea un proyecto activo bajo la cuota de proyectos del espacio de trabajo. Requiere una clave de idempotencia.

Argumentos: name, slug opcional e idempotencyKey.

start_deploy

implementación · clave de usuario / espacio de trabajo

Inicia una implementación ZIP presignada. Sube el archivo devuelto a R2 con los encabezados exactos, luego finalízalo.

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

finalize_deploy

implementación · clave de usuario / espacio de trabajo

Verifica, extrae de forma segura, publica y activa una implementación ZIP completada.

Argumentos: projectId, versionId y el sha256 en minúsculas declarado al inicio.

set_password

implementación · clave de usuario

Establece o borra una contraseña de vista previa del proyecto. Requiere una clave de implementación a nivel de usuario, nunca una clave de servicio del espacio de trabajo.

Argumentos: projectId y password, o null para borrar la contraseña.

Subidas solo presignadas

Los datos ZIP van del cliente a R2. El servidor MCP recibe metadatos, verifica el objeto, extrae entradas seguras y publica el resultado.

Implementaciones limitadas

Los archivos usan el límite de producto de 100 MB: exactamente 100 MiB (104,857,600 bytes) comprimidos, con extracción limitada y llamadas de inicio y finalización idempotentes.

Acceso con alcance

Las claves están vinculadas al espacio de trabajo. Las listas de permitidos de proyectos, verificaciones de capacidad, caducidad, revocación y suspensión del espacio de trabajo se aplican en cada solicitud.