Como Instalar e Configurar Servidor MongoDB MCP

No cenário em constante evolução do desenvolvimento de software, a integração de Inteligência Artificial não é mais um conceito futurista, mas uma realidade presente. Ferramentas com tecnologia de IA estão rapidamente se tornando indispensáveis para desenvolvedores, otimizando fluxos de trabalho e aumentando a produtividade. Reconhecendo essa tendência, o MongoDB introduziu uma ferramenta inovadora que preenche a lacuna entre seu banco de dados e a IA: o MongoDB Model Context Protocol (MCP) Server. Este tutorial fornece um guia abrangente, passo a passo, para instalar e configurar o MongoDB MCP Server, capacitando você a aproveitar todo o potencial da IA em seu ambiente de desenvolvimento.

💡

Quer uma ótima ferramenta de Teste de API que gera documentação de API bonita?

Quer uma plataforma integrada, Tudo-em-Um para sua Equipe de Desenvolvedores trabalhar junta com produtividade máxima?

O Apidog entrega todas as suas demandas e substitui o Postman por um preço muito mais acessível!

botão

O que é o MongoDB MCP Server?

O MongoDB MCP Server é uma nova e poderosa ferramenta projetada para conectar suas implantações MongoDB a uma variedade de clientes com tecnologia de IA que suportam o Model Context Protocol (MCP). Quer você esteja usando o MongoDB Atlas, o banco de dados em nuvem totalmente gerenciado, ou uma edição Community ou Enterprise Advanced auto-hospedada, o MCP Server permite uma interação perfeita com seus dados usando linguagem natural. Isso significa que você pode realizar uma ampla gama de operações de banco de dados, desde consultas de dados simples até tarefas administrativas complexas, tudo por meio de comandos intuitivos e conversacionais dentro de suas ferramentas de desenvolvimento de IA favoritas.

O MCP é um padrão aberto, inicialmente introduzido pela Anthropic, que está ganhando rapidamente força por sua capacidade de criar uma camada de comunicação padronizada entre agentes de IA e diversos sistemas de dados. Ao implementar este protocolo, o MongoDB garante que seus usuários possam permanecer na vanguarda do desenvolvimento orientado por IA. O MCP Server facilita um canal de comunicação bidirecional, permitindo que você não apenas consulte seus dados, mas também forneça a seus Large Language Models (LLMs) as informações mais atuais e contextualmente relevantes de seu banco de dados. Isso é um divisor de águas para tarefas como exploração de dados, administração de banco de dados e geração de código consciente do contexto.

O MongoDB MCP Server suporta um ecossistema crescente de clientes MCP, incluindo:

Windsurf: Um editor de código nativo de IA onde o servidor MCP está disponível prontamente.
Cursor: Um popular editor de código com tecnologia de IA.
GitHub Copilot in Visual Studio Code: Trazendo o poder do seu banco de dados para o IDE mais popular do mundo.
Anthropic's Claude: Interaja com seu banco de dados diretamente do aplicativo de desktop Claude.

Vamos começar!

Screenshot-2025-06-20-at-11.41.12-PM.png

Pré-requisitos

Antes de mergulharmos no processo de instalação, há alguns pré-requisitos que você precisa ter em vigor:

Node.js e npx: O MongoDB MCP Server é um aplicativo Node.js e geralmente é instalado e executado usando npx, o executor de pacotes do Node.js. Você precisará do Node.js versão 18 ou superior instalado em seu sistema. Você pode verificar sua versão do Node.js abrindo um terminal ou prompt de comando e executando node -v.
String de Conexão MongoDB ou Credenciais de API do Atlas: Para se conectar ao seu banco de dados, o MCP Server precisa de uma string de conexão MongoDB padrão ou credenciais de API para sua conta MongoDB Atlas.
String de Conexão: Este é o formato URI padrão para se conectar a uma instância MongoDB. Inclui nome de usuário, senha, host, porta e nome do banco de dados.
Credenciais de API do Atlas: Se você estiver usando o MongoDB Atlas, pode criar uma conta de serviço com as permissões necessárias e usar o ID do Cliente API e o Segredo do Cliente gerados para autenticação. Este método é necessário para usar as ferramentas específicas do Atlas.
Um Cliente MCP: Você precisará de um dos clientes MCP suportados instalados, como Cursor, Claude Desktop ou Visual Studio Code com a extensão GitHub Copilot.
Docker (Opcional): Se você preferir executar o MCP Server em um ambiente conteinerizado, precisará ter o Docker e o Docker Compose instalados. Isso é particularmente útil para testes de sandbox local e para evitar uma instalação local do Node.js.

Instalação e Configuração

