Comando start

Inicie el entorno de ejecución de Data API Builder con un archivo de configuración existente.

Syntax

dab start [options]

Vista rápida

Sección principal

-c, --config

Ruta de acceso al archivo de configuración. El valor predeterminado es a dab-config.json menos que dab-config.<DAB_ENVIRONMENT>.json exista, donde DAB_ENVIRONMENT es una variable de entorno.

Example

dab start \
  --config ./settings/dab-config.json

dab start ^
  --config .\settings\dab-config.json

--LogLevel <level>

Especifica el nivel de registro según el valor proporcionado. Para conocer los valores posibles, consulte Niveles de registro.

Example

dab start \
  --LogLevel Warning

dab start ^
  --LogLevel Warning

--no-https-redirect

Deshabilita la redirección automática de HTTP→HTTPS.

Example

dab start \
  --no-https-redirect

dab start ^
  --no-https-redirect

--mcp-stdio

Inicia data API Builder como un servidor MCP que usa la entrada y salida estándar en lugar de enlazar a un puerto HTTP. En este modo, DAB se comunica con un cliente MCP (como GitHub Copilot, Visual Studio (VS) Code o cualquier agente de IA compatible con MCP) completamente a través stdin de y stdout mediante el protocolo de contexto de modelo. No se expone ningún servidor HTTP ni puerto de red.

Esta marca también acepta un argumento posicional role:<role-name> opcional que especifica el rol de permiso DAB en el que se ejecutan todas las llamadas a la herramienta MCP. El rol debe coincidir con un nombre definido en la sección de la configuración de la permissions entidad. Si se omite, el rol tiene anonymouscomo valor predeterminado .

Cuando --mcp-stdio está activo, los comportamientos siguientes se aplican automáticamente independientemente de la configuración del archivo de configuración:

• Codificación: la entrada y salida de la consola se fuerza a UTF-8 sin una marca de orden de bytes (BOM) para una comunicación de entrada/salida JSON sobre estándar limpia.
• Autenticación: el proveedor de autenticación se ve obligado al modo simulador , lo que habilita el rol especificado sin necesidad de un token web JSON (JWT) o proveedor de identidades real.
• Ningún host HTTP: DAB no se enlaza a ningún puerto del Protocolo de control de transmisión (TCP). El servidor MCP se ejecuta completamente a través de stdin/stdout.

Configuración necesaria

MCP debe estar habilitado en dab-config.json antes de usar --mcp-stdio:

"runtime": {
  "mcp": {
    "enabled": true,
    "path": "/mcp",
    "dml-tools": {
      "create-record": true,
      "read-records": true,
      "update-record": true,
      "delete-record": true
    }
  }
}

Example

# Default anonymous role
dab start \
  --mcp-stdio \
  --config ./dab-config.json

# Specific role
dab start \
  --mcp-stdio role:authenticated \
  --config ./dab-config.json

# With logging
dab start \
  --mcp-stdio role:api-reader \
  --config ./dab-config.json \
  --LogLevel Information

:: Default anonymous role
dab start ^
  --mcp-stdio ^
  --config .\dab-config.json

:: Specific role
dab start ^
  --mcp-stdio role:authenticated ^
  --config .\dab-config.json

:: With logging
dab start ^
  --mcp-stdio role:api-reader ^
  --config .\dab-config.json ^
  --LogLevel Information

Configuración del cliente MCP

Dado que DAB se ejecuta como un subproceso que se comunica a través de la entrada y salida estándar, el cliente MCP debe iniciar DAB como un proceso secundario y canalizar stdin y stdout. Una configuración de cliente MCP típica para Visual Studio (VS) Code o un agente compatible tiene el siguiente aspecto:

{
  "servers": {
    "my-database": {
      "type": "stdio",
      "command": "dab",
      "args": [
        "start",
        "--mcp-stdio",
        "role:anonymous",
        "--config",
        "./dab-config.json"
      ]
    }
  }
}

Para ver un tutorial completo, consulte transporte de entrada y salida estándar para SQL MCP Server.

--verbose

Establece el nivel de registro en Informativo. Se trata de una marca de conveniencia equivalente a --LogLevel Information.

Example

dab start \
  --verbose

dab start ^
  --verbose

--help

Muestra la pantalla de ayuda.

Example

dab start --help

dab start --help

--version

Mostrar información de versión.

Example

dab start --version

dab start --version