@deviatik/mcp

Servidor MCP para gestionar tu plataforma Deviatik (instancias, bases de datos, apps y backends InsForge) desde herramientas de IA que hablan MCP: Claude Code/Desktop, opencode, Cursor, VS Code, Codex, Antigravity…

Configuración (variables de entorno)

| Variable | Descripción | | --- | --- | | DEVIATIK_URL | Base del panel, ej. https://manager.tudominio.com | | DEVIATIK_TOKEN | Token de API (panel → Ajustes → Tokens de API) | | DEVIATIK_SCOPE | admin | client | reseller — opcional; por defecto se deduce del token |

Los tokens son de lectura + acciones seguras. Las operaciones destructivas (delete_instance) requieren un token con permisos total.

Uso con Claude Code

claude mcp add deviatik \
  -e DEVIATIK_URL=https://manager.tudominio.com \
  -e DEVIATIK_TOKEN=dvtk_xxx \
  -- npx -y @deviatik/mcp

Las flags -e van antes del --. Tras cambiar el token, reinicia el cliente (el servidor lee el env al arrancar).

Herramientas

Ver / listar: list_instances, get_instance, instance_access, instance_services, instance_usage, instance_stats, instance_events, instance_logs, list_deployments, deployment_log, list_clients, list_nodes, list_projects, list_products, server_metrics.

Crear: create_app, create_database, create_insforge_backend, adapt_compose, create_compose.

Operar: redeploy_app, start_instance, stop_instance, restart_instance, create_backup, update_insforge_image, change_tier.

Variables: get_app_env, set_app_env, get_compose_env, set_compose_env.

Archivos (compose): list_files, read_file, write_file.

Base de datos: db_tables, db_browse, db_query (SQL real).

Webhooks: list_webhooks, create_webhook, test_webhook, delete_webhook.

Destructivas (token "total"): delete_instance, delete_webhook.

Skills (playbooks)

Prompts invocables que guían a tu IA por flujos completos del producto: skill_desplegar_app, skill_lanzar_backend, skill_desplegar_stack (docker-compose), skill_diagnosticar, skill_reparar_instancia, skill_respaldo_seguro. (Más la guía general deviatik_guia.)

create_compose despliega un docker-compose propio en un nodo dedicado (o el control plane, solo admin); el YAML se sanea y el servicio web se enruta por el dominio.

Referencia completa, ejemplos y solución de problemas: tools/README.md del repositorio.