O processo de instalação e configuração para o MongoDB MCP Server varia ligeiramente dependendo do cliente MCP que você está usando. O cerne do processo envolve adicionar uma configuração JSON ao arquivo de configurações do seu cliente que informa como iniciar e se comunicar com o servidor MCP.

O comando principal para executar o servidor é npx -y mongodb-mcp-server. A flag -y confirma automaticamente a instalação do pacote, caso ele ainda não esteja presente.

Configurando no Cursor

Cursor é um editor de código focado em IA que está ganhando rapidamente popularidade. Veja como você pode configurar o MongoDB MCP Server no Cursor:

Abra as Configurações do Cursor: Inicie o Cursor e clique no ícone de engrenagem no canto superior direito da janela para abrir as configurações.
Navegue até a Seção MCP: No painel de configurações à esquerda, clique em "MCP".
Adicione um Novo Servidor MCP Global: Clique no botão "Add new global MCP server" (Adicionar novo servidor MCP global). Isso abrirá um arquivo de configuração JSON.
Insira a Configuração: Copie e cole a seguinte configuração JSON no arquivo. Você precisará personalizá-la com seus detalhes de conexão.

JSON

{
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server"
    ],
    "environments": [
      {
        "name": "ATLAS_API_CLIENT_ID",
        "value": "your-atlas-api-client-id"
      },
      {
        "name": "ATLAS_API_CLIENT_SECRET",
        "value": "your-atlas-api-client-secret"
      }
    ]
  }
}

Se você estiver usando uma string de conexão em vez de credenciais de API do Atlas, sua configuração será assim:JSON

{
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server",
      "--connectionString",
      "your-mongodb-connection-string"
    ]
  }
}

Salve a Configuração: Salve o arquivo. O Cursor agora poderá usar seu novo MongoDB MCP Server.

Com o servidor configurado, agora você pode interagir com seu banco de dados usando linguagem natural dentro do Cursor. Se você usou suas credenciais de API do Atlas, terá acesso a um rico conjunto de ferramentas específicas do Atlas, permitindo criar clusters gratuitos, gerenciar listas de acesso, criar usuários de banco de dados e muito mais. Se você usou uma string de conexão, terá acesso a ferramentas para gerenciamento de banco de dados, como listar bancos de dados e coleções, gerenciar índices e realizar operações CRUD (Criar, Ler, Atualizar, Excluir).

Configurando no Claude Desktop

Se você é um usuário do Claude da Anthropic, pode integrar o MongoDB MCP Server diretamente no aplicativo de desktop Claude.

Abra o Arquivo de Configuração: Inicie o aplicativo Claude Desktop, então navegue até Settings > Developer > Edit Config. Isso abrirá o arquivo claude_desktop_config.json em seu editor de texto padrão. O local deste arquivo é tipicamente:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

Adicione a Configuração do Servidor MCP: Adicione a seguinte configuração ao objeto mcpServers no arquivo JSON.

JSON

{
  "mcpServers": {
    "MongoDB": {
      "command": "npx",
      "args": [
        "-y",
        "mongodb-mcp-server",
        "--connectionString",
        "mongodb+srv://<user-name>:<password>@<cluster-name>.mongodb.net/test"
      ]
    }
  }
}

Certifique-se de substituir a string de conexão de placeholder pela sua string de conexão real.

Reinicie o Claude Desktop: Feche e reinicie o aplicativo Claude Desktop.
Verifique o Servidor: Clique no ícone de martelo no Claude Desktop. O MongoDB MCP Server agora deve ser listado como uma ferramenta disponível.

Configurando no Visual Studio Code com GitHub Copilot

Para os milhões de desenvolvedores que usam o Visual Studio Code, o MongoDB MCP Server pode ser integrado ao GitHub Copilot para trazer a interação com o banco de dados em linguagem natural para o seu IDE favorito.

Abra a Paleta de Comandos: Abra o VS Code e pressione Ctrl+Shift+P (ou Cmd+Shift+P no macOS) para abrir a paleta de comandos.
Adicione um Novo Servidor MCP: Digite "mcp" na paleta de comandos e selecione "MCP: Add Servers" (MCP: Adicionar Servidores).
Escolha Comando Entrada/Saída Padrão: Selecione "Command Standard I/O" (Comando Entrada/Saída Padrão) como o tipo de servidor.
Insira o Comando: Digite o comando npx -y mongodb-mcp-server e dê um nome ao seu servidor, por exemplo, "mongodb".
Configure em settings.json: Isso abrirá seu arquivo settings.json. Aqui, você pode adicionar seus argumentos e variáveis de ambiente. Por exemplo, para usar uma string de conexão:

JSON

"mcp.servers": {
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server",
      "--connectionString",
      "your-mongodb-connection-string"
    ]
  }
}

Ou, para usar credenciais de API do Atlas:JSON

