Deployado MCP Server

Conecta tu asistente de IA para programar con Deployado. Despliega, gestiona apps, ve logs y más — directamente desde Claude Code, Cursor o cualquier cliente compatible con MCP.

Descripción General

El servidor MCP (Model Context Protocol) de Deployado permite que los asistentes de IA interactúen con tu infraestructura de Deployado. En lugar de cambiar entre tu editor y el dashboard, tu asistente de IA puede desplegar apps, revisar logs, gestionar bases de datos y más — todo dentro de tu flujo de trabajo de programación.

Está publicado en npm como deployado-mcp y corre localmente por stdio: tu cliente MCP lo inicia con npx, así que no necesitas instalar nada de forma global.

58 herramientas

Apps, despliegues, builds, variables de entorno, bases de datos, dominios, cron jobs, servicios, backups y diagnóstico.

Seguro por defecto

Las herramientas de solo lectura están anotadas como read-only y las destructivas (delete, remove, restore, …) como destructive, para que tu cliente MCP pueda pedirte confirmación antes.

Desde cualquier proyecto

Configura una vez, úsalo desde cualquier proyecto. Funciona globalmente en todo tu espacio de trabajo.

Requisitos Previos

  • Node.js 22+ — Requerido para ejecutar el servidor MCP
  • Cuenta de Deployado — Regístrate si no tienes uno
  • Token de API — Genera uno desde https://deployado.com/settings/api-tokens
  • Cliente compatible con MCP — Claude Code, Claude Desktop, Cursor, Windsurf, o cualquier otro cliente MCP

Nota: El servidor MCP se autentica con un token de API que se pasa en DEPLOYADO_API_TOKEN. Es independiente del CLI: iniciar sesión con deployado auth login no configura el servidor MCP.

Instalación

Claude Code

Registra el servidor con un solo comando:

Terminal 
$ claude mcp add deployado --env DEPLOYADO_API_TOKEN=<your-token> -- npx -y deployado-mcp

Agrega --scope user (justo después de claude mcp add) para que esté disponible en todos tus proyectos y no solo en el actual. Ejecuta claude mcp list para confirmar que está conectado.

Claude Desktop / Cursor / Windsurf / otros clientes

Agrega esto al archivo de configuración MCP de tu cliente (por ejemplo claude_desktop_config.json en Claude Desktop o ~/.cursor/mcp.json en Cursor) y reinicia el cliente:

mcpServers (JSON) 
{
  "mcpServers": {
    "deployado": {
      "command": "npx",
      "args": ["-y", "deployado-mcp"],
      "env": {
        "DEPLOYADO_API_TOKEN": "your-token-here"
      }
    }
  }
}

Variables de entorno

