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

Métodos de configuração do servidor MongoDB MCP

Para configurar o Servidor MongoDB MCP para se conectar ao cluster MongoDB e definir outras opções de Servidor MCP, use qualquer um destes métodos:

  • Arquivo de configuração JSON com opções do servidor MCP

  • Opções de linha de comando

  • Variáveis de ambiente do sistema operacional

O servidor MCP usa credenciais do Atlas API ou uma string de conexão para acessar um cluster.

Métodos e opções de conexão do cluster de servidor MCP

Para configurar o Servidor MCP para se conectar a um cluster e definir outras opções do Servidor MCP, use um método descrito nesta seção.

Observação

Os exemplos de arquivo de configuração do Servidor MCP incluem --readOnly para garantir acesso somente leitura aos dados. Normalmente, ative o modo somente leitura para evitar alterações de dados.

Para habilitar operações de gravação, omita --readOnly ou defina a variável de ambiente do sistema operacional MDB_MCP_READ_ONLY como false. Para obter mais informações, consulte Ativação do modo somente leitura do servidor MCP.

Os exemplos de arquivo de configuração do servidor MCP definem o campo type como "stdio".

type pode ser definido como um dos seguintes:

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

  • "http", que permite comunicações HTTP com o Servidor MCP. Você pode então usar HTTP para interagir com o Servidor MCP a partir de um cliente web .

    Aviso

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

Os exemplos de arquivo de configuração do Servidor MCP também definem o nome do Servidor MCP como "MongoDB". Você pode alterar o nome do servidor para corresponder ao nome do seu servidor MCP depois de iniciá-lo. O nome do servidor identifica o servidor MCP para o cliente AI.

Conexão com credenciais Atlas API

Você pode usar as credenciais da API do Atlas obtidas em Pré-requisitos do servidor do MongoDB MCP para executar as ferramentas do Atlas para se conectar a um cluster do Atlas.

Observação

Como você verá na próxima seção, você também pode se conectar a um Atlas cluster usando uma string de conexão do MongoDB se não quiser usar as credenciais da API do Atlas por segurança ou outro motivo.

Use variáveis de ambiente em vez de argumentos de linha de comando para definições de configuração confidenciais, como credenciais de login e informações de conexão. Por exemplo, use MDB_MCP_API_CLIENT_ID e MDB_MCP_API_CLIENT_SECRET para configurações do cliente API e MDB_MCP_CONNECTION_STRING para connection strings.

As variáveis de ambiente são mais seguras do que os argumentos da linha de comando. Os argumentos da linha de comando podem ser rastreados, armazenados em cache, incluídos em listas de processos e registrados em vários locais.

Para se conectar com as credenciais da API do Atlas , defina as variáveis de ambiente MDB_MCP_API_CLIENT_ID e MDB_MCP_API_CLIENT_SECRET na seção env do arquivo de configuração JSON para o cliente de IA :

...
"args": [
   "-y",
   "mongodb-mcp-server@latest",
   "--readOnly"
],
"env": {
   "MDB_MCP_API_CLIENT_ID": "<atlas-service-account-client-id>",
   "MDB_MCP_API_CLIENT_SECRET": "<atlas-service-account-client-secret>"
}
...

Substitua <atlas-service-account-client-id> e <atlas-service-account-client-secret> pelas suas informações Atlas .

Para obter exemplos completos de arquivos de configuração JSON para vários clientes de IA, consulte Introdução ao servidor MongoDB MCP.

Conexão com a connection string do cluster

Se não quiser usar as credenciais da API do Atlas por motivos de segurança ou outro motivo, você poderá se conectar a um cluster usando uma string de conexão do MongoDB .

O exemplo seguinte mostra uma string de conexão para conectar a um agrupamento do Atlas :

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

Substitua <user-name>, <password>, <cluster-name> e <database-name> pelas suas informações do Atlas .

Você também pode se conectar a um cluster local com uma string de conexão. Por exemplo:

...
"args": [
   "-y",
   "mongodb-mcp-server@latest",
   "--readOnly"
],
"env": {
   "MDB_MCP_CONNECTION_STRING":
   "mongodb://127.0.0.1:27019/?directConnection=true"
}
...

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.

Definindo variáveis de ambiente do servidor MCP no sistema operacional

Você pode definir variáveis de ambiente para definir várias opções de configuração para o servidor MCP.

Para definir variáveis de ambiente do sistema operacional para o Servidor MCP, use o prefixo MDB_MCP_ seguido do nome da variável em maiúsculas com sublinhados. Por exemplo, use MDB_MCP_CONNECTION_STRING para definir a opção connectionString.

Use variáveis de ambiente em vez de argumentos de linha de comando para definições de configuração confidenciais, como credenciais de login e informações de conexão. Por exemplo, use MDB_MCP_API_CLIENT_ID e MDB_MCP_API_CLIENT_SECRET para configurações do cliente API e MDB_MCP_CONNECTION_STRING para connection strings.

As variáveis de ambiente são mais seguras do que os argumentos da linha de comando. Os argumentos da linha de comando podem ser rastreados, armazenados em cache, incluídos em listas de processos e registrados em vários locais.

Nos exemplos nas seções seguintes, substitua <atlas-service-account-client-id>, <atlas-service-account-client-secret>, <user-name>, <password>, <cluster-name> e <database-name> pelas suas informações do Atlas .

Variáveis de ambiente Unix

Os exemplos a seguir mostram como definir as variáveis de ambiente do servidor MCP em um sistema operacional baseado em Unix:

# Set Atlas API credentials for a service account
export MDB_MCP_API_CLIENT_ID="<atlas-service-account-client-id>"
export MDB_MCP_API_CLIENT_SECRET="<atlas-service-account-client-secret>"
# Set a MongoDB connection string
export MDB_MCP_CONNECTION_STRING="mongodb+srv://<user-name>:<password>@<cluster-name>.mongodb.net/<database-name>"
# Change the MCP Server log path from the default
export MDB_MCP_LOG_PATH="/mcp/logs"

Variáveis de ambiente da linha de comando do Windows

Os exemplos a seguir definem as variáveis usando em uma linha de comando do Windows:

:: Set Atlas API credentials for a service account
set MDB_MCP_API_CLIENT_ID=<atlas-service-account-client-id>
set MDB_MCP_API_CLIENT_SECRET=<atlas-service-account-client-secret>
:: Set a MongoDB connection string
set MDB_MCP_CONNECTION_STRING="mongodb+srv://<user-name>:<password>@<cluster-name>.mongodb.net/<database-name>"
:: Change the MCP Server log path from the default
set MDB_MCP_LOG_PATH="C:\mcp\logs"

Variáveis de ambiente do Windows PowerShell

Os exemplos a seguir definem as variáveis em uma sessão do Windows PowerShell:

# Set Atlas API credentials for a service account
$env:MDB_MCP_API_CLIENT_ID="<atlas-service-account-client-id>"
$env:MDB_MCP_API_CLIENT_SECRET="<atlas-service-account-client-secret>"
# Set a MongoDB connection string
$env:MDB_MCP_CONNECTION_STRING="mongodb+srv://<user-name>:<password>@<cluster-name>.mongodb.net/<database-name>"
# Change the MCP Server log path from the default
$env:MDB_MCP_LOG_PATH="C:\mcp\logs"

Saiba mais

Voltar

Opções

Próximo

Habilitar ou desabilitar recursos

Nesta página