"mcp.servers": {
  "mongodb": {
    "command": "npx",
    "args": [
      "-y",
      "mongodb-mcp-server"
    ],
    "options": {
      "env": {
        "ATLAS_API_CLIENT_ID": "your-atlas-api-client-id",
        "ATLAS_API_CLIENT_SECRET": "your-atlas-api-client-secret"
      }
    }
  }
}

Inicie o Servidor: Você pode iniciar o servidor clicando no botão "Start" (Iniciar) que aparece acima do nome do servidor em seu arquivo settings.json, ou abrindo a paleta de comandos, procurando por "MCP: List Servers" (MCP: Listar Servidores), selecionando seu servidor e então selecionando "Start Server" (Iniciar Servidor).

Uma vez que o servidor esteja em execução, você pode usar o modo de agente do GitHub Copilot para interagir com seu ambiente MongoDB Atlas. Você pode pedir para listar seus projetos, criar novos clusters, gerenciar usuários e muito mais, tudo dentro do VS Code.

Configuração Avançada

O MongoDB MCP Server oferece várias opções de configuração avançada para ajustar seu comportamento às suas necessidades específicas.

Modo Somente Leitura

Para maior segurança, especialmente ao se conectar a bancos de dados de produção, você pode executar o servidor no modo somente leitura. Isso impedirá quaisquer operações de escrita, como criar, atualizar ou excluir documentos. Você pode habilitar o modo somente leitura usando um argumento de linha de comando:

npx mongodb-mcp-server --readOnly

Ou definindo uma variável de ambiente:

export MDB_MCP_READ_ONLY=true

Desabilitando Ferramentas Específicas

Você pode desabilitar ferramentas específicas para restringir as capacidades do servidor. Isso é útil por segurança ou para simplificar os comandos disponíveis. Você pode desabilitar ferramentas usando o argumento de linha de comando --disabledTools, seguido por uma lista de nomes de ferramentas separados por espaço.

npx mongodb-mcp-server --disabledTools create update delete atlas collectionSchema

Alternativamente, você pode usar a variável de ambiente MDB_MCP_DISABLED_TOOLS com uma lista de nomes de ferramentas separadas por vírgula.

export MDB_MCP_DISABLED_TOOLS="create,update,delete,atlas,collectionSchema"

Telemetria

Por padrão, o MongoDB MCP Server coleta dados de uso anônimos para ajudar a melhorar o produto. Se você deseja desabilitar isso, pode usar o argumento de linha de comando --telemetry disabled ou a variável de ambiente MDB_MCP_TELEMETRY=disabled.

Instalação com Docker

Para aqueles que preferem um ambiente conteinerizado, o MongoDB MCP Server pode ser executado em um contêiner Docker. Isso proporciona isolamento e remove a necessidade de uma instalação local do Node.js.

Para executar o servidor com uma string de conexão:

docker run --rm -i -e MDB_MCP_CONNECTION_STRING="your-mongodb-connection-string" mongodb/mongodb-mcp-server:latest

Para executar com credenciais de API do Atlas:

docker run --rm -i -e MDB_MCP_API_CLIENT_ID="your-atlas-api-client-id" -e MDB_MCP_API_CLIENT_SECRET="your-atlas-api-client-secret" mongodb/mongodb-mcp-server:latest

Você então configuraria seu cliente MCP para usar o comando docker em vez de npx. Por exemplo, no Claude Desktop:JSON

{
  "mcpServers": {
    "MongoDB": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "MDB_MCP_API_CLIENT_ID=your-atlas-api-client-id",
        "-e",
        "MDB_MCP_API_CLIENT_SECRET=your-atlas-api-client-secret",
        "mongodb/mongodb-mcp-server:latest"
      ]
    }
  }
}

Conclusão

O MongoDB MCP Server representa um passo significativo na integração de IA e bancos de dados. Ao fornecer uma maneira padronizada para clientes de IA interagirem com o MongoDB, ele abre um mundo de possibilidades para desenvolvedores. Desde consultas em linguagem natural e exploração de dados até administração de banco de dados assistida por IA e geração de código, o MCP Server está prestes a se tornar uma ferramenta essencial no kit de ferramentas do desenvolvedor moderno.

Este tutorial forneceu um guia abrangente para começar com o MongoDB MCP Server. Seguindo estes passos, você pode conectar rápida e facilmente suas implantações MongoDB às suas ferramentas de IA favoritas e começar a colher os benefícios do desenvolvimento orientado por IA. Como esta é uma tecnologia nova e em evolução, certifique-se de verificar a documentação oficial do MongoDB e o repositório GitHub para as atualizações e recursos mais recentes. O futuro da interação com bancos de dados está aqui, e com o MongoDB MCP Server, você está na vanguarda.

💡

botão