O servidor MongoDB MCP permite a interação com seus dados e implantações do MongoDB de clientes de IA em linguagem natural.
Você pode usar o servidor MCP MongoDB com qualquer implantação MongoDB, incluindo MongoDB Atlas, MongoDB Atlas Local, MongoDB Community Edition e Enterprise Advanced.
MongoDB offers two MCP Server deployment types: Local MCP for MongoDB MCP Server, which you run and manage yourself, and MongoDB Atlas Managed MCP Server, which MongoDB hosts and manages for you in Atlas. To learn more, see What is the MongoDB MCP Server? below.
O que é o Model Context Protocol (MCP)?
O Model Context Protocol (MCP) é um padrão aberto desenvolvido pela Agroup para padronizar como os LLMs se conectam e interagem com recursos e serviços externos. O MCP consiste em uma arquitetura cliente-servidor com os seguintes componentes principais:
Host do MCP: aplicativo ou ambiente onde você deseja usar o MCP, como uma interface de chat ou IDE. Por exemplo, Execution Desktop ou VS Code.
Clientes MCP: componentes dentro do host que lidam com conexões com servidores MCP. Para obter uma lista de clientes compatíveis com MCP, consulte Clientes MCP.
Servidores MCP: Programas que expõem capacidades específicas ao cliente. Por exemplo, o servidor MongoDB MCP.
A principal maneira de os servidores MCP exporem os recursos aos clientes é por meio do FERRAMENTAS. FERRAMENTAS são funções predefinidas e executáveis que permitem que os LLMs executem ações específicas, como interagir com fontes de dados externas como o MongoDB.
Para saber mais, consulte a documentação do MCP.
O que é o servidor MongoDB MCP?
O Servidor MongoDB MCP é a nossa implementação oficial do servidor MCP que fornece ao seu cliente de IA um conjunto de FERRAMENTAS que podem ser usadas para interagir com seus dados e implantações MongoDB. Essas ferramentas incluem várias ações administrativas, como gerenciar recursos de cluster, operações de banco de dados , como query e indexação, e otimização de desempenho por meio do Performance Advisor.
O MongoDB oferece dois tipos de implantação para o MongoDB MCP Server:
MCP local para MongoDB MCP Server: você executa o servidor MCP e gerencia diretamente suas conexões de agente de IA e a infraestrutura do servidor MCP.
Servidor MCP gerenciado do MongoDB Atlas: o MongoDB executa o servidor MCP no Atlas e gerencia as conexões do agente de IA e a infraestrutura do servidor MCP para você.
Você pode configurar qualquer tipo de implantação com o plugin MongoDB MCP ou usando um arquivo de configuração:
MongoDB MCP Plugin for AI Clients: You install MongoDB from an AI client's marketplace. An AI client is an interface that you use to prompt an AI model. The MongoDB MCP Plugin for the MongoDB Atlas Managed MCP Server provides user-delegated access for interactive AI clients.
Manual configuration file setup: You manually add the MongoDB MCP Server configuration and your OAuth client credentials to a configuration file for your AI client. This setup path is best for working with programmatic agents. Programmatic agents are automated, workflow-driven agents that can run multi-step workflows without a user's input or guidance.
A tabela a seguir compara o MCP local para o servidor MCP do MongoDB e o servidor MCP gerenciado do MongoDB Atlas. Use isso para ajudar a selecionar o tipo de implantação que melhor se adapta às suas necessidades:
MCP local para servidor MCP do MongoDB | Servidor MCP gerenciado do MongoDB Atlas | |
|---|---|---|
Modelo de hospedagem | Você instala, executa e mantém o servidor MongoDB MCP você mesmo. Você é responsável por atualizações de servidor, conectividade e rotação de credenciais. | O MongoDB hospeda, executa e mantém o MongoDB MCP servidor no Atlas. Não há infraestrutura de servidor MCP para você implantar, atualizar ou operar. |
Implantações de banco de dados compatíveis | Autogerenciado (no local) e Atlas (nuvem) | Atlas (nuvem) apenas |
Nível de controle de acesso | Até o acesso ao plano de dados no nível da coleção | Acesso ao plano de dados até o nível do projeto |
Melhor para | Usuários que desejam controle direto e granular sobre onde o MongoDB MCP servidor executa e como ele se conecta às implantações do MongoDB. | Usuários que usam implantações do Atlas e desejam que o MongoDB hospede e gerencie o servidor para eles. |
Servidor MCP gerenciado do MongoDB Atlas
Com o MongoDB Atlas Managed MCP servidor, o MongoDB hospeda e gerencia o MongoDB MCP servidor no Atlas em vez de exigir que você execute o servidor em sua própria máquina ou infraestrutura. Como o MongoDB opera o servidor, você não implanta, atualiza ou mantém nenhuma infraestrutura MCP e não gerencia string de conexão, segredos ou certificados para a conexão com sua implantação do Atlas.
O MongoDB Atlas Managed MCP Server oferece os seguintes benefícios:
Streamlined deployment access: When using the MongoDB MCP Plugin to connect to the MongoDB Atlas Managed MCP Server, you can access your database deployments directly using Atlas App Connections without needing to manage service account credentials.
Amplo suporte ao usuário: o MongoDB Atlas gerenciado MCP servidor oferece suporte a usuários que trabalham com clientes de IA interativos e usuários que usam agentes programáticos.
Controles de governança do administrador: incluindo aceitação em nível de organização e aplicação somente leitura para clientes de IA e funções por configuração, listas de acesso IP e configurações somente leitura para agentes programáticos.
MCP local para servidor MCP do MongoDB
O MCP local para MongoDB MCP servidor é o caminho do MongoDB MCP servidor autogerenciado. Você executa o MCP servidor por conta própria e o conecta manualmente à sua implantação e FERRAMENTAS do MongoDB.
Use o MCP local quando quiser controle direto sobre como e onde o servidor MCP é executado. Em troca desse controle, você assume a hospedagem e a manutenção do servidor, incluindo atualizações do servidor e gerenciamento de credenciais.
Você também usa o MCP local quando deseja usar o servidor MCP MongoDB com tipos de implantação local, como MongoDB Atlas Local, MongoDB Community Edition e MongoDB Enterprise Advanced.
Casos de uso
O Servidor MongoDB MCP permite que você interaja com seus dados e implantações do MongoDB usando linguagem natural, simplificando os fluxos de trabalho do desenvolvedor e facilitando a execução de tarefas complexas a partir de interfaces de IA. Por exemplo, o servidor MongoDB MCP habilita os seguintes casos de uso:
Caso de uso | Descrição | exemplo de prompt |
|---|---|---|
Exploração de dados | Aprenda e explique seu esquema e relacionamentos do banco de dados . |
|
Operações do Banco de Dados | Crie, leia, atualize e exclua dados em suas coleções MongoDB . |
|
Gerenciamento de banco de dados | Execute tarefas administrativas para gerenciar seus clusters, usuários do banco de dados e muito mais. |
|
Geração de código | Descreva os dados necessários e, em seguida, gere queries MongoDB e código de aplicação relevantes. |
|
Otimização de desempenho | Analise o desempenho da query e obtenha recomendações para índices e melhorias de esquema. |
|
Para obter uma lista dos FERRAMENTAS específicos disponíveis no Servidor MongoDB MCP, consulte FERRAMENTAS do Servidor MongoDB MCP.
Métodos de configurar
Você pode configurar o MCP local para o MongoDB MCP Server e o MongoDB Atlas Managed MCP Server usando o plugin MongoDB MCP do marketplace de um cliente de IA ou configurando manualmente o MongoDB MCP Server em um arquivo de configuração para seu cliente de IA.
Plugin MongoDB MCP para acesso delegado pelo usuário
O plugin MongoDB MCP ajuda os usuários a dar aos clientes de IA acesso delegado pelo usuário para explorar as implantações do MongoDB. Este método usa o Atlas App Connections, que permite autorizar um cliente de IA a acessar seus recursos do Atlas por meio de um fluxo OAuth vinculado à sua identidade do Atlas.
Este método não requer infraestrutura MCP ou credenciais para gerenciar. Com o MongoDB MCP Plugin:
Você encontra o MongoDB como um conector ou plugin no marketplace de um cliente de IA e o autoriza usando o Atlas aplicativo Connections.
O cliente de IA atua em seu nome usando sua identidade do Atlas.
A atualização do token é automática. Você não gerencia uma string de conexão, segredo ou certificado.
Você pode visualizar e revogar os clientes de IA aos quais você se conectou a qualquer momento.
To learn more, see Atlas App Connections Overview.
Configurar arquivo de configuração usando credenciais de cliente OAuth
Você pode adicionar manualmente uma configuração do MongoDB MCP servidor ao arquivo de configuração do seu cliente de IA. Esse método de configuração é especialmente útil para acesso programático ao agente.
As credenciais que você usa dependem do seu tipo de implantação
Para MCP local para MongoDB MCP Server, você adiciona suas próprias credenciais para se conectar à sua implantação do MongoDB, incluindo strings de conexão de cluster e credenciais de API do Atlas opcionais para ferramentas do Atlas.
Para o MongoDB Atlas gerenciado MCP servidor, um Atlas Organization Owner ou Project Owner cria uma configuração do MongoDB Atlas gerenciado MCP servidor via Atlas. Esta configuração:
Provisiona uma conta de serviço e retorna um ID de cliente, um segredo de cliente e o URL do servidor MCP gerenciado do MongoDB Atlas (
https://mcp.mongodb.com) que você fornece ao seu agente.Usa contas de serviço Atlas de entrada e saída separadas. O cliente de IA recebe credenciais de entrada que concedem acesso apenas ao servidor MCP gerenciado do MongoDB Atlas. O servidor então usa uma conta de serviço de saída separada, configurada com as permissões Atlas necessárias, para fazer chamadas de API em nome do cliente de IA. As credenciais de egresso não são expostas ao cliente de IA.
Autentica o cliente de IA usando a conta de serviço e usa as funções que o administrador atribui, em vez da identidade de um usuário individual.
Os administradores obtêm controle granular por configuração sobre o servidor MCP gerenciado do MongoDB Atlas, incluindo:
As funções do Atlas concedidas
Uma lista de acesso IP
Um sinalizador somente leitura (habilitado por padrão)
Pacote MCP gerenciado pelo Atlas para contas de serviço de configuração MCP
Some AI clients don't natively support the MCP configuration service account OAuth client-credentials flow that MongoDB Atlas Managed MCP Server uses for programmatic access. To connect these clients, use the mongodb-atlas-mcp-remote npm package. You run this package using npx in your client's configuration file. The package acquires an access token from your MCP configuration service account credentials and forwards requests to MongoDB Atlas Managed MCP Server, handling token caching and refresh for you. This allows you to seamlessly connect AI clients to the MongoDB Atlas Managed MCP Server.
Use este pacote apenas para clientes de IA que se conectam por meio de um arquivo de configuração. As instruções específicas do cliente na página Introdução ao servidor MCP do MongoDB já usam o pacote.
Se você criar um agente programático usando um framework de IA como o LangChain, não use este pacote. Em vez disso, obtenha um token de acesso e chame o MongoDB Atlas Managed MCP Server diretamente do código do seu aplicativo. Para saber mais, consulte Introdução ao MongoDB MCP Server e selecione AI Framework Clients no menu suspenso AI CLIENT.
Saiba mais
Para configurar o servidor MongoDB MCP e saber como usá-lo, consulte os seguintes recursos:
Comece a usar rapidamente o servidor MCP MongoDB . | |
Visualize os pré-requisitos para configurar o servidor MongoDB MCP. | |
Veja todas as opções disponíveis de configuração e conexão. | |
Veja todos os FERRAMENTAS disponíveis no servidor MongoDB MCP. | |
exemplo de teste de prompts para usar com o servidor MongoDB MCP. | |
Saiba mais sobre as práticas recomendadas de segurança para o servidor MongoDB MCP. | |
Visualize o código-fonte do servidor MongoDB MCP e as diretrizes de contribuição. |