Agentes de IA

StackQL ofrece a los agentes de IA la misma interfaz SQL que usan las personas para consultar, aprovisionar y operar servicios en la nube y de SaaS. Un agente descubre lo que expone un provider, valida una consulta antes de ejecutarla, lee el estado en vivo con SELECT y lo modifica con INSERT, UPDATE y DELETE, sin archivo de estado y sin un SDK por cada nube.

Cómo se conectan los agentes

• MCP sobre stdio para clientes de editor y de escritorio como Claude Desktop, Cursor y Continue. El propio cliente inicia stackql mcp --mcp.server.type=stdio. Consulte Servidor MCP.
• MCP sobre HTTP para agentes independientes y automatización que se conectan a un proceso stackql mcp o stackql srv de larga duración, con autenticación mediante token bearer y TLS opcional.
• MCP integrado para aplicaciones compiladas: el servidor se ejecuta en proceso en Go, Rust, Swift, Kotlin, .NET y Gleam. Consulte MCP integrado.
• Protocolo de red de PostgreSQL mediante stackql srv para marcos de agentes, notebooks y herramientas de BI que ya hablan Postgres.

Inicio rápido con Claude Desktop

Instale desde el Connector Directory de Anthropic (recomendado) o desde el MCP Bundle descargable, o registre el servidor manualmente en claude_desktop_config.json:

{
  "mcpServers": {
    "stackql": {
      "command": "stackql",
      "args": ["mcp", "--mcp.server.type=stdio", "--tls.allowInsecure"],
      "env": {
        "AWS_ACCESS_KEY_ID": "your-aws-access-key-id",
        "AWS_SECRET_ACCESS_KEY": "your-aws-secret-access-key"
      }
    }
  }
}

Incluya solo las credenciales de los providers que vaya a usar. Las instrucciones completas, incluidas las descargas del bundle y el uso de un archivo de credenciales, se encuentran en Usar StackQL con Claude Desktop.

Qué puede hacer un agente

El servidor MCP expone un conjunto de herramientas pequeño y tipado. Cada herramienta devuelve una vista renderizada para el modelo y una carga útil estructurada para los clientes programáticos.

• Descubrir: list_providers, list_services, list_resources, list_methods y describe_method recorren la jerarquía del provider y devuelven las entradas y los campos de salida de cada operación, de modo que los parámetros de WHERE obligatorios se conocen antes de escribir una consulta.
• Validar y leer: validate_select_query analiza y planifica un SELECT sin ejecutarlo; run_select_query lo ejecuta.
• Modificar: run_mutation_query ejecuta INSERT, UPDATE, REPLACE y DELETE; run_lifecycle_operation ejecuta operaciones de ciclo de vida EXEC. Ambas están controladas por el modo del servidor que se describe más abajo.
• Mantenimiento: server_info, list_registry, pull_provider y reload_credentials.

La referencia completa, con las entradas, el comportamiento del control y un prompt de ejemplo por herramienta, está en Herramientas MCP.

Barreras de protección

El modo del servidor establece el contrato de seguridad de toda la sesión:

Modo	SELECT / metadatos	INSERT / UPDATE / REPLACE	DELETE / EXEC
read_only	permitir	rechazar	rechazar
safe (valor predeterminado)	permitir	requiere aprobación	requiere aprobación
delete_safe	permitir	permitir	requiere aprobación
full_access	permitir	permitir	permitir

"Requiere aprobación" usa la elicitación de MCP: los clientes que la admiten (Claude Desktop, Cursor, Continue) muestran al usuario el nombre de la herramienta, la clase de consulta y el SQL, y esperan una decisión antes de ejecutar nada; los clientes que no la anuncian reciben un rechazo. Cada llamada a una herramienta se escribe en un log de auditoría, los listeners HTTP requieren un token bearer y las credenciales se obtienen del entorno o de un archivo dotenv sin que los valores secretos se devuelvan nunca al cliente. Los detalles están en Modos del servidor, Autenticación de clientes HTTP y Log de auditoría.

Pasos siguientes

• Servidor MCP - modos de despliegue, configuración, modos del servidor, log de auditoría y opciones.
• Herramientas MCP - la referencia completa de las herramientas, con entradas, control y prompts de ejemplo.
• MCP integrado - ejecute el servidor dentro de su propia aplicación Go, Rust, Swift, Kotlin, .NET o Gleam.
• Query Library - SQL listo para ejecutar para preguntas habituales sobre operaciones en la nube, por provider.
• Referencia de IA - conceptos, guías prácticas, comparaciones y solución de problemas escritos para los agentes y para las personas que los crean.