Compartilhar via


comando

Inicie o runtime do Construtor de API de Dados com um arquivo de configuração existente.

Sintaxe

dab start [options]

Olhar rápido

Opção Resumo
-c, --config Use um arquivo de configuração específico (padrões para ou arquivo específico do ambiente, se presente)
--LogLevel <level> Especifica o nível de log conforme o valor fornecido.
--mcp-stdio (Protocolo de Contexto de Modelo (MCP)) Inicia o DAB como um servidor de entrada/saída (stdio) padrão MCP em vez de um servidor HTTP. Requer em configuração.
--no-https-redirect Desabilita o redirecionamento HTTP→HTTPS automático
--verbose Define o nível de log como Informações
--help Exiba a tela de ajuda.
--version Exibir informações de versão.

-c, --config

Caminho para o arquivo de configuração. O padrão é, a menos que exista, onde está uma variável de ambiente.

Example

  • Bash
  • Prompt de comando
dab start \
  --config ./settings/dab-config.json

--LogLevel <level>

Especifica o nível de log conforme o valor fornecido. Para obter valores possíveis, consulte os níveis de log.

Example

  • Bash
  • Prompt de comando
dab start \
  --LogLevel Warning

--no-https-redirect

Desabilita o redirecionamento HTTP→HTTPS automático.

Example

  • Bash
  • Prompt de comando
dab start \
  --no-https-redirect

--verbose

Define o nível mínimo de log como .

Example

  • Bash
  • Prompt de comando
dab start \
  --verbose

--mcp-stdio

Observação

Essa opção é um recurso mcp (Protocolo de Contexto de Modelo) que foi introduzido na versão 1.7. Ele requer na seção do seu . Para obter detalhes completos da configuração do MCP, consulte a visão geral do SQL MCP Server.

Inicia o construtor de API de Dados como um servidor de entrada/saída padrão do MCP (stdio) em vez de associar a uma porta HTTP. Nesse modo, o DAB se comunica com um cliente MCP (como GitHub Copilot, Visual Studio (VS) Code ou qualquer agente de IA compatível com MCP) inteiramente sobre entrada/saída padrão (stdin/stdout) usando o protocolo de contexto Model. Nenhum servidor HTTP ou porta de rede é exposto.

Esse sinalizador também aceita um argumento posicional opcional que especifica a função de permissão DAB sob a qual todas as chamadas de ferramenta MCP são executadas. A função deve corresponder a um nome definido na seção da configuração da entidade. Se omitida, a função usará como padrão .

Quando estiver ativo, os seguintes comportamentos serão aplicados automaticamente, independentemente das configurações do arquivo de configuração:

  • Codificação: a entrada/saída do console é forçada a UTF-8 sem uma marca de ordem de byte (BOM) para comunicação de entrada/saída JSON-over-standard limpa.
  • Autenticação: o provedor de autenticação é forçado ao modo Simulador , habilitando a função especificada sem exigir um JWT (Token Web JSON) real ou um provedor de identidade.
  • Nenhum host HTTP: o DAB não se associa a nenhuma porta TCP (Protocolo de Controle de Transmissão). O servidor MCP é executado inteiramente por stdin/stdout.

Importante

O prefixo é necessário. Se o nome da função não corresponder a uma função definida em suas permissões de entidade, as chamadas à ferramenta MCP serão negadas.

Configuração necessária

O MCP deve estar habilitado no seu antes de usar :

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

Example

  • Bash
  • Prompt de comando
# 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

Configuração do cliente MCP

Como o DAB é executado como um subprocesso comunicando-se por entrada/saída padrão (stdio), seu cliente MCP deve iniciar o DAB como um processo filho e canalizar seu stdin/stdout. Uma configuração típica do cliente MCP para Visual Studio (VS) Code ou um agente compatível tem a seguinte aparência:

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

Para obter um passo a passo completo, consulte o transporte padrão de entrada/saída (stdio) para o SQL MCP Server.


--help

Exiba a tela de ajuda.

Example

  • Bash
  • Prompt de comando
dab start --help

--version

Exibir informações de versão.

Example

  • Bash
  • Prompt de comando
dab start --version