Carregando Serverfy API Referencia...
La API RESTful de Serverfy proporciona una interfaz de alto rendimiento y aislamiento seguro por Workspace para aprovisionar servidores cloud, administrar sitios, configurar bases de datos e interactuar con webhooks de forma programática.
Aprovisionamiento de servidores cloud en DigitalOcean, Hetzner, AWS, Linode y Vultr, seguimiento de métricas de CPU y gestión de claves SSH.
Creación de sitios Laravel, Node.js o estáticos, gestión automatizada de certificados SSL (Let's Encrypt / On-Demand TLS) y despliegues con cero tiempo de inactividad.
Aprovisionamiento de MySQL, PostgreSQL y Redis, gestión de usuarios y creación de Instant DB Snapshots atómicos antes de cada migración.
Diagnóstico proactivo de incidentes de infraestructura, análisis de causa raíz y propuestas de Corrección Rápida supervisada (Human-in-the-Loop).
Telemetría en tiempo real, latencia p50/p95/p99, agregación de excepciones con seguimiento de errores, live logs y optimizador de Slow Queries.
Control de servidores y despliegues mediante lenguaje natural directamente desde Claude Code, Cursor, Antigravity e IDEs modernos.
Base 0 https://serverfy.io/api/v1 Formato: application/json (UTF-8) Predeterminado: RESTful / JSON Payload
La API tiene un límite predeterminado de 100 solicitudes por minuto por Workspace. Todas las respuestas incluyen los encabezados X-RateLimit-Limit y X-RateLimit-Remaining. Las solicitudes que excedan el límite recibirán el estado HTTP 429 Too Many Requests.
| Código | Significado | Descripción |
|---|---|---|
200 OK |
Éxito | La solicitud se procesó y se devolvió con éxito. |
201 Created |
Creado | El recurso (servidor, sitio, base de datos o despliegue) se creó correctamente. |
400 Bad Request |
Solicitud Inválida | El cuerpo de la solicitud o los parámetros enviados están mal formados. |
401 Unauthorized |
No Autorizado | Clave de API (Bearer Token) ausente, inválida o revocada. |
403 Forbidden |
Prohibido | El Workspace no tiene privilegios suficientes para ejecutar esta acción en el recurso. |
404 Not Found |
No Encontrado | El recurso solicitado no existe o no pertenece a este Workspace. |
422 Unprocessable |
Error de Validación | Campos obligatorios ausentes o que no cumplen las reglas de validación. |
429 Rate Limit |
Límite Excedido | Se ha alcanzado el límite de 100 solicitudes por minuto por Workspace. |
500 Server Error |
Error en el Servidor | Fallo interno de ejecución. Notifique a soporte o revise los registros del servidor. |
La API de Serverfy utiliza Bearer Tokens (Tokens de Acceso Personal) gestionados por Laravel Sanctum, garantizando aislamiento criptográfico por Workspace y control estricto de permisos.
En la barra lateral de la aplicación, haga clic en Workspace > Claves de API o acceda directamente desde la consola.
Haga clic en el botón "Nueva Clave de API" en la parte superior de la lista de claves.
Asigne un nombre claro que describa el propósito de la integración (ej: CI/CD Deployments, Agente MCP Local, Backup Sync).
Copie el token inmediatamente. Por motivos de seguridad, el token completo solo se muestra una vez en el momento de la creación.
Authorization: Bearer 1|abcdef1234567890abcdef1234567890 Accept: application/json Content-Type: application/json
curl -X GET "https://serverfy.io/api/v1/servers" \ -H "Authorization: Bearer SEU_TOKEN_AQUI" \ -H "Accept: application/json"
Si la clave de API está ausente, incorrecta o revocada, la API responderá con el estado HTTP 401:
{ "message": "Unauthenticated." }
Serverfy es compatible de forma nativa con el Model Context Protocol (MCP), lo que permite conectar asistentes de Inteligencia Artificial modernos — como Claude Code, Claude Desktop, Cursor y Antigravity — directamente a la infraestructura de su Workspace.
Al habilitar la conexión MCP, la IA obtiene capacidades estrictas (Tools) para inspeccionar métricas, disparar despliegues con reversión atómica y reiniciar servicios de forma segura, auditable y protegida.
En el panel de Serverfy, genere un Personal Access Token con los permisos adecuados.
El token generado será su Bearer Token para autenticarse con el servidor SSE de MCP.
Configure el cliente pasando el encabezado AUTHORIZATION: Bearer SEU_TOKEN en las variables de entorno.
To connect Serverfy to Anthropic's Claude, open the configuration file ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) O %APPDATA%\Claude\claude_desktop_config.json (Windows) y agregue el servidor a través de SSE:
{ "mcpServers": { "serverfy": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-sse", "https://serverfy.io/api/v1/mcp/sse" ], "env": { "AUTHORIZATION": "Bearer SEU_TOKEN_AQUI" } } } }
El servidor MCP de Serverfy expone un catálogo completo de herramientas granulares, seguras y auditadas para copilotos de IA.
list_serversLista servidores aprovisionados, proveedores en la nube (AWS, DO, Hetzner, Vultr) y estado de conectividad.
list_sitesLista aplicaciones, dominios, ramas activas, entorno de ejecución y estado actual de cada sitio del espacio de trabajo.
deploy_siteActiva el despliegue atómico sin tiempo de inactividad con comprobación de estado y reversión automática en caso de fallo.
read_server_metricsObtiene telemetría en tiempo real de CPU, RAM, uso de disco y series temporales históricas de 1h a 7 días.
restart_workerReinicia los trabajadores en segundo plano (Supervisor/Horizon) con cierre ordenado de colas activas.
promote_staging_sitePromueve el entorno de pruebas o la vista previa efímera de PR a producción con sincronización de base de datos.
manage_site_cacheConfigura reglas de microcaché FastCGI/Caddy, TTL, omisión para sesiones autenticadas y encabezados HTTP.
purge_fastcgi_cachePurga instantáneamente la caché en memoria y disco de una aplicación sin reiniciar el servidor web.
manage_site_hibernationHiberna sitios inactivos o restaura aplicaciones a pedido con un proxy de retención, liberando memoria y CPU.
manage_telemetryConfigura la retención de registros, métricas de Sentinel Sense y alertas de latencia percentil (p95/p99).
manage_load_balancerAdministra grupos de upstream multinodo, políticas de balanceo de carga (round-robin, least-conn) y comprobaciones de estado.
list_database_replicasConsulta réplicas de lectura configuradas para MySQL/PostgreSQL y retraso de replicación (segundos detrás del maestro).
create_database_replicaAprovisiona y sincroniza una nueva réplica de base de datos con replicación en streaming en nodos secundarios.
promote_database_replicaPromueve la réplica secundaria a nodo principal en caso de mantenimiento o conmutación por error.
manage_backup_replicationConfigura la replicación de copias de seguridad entre múltiples proveedores S3, Backblaze B2 y Wasabi.
evaluate_dns_failoverComprueba el estado de las zonas Cloudflare/Route53 y realiza una conmutación por error automática del tráfico desde nodos degradados.
list_centurion_proposalsLista propuestas autónomas de optimización de servidor generadas por Centurion AI Copilot pendientes de aprobación.
approve_centurion_proposalAprueba y ejecuta el plan de acción recomendado por la IA con seguimiento de auditoría completo.
reject_centurion_proposalDescarta la propuesta de acción con justificación técnica registrada para el aprendizaje del copiloto.
run_centurion_watchdogInicia un escaneo bajo demanda de procesos zombis, bloqueos de puertos y sobrecarga de CPU.
run_compliance_scanEjecuta una auditoría CIS Benchmark y valida permisos SSH, firewall UFW y versiones del entorno de ejecución.
remediate_compliance_issueAplica corrección automática para fallos de cumplimiento identificados en el informe de seguridad.
Con MCP configurado en Claude o Cursor, puede solicitar cosas como: "Despliegue el sitio de pruebas en el servidor web-01" O "Analice los registros de errores de Nginx de los últimos 15 minutos y dígame qué endpoint está fallando".
Observabilidad unificada y auto-recuperación para servidores y aplicaciones: telemetría de latencia p50/p95/p99, seguimiento inteligente de excepciones, live logs unificados, detección temprana de incidentes y optimización automatizada de Slow Queries.
Diagnóstico continuo de anomalías (OOM Killers, bucles de caída, saturación de PHP-FPM) y sugerencias de Correcciones Rápidas (Quick Fixes) con aprobación humana.
Histogramas y percentiles de latencia HTTP (p50, p95 y p99), tasa de rendimiento (req/seg) y códigos de estado agrupados en tiempo real sin sobrecarga.
Monitoreo de consultas SQL lentas (>100ms) y detección de consultas N+1, ofreciendo EXPLAIN estructurado y migraciones listas para creación de índices.
Captura y agregación automática de errores y excepciones no controladas con stack trace completo, variables de entorno sanitizadas e historial de ocurrencias.
El agente de Serverfy recopila métricas del sistema y las aplicaciones y las envía periódicamente. También puede integrar sistemas personalizados a través de los endpoints autenticados de la API:
curl -X POST "https://serverfy.io/api/v1/telemetry/ingest" \ -H "Authorization: Bearer SEU_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "server_id": "srv-01", "metrics": { "cpu_usage": 23.4, "memory_used_mb": 1840, "http_p95_ms": 112 } }'
Sentinel AI nunca aplica cambios estructurales o destructivos sin autorización explícita. Al detectar un incidente, formula la causa raíz y proporciona la acción de Corrección Rápida para que lo ejecute con un solo clic.
Protección integral para su infraestructura contra pérdida de datos e indisponibilidad: Instant DB Snapshots automáticos antes de cada despliegue con reversión instantánea, replicación multi-cloud en múltiples proveedores de storage y escalado automático inteligente de workers.
Creación de un punto de restauración instantáneo de la base de datos antes de ejecutar migraciones. Si el lanzamiento falla, revierta al estado exacto con 1 clic.
Distribución simultánea de copias de seguridad entre múltiples proveedores independientes (AWS S3, Cloudflare R2 y DigitalOcean Spaces), eliminando el bloqueo de proveedor.
Ajuste dinámico de procesos de cola de Supervisor y workers PHP/Redis basado en la latencia de cola y conteo de tareas pendientes en tiempo real.
Emisión dinámica y automática de certificados SSL para dominios personalizados de clientes en plataformas SaaS, con verificación de seguridad Ask URL.
curl -X POST "https://serverfy.io/api/v1/databases/db-prod-01/snapshots" \ -H "Authorization: Bearer SEU_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "name": "pre-migration-v2.5", "replicate_cross_cloud": true }'
Native integration with cloud DNS providers to automate domain validation, root A records, CAA issuance records for Let's Encrypt SSL, and wildcard routing across all provisioned servers.
Automated record provisioning using dedicated IAM access keys with granular zone-level permissions.
Scoped API tokens restricted to Zone:DNS edit capabilities for enterprise and personal domains.
Direct domain synchronization using DigitalOcean Personal Access Tokens with write privilege.
For security, never use AWS root account keys. Create a dedicated IAM user with specific Route 53 permissions.
Navigate to IAM > Users > Create User. Set username as serverfy-route53 and select Attach policies directly.
Attach the AmazonRoute53FullAccess policy or apply the least-privilege JSON policy shown below.
Under Security Credentials, click Create Access Key. Select Third-party service and copy Access Key ID and Secret Access Key.
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "route53:ListHostedZones", "route53:GetHostedZone", "route53:ListResourceRecordSets", "route53:ChangeResourceRecordSets", "route53:GetChange" ], "Resource": "*" } ] }
In Cloudflare, always use a scoped API Token with Zone:DNS Edit and Zone:Zone Settings Edit permissions instead of the Global API Key.
Open dash.cloudflare.com/profile/api-tokens and click Create Token.
Grant Zone > DNS > Edit (to manage A, CAA records & enable orange cloud proxy) and Zone > Zone Settings > Edit (to automate Full Strict SSL and Always Use HTTPS without redirect loops).
Save the generated token and paste it into Workspace > DNS Providers > Cloudflare.
Generate a Personal Access Token in DigitalOcean with Read and Write permissions to enable full DNS zone management.
Go to cloud.digitalocean.com/account/api/tokens and click Generate New Token.
Set token name (e.g. serverfy-dns) and ensure Write scope is enabled.