@sota-io/mcp

Servidor MCP para sota.io — despliega aplicaciones web mediante agentes de IA.

Dos transportes

Desde la v1.4.0 este paquete incluye dos transportes:

• sota-mcp (stdio, por defecto) — para Claude Code, Cursor, Windsurf y cualquier cliente MCP que lance un proceso local. Pasa tu SOTA_API_KEY mediante variable de entorno.

• sota-mcp-http (Streamable HTTP) — para alojar tú mismo el endpoint remoto que impulsa mcp.sota.io (usado por Claude Desktop y Claude.ai web). Lee SUPABASE_JWT_SECRET, DATABASE_URL, etc. — la mayoría de usuarios no necesitan esto; es el mismo código que se ejecuta en mcp.sota.io si quieres alojar el tuyo propio.

La mayoría de usuarios quieren el transporte stdio.

Related MCP server: AppsAI MCP Server

Instalación en un clic para Claude Desktop / Claude.ai web

Si usas Claude Desktop o Claude.ai (plan Pro / Max / Team / Enterprise), la instalación más fácil no es este paquete npm — es el endpoint remoto alojado en mcp.sota.io. Haz clic aquí:

Añadir a Claude →

OAuth gestiona la autenticación. Los nuevos usuarios pueden registrarse completamente dentro de Claude mediante la herramienta create_account — sin necesidad de cambiar de pestaña del navegador.

Consulta https://sota.io/docs/integrations/claude.

Inicio rápido (stdio — Claude Code, Cursor, Windsurf, …)

1. Obtén una clave API desde sota.io/dashboard/settings

2. Configura tu IDE

3. Pregunta a tu IA: "Despliega mi app en sota.io"

Instalación

No se necesita instalar — ejecuta directamente con npx:

npx -y @sota-io/mcp

O instala globalmente:

npm install -g @sota-io/mcp
sota-mcp

Configuración

Claude Code

Método CLI:

claude mcp add sota -- npx -y @sota-io/mcp

Luego configura tu clave API en el entorno del shell:

export SOTA_API_KEY=sota_your_api_key_here

JSON manual (.claude/settings.json):

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

Claude Desktop

Edita claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

Cursor

Crea .cursor/mcp.json en la raíz de tu proyecto:

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

Windsurf

Edita ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "sota": {
      "command": "npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

Herramientas

deploy

Despliega una aplicación en sota.io. Crea un archivo tar.gz del directorio especificado y lo sube.

"Deploy my app in the current directory to sota.io"

get-logs

Obtiene los registros de compilación y ejecución de un despliegue. Si no se proporciona deployment_id, devuelve los registros del último despliegue.

"Show me the build logs for my sota.io project"

set-env

Establece una variable de entorno para un proyecto.

"Set DATABASE_URL on my project to postgres://localhost/mydb"

get-env

Lista las variables de entorno de un proyecto.

"Show all environment variables for my project"

rollback

Revierte un proyecto a su despliegue anterior. Intercambia la imagen del contenedor sin reconstruir.

"Roll back my app to the previous version"

get-status

Obtiene el estado actual del despliegue de un proyecto, incluyendo la URL y el historial reciente de despliegues.

"What's the status of my sota.io deployment?"

list-projects

Lista todos los proyectos de tu cuenta de sota.io.

No requiere parámetros.

"List my sota.io projects"

create-project

Crea un nuevo proyecto en sota.io. El slug del proyecto se genera automáticamente a partir del nombre (minúsculas, guiones, máximo 63 caracteres) y se usa como subdominio ({slug}.sota.io). Por ejemplo, "My API" se convierte en my-api.sota.io.

"Create a new sota.io project called my-api"

delete-project

Elimina un proyecto y todos sus despliegues de sota.io. Esta acción es permanente.

"Delete my sota.io project abc123"

add-domain

Añade un dominio personalizado a un proyecto. Devuelve instrucciones DNS para apuntar el dominio.

"Add example.com as a custom domain to my project"

list-domains

Lista todos los dominios personalizados de un proyecto.

"Show all custom domains for my project"

get-domain

Obtiene detalles del dominio, incluyendo el estado de verificación DNS y el estado SSL.

"Check the DNS status of my custom domain"

remove-domain

Elimina un dominio personalizado de un proyecto.

"Remove the custom domain from my project"

Variables de Entorno

Solución de Problemas

"npx: command not found"

Problema: Tu IDE no hereda el PATH del shell donde se carga nvm/fnm.

Solución: Usa la ruta absoluta a npx. Encuéntrala con:

which npx
# Example output: /Users/you/.nvm/versions/node/v22.0.0/bin/npx

Luego actualiza tu configuración MCP para usar la ruta absoluta:

{
  "mcpServers": {
    "sota": {
      "command": "/Users/you/.nvm/versions/node/v22.0.0/bin/npx",
      "args": ["-y", "@sota-io/mcp"],
      "env": {
        "SOTA_API_KEY": "sota_your_api_key_here"
      }
    }
  }
}

"SOTA_API_KEY environment variable is required"

Problema: La clave API no está configurada en tu configuración MCP.

Solución: Añade el bloque env a la configuración de tu servidor MCP. Las variables de entorno del shell no se pasan automáticamente a los servidores MCP — el bloque env en la configuración es necesario:

{
  "env": {
    "SOTA_API_KEY": "sota_your_api_key_here"
  }
}

Errores de conexión rechazada o tiempo de espera

Problema: Problema de red o URL de API incorrecta.

Solución: Verifica tu conexión a internet. Si usas una URL de API personalizada, asegúrate de que SOTA_API_URL esté configurada correctamente. La opción por defecto es https://api.sota.io.

Licencia

MIT

Enlaces

• Sitio web

• Documentación

• Panel de control

• Incidencias