Menu Docs
Página inicial do Docs
/
Servidor MCP do MongoDB
/
Configurar

Opções de configuração do servidor MongoDB MCP

O Servidor MCP tem várias opções que você pode definir para se conectar a um cluster MongoDB e controlar as operações do Servidor MCP. Você pode definir as opções em um arquivo de configuração JSON, por meio de uma linha de comando ou usando variáveis de ambiente do sistema operacional.

Lista de opções

Use as seguintes opções de configuração para configurar o Servidor MCP.

Importante

Se você for um usuário do MongoDB Enterprise ou do MongoDB Atlas e precisar de um mecanismo de autenticação específico, consulte a seção Segurança do Servidor MongoDB MCP para saber mais sobre as opções de configuração do seu método de autenticação.

Nome da opção CLI
Nome da variável de ambiente do sistema operacional
Tipo
Default
Descrição

apiClientId

MDB_MCP_API_CLIENT_ID

string

Não definido

ID do cliente Atlas API para autenticação.

apiClientSecret

MDB_MCP_API_CLIENT_SECRET

string

Não definido

Segredo do cliente Atlas API para autenticação.

connectionString

MDB_MCP_CONNECTION_STRING

string

Não definido

Connection string para uma conexão direta do banco de dados .

Define a string de conexão no tempo de execução para permitir que o cliente se conecte diretamente a um cluster.

Importante

O argumento CLI --connectionString está obsoleto. Em vez dela, use a variável de ambiente MDB_MCP_CONNECTION_STRING. Se as variáveis de ambiente não forem uma opção, use o primeiro argumento posicional.

Observação

Normalmente, evite fornecer a string de conexão no tempo de execução porque você expõe as credenciais de conexão ao grandes modelos de linguagem.

A string de conexão é usada se o cliente nunca tiver se conectado antes ou se o cliente alternar a conexão para um novo cluster se o cliente tiver sido conectado anteriormente.

Depois que o cliente chama a ferramenta de conexão de conexão ou alternância, o cliente reutiliza a mesma conexão para operações subsequentes. Portanto, você só precisa chamar a ferramenta de conexão connect ou wtich uma vez ou se precisar alternar para uma conexão diferente.

loggers

MDB_MCP_LOGGERS

string

disk mcp

Especifica para onde o servidor MCP envia os logs.

Defina loggers para uma ou mais das seguintes opções:

  • disk, que grava registros em arquivos de disco localizados no caminho especificado na opção logPath.

  • mcp, que envia os registros para o cliente de IA, se o cliente suportar protocolo de registro e transporte.

  • stderr, que envia os registros para a saída de erro padrão. Esta configuração é útil para depuração ou ao executar MCP em um contêiner.

Por exemplo, para definir loggers como mcp e stderr no arquivo de configuração JSON do cliente IA ou na linha de comando do sistema operacional, use --loggers mcp stderr.

Para definir a variável de ambiente do sistema operacional MDB_MCP_LOGGERS como disk e stderr, use export MDB_MCP_LOGGERS="disk,stderr".

Para obter mais informações sobre as opções de registro, consulte Solucionar problemas do servidor MongoDB MCP.

logPath

MDB_MCP_LOG_PATH

string

Depende do sistema operacional

Diretório que armazena os registros do servidor MCP.

Para obter mais informações sobre o caminho do registro e especificações do sistema operacional, consulte Solucionar problemas do servidor MongoDB MCP.

disabledTools

MDB_MCP_DISABLED_TOOLS

array

Não definido

Uma array de nomes de ferramentas MCP, tipos de operação ou categorias de ferramentas para desabilitar.

Para obter mais informações, consulte Desativando o Servidor MCP FERRAMENTAS.

readOnly

MDB_MCP_READ_ONLY

booleano

false

Para desabilitar operações de gravação de cluster, defina --readOnly no arquivo de configuração ou linha de comando ou defina a variável de ambiente do sistema operacional MDB_MCP_READ_ONLY como true.

O padrão é permitir operações de gravação do cluster. Normalmente, sempre ative o modo somente leitura .

Para obter mais informações, consulte Habilitar o modo somente leitura do servidor MCP.

indexCheck

MDB_MCP_INDEX_CHECK

booleano

false

Se true, impõe que as operações de query devem usar um índice e rejeita queries que executam verificações de collection.