Variable Requerido Descripción
DEPLOYADO_API_TOKEN Sí Token de API creado en https://deployado.com/settings/api-tokens
DEPLOYADO_BASE_URL No URL base de la API (predeterminado: https://deployado.com)

Opcional: instalación global

Si prefieres no usar npx, instala el paquete de forma global y usa deployado-mcp como comando (sin args) en la configuración de tu cliente:

Terminal 
$ npm install -g deployado-mcp

Herramientas Disponibles

El servidor MCP expone 58 herramientas organizadas por tipo de recurso. Tu asistente de IA puede usar cualquiera de ellas para interactuar con tu infraestructura en Deployado.

Cuenta

Verificar qué cuenta y token está usando el servidor

deployado_whoami Mostrar la cuenta, el usuario y la info del token de API actuales

Aplicaciones

Gestionar tus aplicaciones

deployado_list_apps Listar todas las apps, opcionalmente filtradas por proyecto
deployado_get_app Obtener información detallada de una app
deployado_create_app Crear una nueva app en un proyecto
deployado_update_app Actualizar configuración de la app
deployado_delete_app Eliminar permanentemente una app con sus despliegues, releases y variables de entorno

Releases y builds

Inspeccionar builds y descubrir por qué falló uno

deployado_list_releases Listar los releases con su historial de versiones y estado de build
deployado_get_release Obtener el estado del build de un release, la info del commit y los detalles del error
deployado_get_build_logs Obtener los logs de build de un release
deployado_release_logs Obtener la transcripción del docker build de un release, en curso o terminado

Despliegues

Desplegar, hacer rollback y monitorear despliegues

deployado_deploy Lanzar un nuevo despliegue; regresa un release_id mientras corre el build
deployado_rollback Regresar una app a un release anterior
deployado_list_deployments Listar despliegues recientes de una app
deployado_get_deployment Obtener detalles del despliegue con fases y errores
deployado_current_deployment Obtener el despliegue actualmente activo

Variables de entorno

Gestionar configuración de la app

deployado_list_env Listar las variables de entorno de una app (los secretos pueden aparecer enmascarados)
deployado_set_env Definir o actualizar variables de entorno (se combinan con las existentes)
deployado_delete_env Eliminar una variable de entorno

Servidores

Consultar tu infraestructura

deployado_list_servers Listar servidores con estado y métricas de recursos
deployado_get_server Obtener los detalles del servidor: versión del agente, SO, arquitectura y versión de Docker

Proyectos

Organizar tus apps en proyectos

deployado_list_projects Listar todos los proyectos
deployado_get_project Obtener detalles del proyecto
deployado_create_project Crear un proyecto nuevo
deployado_update_project Actualizar el nombre, la descripción o la configuración de un proyecto
deployado_delete_project Eliminar un proyecto y todas sus apps

Bases de Datos

Gestionar bases de datos PostgreSQL

deployado_list_databases Listar las bases de datos PostgreSQL administradas
deployado_get_database Obtener detalles de la base de datos e info de conexión
deployado_create_database Crear una nueva base de datos PostgreSQL
deployado_delete_database Eliminar permanentemente una base de datos y todos sus datos
deployado_connect_database Conectar una app a una base de datos (inyecta la URL de conexión como variable de entorno)
deployado_disconnect_database Desconectar una app de una base de datos

Exec

Ejecutar comandos dentro de tus contenedores

deployado_exec Ejecutar un comando dentro del contenedor en ejecución de una app (timeout de 60 s)

Blueprints

Desplegar stacks completos desde YAML

deployado_validate_blueprint Validar un blueprint YAML sin desplegar
deployado_deploy_blueprint Desplegar un stack completo desde YAML en línea o un repositorio de GitHub

Dominios

Dominios personalizados y verificación de DNS

deployado_list_domains Listar los dominios de una app, incluido su subdominio
deployado_add_domain Agregar un dominio personalizado a una app
deployado_remove_domain Quitar un dominio personalizado de una app
deployado_set_primary_domain Definir el dominio principal de una app
deployado_verify_domains Verificar el DNS de todos los dominios de una app

Cron jobs

Tareas programadas por app

deployado_list_cron_jobs Listar los cron jobs de una app
deployado_create_cron_job Crear un cron job
deployado_update_cron_job Actualizar un cron job
deployado_delete_cron_job Eliminar un cron job
deployado_run_cron_job Ejecutar un cron job de inmediato

Servicios

Servicios del marketplace (cachés, monitoreo y más)

deployado_list_service_templates Explorar las plantillas de servicios del marketplace
deployado_list_services Listar los servicios instalados
deployado_get_service Obtener los detalles de un servicio instalado
deployado_install_service Instalar un servicio desde una plantilla
deployado_start_service Iniciar un servicio detenido
deployado_stop_service Detener un servicio en ejecución
deployado_restart_service Reiniciar un servicio

Respaldos

Backups de bases de datos guardados en S3

deployado_list_backup_targets Listar los destinos de backups
deployado_create_backup_target Crear un destino de backups
deployado_get_backup_target Obtener un destino de backups y sus ejecuciones recientes
deployado_run_backup Lanzar un backup ahora
deployado_restore_backup Restaurar una base de datos desde una ejecución de backup (sobrescribe la base de datos)

Diagnóstico

Descubrir qué le pasa a una app

deployado_doctor Correr el checklist de diagnóstico: despliegue, build, servidor, instancias, prueba HTTP, variables de entorno y ubicación
deployado_get_logs Obtener los logs recientes de ejecución del contenedor de una app (no los de build)

Prompts y recursos

Prompt deployado_status Resumen completo de tu infraestructura: apps, servidores y bases de datos
Recurso deployado://apps Resumen en JSON de todas las apps con sus IDs, nombres y proyectos
Recurso deployado://servers Resumen en JSON de todos los servidores con su estado y métricas de recursos

Ejemplos de Uso

Una vez configurado, puedes pedirle a tu asistente de IA que realice cualquier operación de Deployado usando lenguaje natural.

Diagnostica una app que falla

"Mi app está regresando errores 502. ¿Qué pasa?"

Usa deployado_doctordeployado_get_logs

Despliega tu app

"Desplegar mi app a producción"

Usa deployado_deploy

Descubre por qué falló un build

"El último despliegue falló. Muéstrame la salida del build."

Usa deployado_list_releasesdeployado_release_logs

Establecer variables de entorno

"Establecer DATABASE_URL y SECRET_KEY_BASE para mi app"

Usa deployado_set_env

Ejecutar una migración de base de datos

"Ejecutar 'mix ecto.migrate' dentro del contenedor de mi app"

Usa deployado_exec

Crear una base de datos y conectarla

"Crear una base de datos PostgreSQL y conectarla a mi app"

Usa deployado_create_databasedeployado_connect_database

Consejo: El asistente de IA descubrirá y usará automáticamente las herramientas correctas. Solo describe lo que quieres hacer en lenguaje natural — no necesitas recordar nombres de herramientas.

¿Necesitas Ayuda?

Si encuentras algún problema, estamos aquí para ayudar.

Contactar Soporte