Para obter mais informações, consulte Habilitando a verificação de índice.

telemetry

MDB_MCP_TELEMETRY

string

enabled

Se disabled, a coleta de dados de uso do Servidor MCP será interrompida.

Para obter mais informações, consulte Desabilitar a telemetria do servidor MCP.

transport

MDB_MCP_TRANSPORT

string

stdio

Protocolo de transporte para comunicações com o servidor MCP.

Defina transport para uma das seguintes opções:

  • stdio, que é o padrão. Utiliza a entrada e saída padrão para comunicações com o Servidor MCP. stdio é adequado para a maioria dos clientes de IA.

  • http, que permite comunicações HTTP com o Servidor MCP. Em seguida, você pode usar HTTP para interagir com o Servidor MCP a partir de um cliente Web ou se comunicar com o Servidor MCP em uma porta IP HTTP específica.

    Aviso

    O transporte HTTP NÃO é recomendado para uso de produção sem implementar medidas adequadas de autenticação e segurança.

httpPort

MDB_MCP_HTTP_PORT

inteiro

3000

Número da porta IP para comunicações HTTP com o servidor MCP.

httpHost

MDB_MCP_HTTP_HOST

string

127.0.0.1

Endereço IP para comunicações HTTP com o servidor MCP.

Com o Streamable HTTP, o servidor MCP é vinculado a localhost (127.0.0.1) por padrão. Isso garante que o servidor MCP aceite somente conexões originadas no mesmo computador.

Aviso

A vinculação ao 0.0.0.0 expõe o servidor MCP a toda a rede local, o que permite que outros dispositivos na mesma rede acessem potencialmente o servidor MCP. Isso é um risco à segurança e pode permitir o acesso não autorizado ao contexto do seu banco de dados . Se você precisar expor o servidor MCP fora de localhost, implemente uma autenticação de segurança forte.

Para saber mais, consulte Conexões remotas.

idleTimeoutMs

MDB_MCP_IDLE_TIMEOUT_MS

inteiro

600000

Tempo limite ocioso para um cliente se desconectar. Aplica-se apenas ao transporte HTTP.

notificationTimeoutMs

MDB_MCP_NOTIFICATION_TIMEOUT_MS

inteiro

540000

Tempo limite de notificação para que um cliente esteja ciente da desconexão. Aplica-se apenas ao transporte HTTP.

authenticationMechanism

MDB_MCP_AUTHENTICATION_MECHANISM

string

SCRAM-SHA-256

SCRAM é o mecanismo de autenticação padrão para MongoDB. Para se conectar às suas implementações do MongoDB com o servidor MongoDB MCP usando outros métodos de autenticação, consulte as seguintes páginas:

exportsPath

MDB_MCP_EXPORTS_PATH

string

Depende do sistema operacional

Diretório que armazena arquivos de dados exportados.

Para obter mais informações sobre o caminho de exportação e especificações do sistema operacional, consulte Exportar dados do servidor MongoDB MCP.

exportTimeoutMs

MDB_MCP_EXPORT_TIMEOUT_MS

inteiro

300000

Tempo em milissegundos após o qual os arquivos de dados exportados estão qualificados para exclusão pelo processo de limpeza do Servidor MCP.

exportCleanupIntervalMs

MDB_MCP_EXPORT_CLEANUP_INTERVAL_MS

inteiro

120000

Período de tempo em milissegundos entre execuções automáticas do processo de limpeza do Servidor MCP que exclui arquivos de dados de exportação expirados. O processo de limpeza é executado automaticamente.

Argumentos Posicionais

O servidor MCP aceita um argumento posicional que pode ser fornecido sem especificar um sinalizador CLI. O primeiro argumento posicional é interpretado como a string de conexão para sua implantação do MongoDB .

Como prática de segurança recomendada, use a variável de ambiente MDB_MCP_CONNECTION_STRING para definir a string de conexão. Se as variáveis de ambiente não forem uma opção, use o primeiro argumento posicional. Por exemplo:

"args": [
   "-y",
   "mongodb-mcp-server",
   "mongodb+srv://<user-name>:<password>@<cluster-name>.mongodb.net/",
   "--readOnly"
]

Saiba mais

Voltar

Configurar

Próximo

Métodos

Nesta página