O Servidor MCP pode executar o Atlas FERRAMENTAS que executa várias operações do Atlas . Para executar o Atlas FERRAMENTAS, seu Atlas cluster requer uma conta de serviço com as permissões apropriadas. Para obter uma lista dos FERRAMENTAS, consulte FERRAMENTAS do servidor do MongoDB MCP.
Se você não precisar executar inicialmente as ferramentas do Atlas, poderá omitir esta tarefa e fazê-la mais tarde.
Para realizar uma configuração simples do servidor MCP, consulte Introdução. Você pode fornecer uma string de conexão ao seu cluster Atlas.
Sobre esta tarefa
Selecione as permissões para executar o Servidor MCP Atlas FERRAMENTAS e criar uma conta de serviço com essas permissões.
Antes de começar
Selecione as permissões mínimas para a conta de serviço.
Observação
Conceder a função "Proprietário da organização" raramente é necessário e pode ser um risco à segurança.
A tabela a seguir mostra um subconjunto das operações que você pode executar com o Servidor MCP e as funções necessárias para essas operações:
(operação) | Role mais segura para atribuir | Nível |
|---|---|---|
Listar organizações e projetos |
| Organização |
Criar novos projetos |
| Organização |
Visualizar clusters e bancos de dados em um projeto |
| Projeto |
Criar e gerenciar clusters em um projeto |
| Projeto |
Gerenciar listas de acesso de projeto |
| Projeto |
Gerenciar usuários de banco de dados |
| Projeto |
Normalmente, você deve usar funções de nível Project para a maioria das operações e atribuir essas funções aos projetos específicos que precisa gerenciar ou visualizar. Evite Organization Owner, a menos que você exija controle administrativo total sobre todos os projetos e configurações da organização. Anote as permissões que você deseja usar. Você os usará na próxima seção.
Para uma lista completa de funções e privilégios, consulte Funções de usuário do Atlas.
Observação
O Servidor MCP não desabilita nem oculta FERRAMENTAS com base nas permissões da conta de serviço. Se a conta de serviço não tiver a permissão para acessar uma ferramenta, tentar executar a ferramenta pode resultar em um erro.
Habilitar clientes de IA
Os clientes de IA conectam-se ao Atlas por meio do servidor MongoDB MCP. Um Organization Owner deve habilitar a configuração de clientes de IA antes que os nós possam se conectar com um plugin.
Observação
A configuração Clientes de IA se aplica somente ao acesso delegado pelo usuário por meio do Atlas App Connections. Não se aplica ao acesso programático por meio de conexões que usam a Atlas CLI ou a API de administrador do Atlas . Para essas conexões, as permissões vêm das funções atribuídas à conta de serviço na configuração do Servidor MCP.
Para habilitar conexões de plugin de cliente de IA para sua organização:
Você pode utilizar o servidor MCP com implantações locais do Atlas. Para usar as FERRAMENTAS do servidor MCP com implantações locais do Atlas, você deve instalar o Docker. Para uma introdução às implantações locais do Atlas, consulte Criar uma implantação local do Atlas.
Passos
Para limitar o acesso, use uma conta de serviço com funções de nível Project. Atribua essas funções aos projetos específicos que você precisa gerenciar ou visualizar.
Você também pode usar uma conta de serviço com funções de nível Organization. Por exemplo, se você precisar de uma conta de serviço com funções Organization para listar todos os projetos ou gerenciar vários projetos com uma conta de serviço.
As seções a seguir fornecem instruções para criar uma conta de serviço com funções Project ou Organization.
Crie uma conta de serviço do Atlas com funções de projeto
Para criar uma conta de serviço do Atlas com função Project, execute estas etapas:
Criar conta de serviço Atlas
Faça login no Atlas em cloud.mongodb.com.
As instruções pressupõem que você já tenha uma organização e um projeto criados. Clique em Identidade e acesso do projeto na barra lateral, na seção SEGURANÇA.
Clique em Criar aplicativo > Conta de serviço.
Insira um Nome.
Insira uma Descrição.
Defina um período de expiração do segredo do cliente.
No menu Permissões do projeto, selecione as funções apropriadas.
Clique em Criar.
Observação
A interface do Atlas user está sujeita a alterações e as etapas podem variar. Para obter detalhes, consulte Conceder Acesso Programático a uma Organização.
Salvar credenciais do cliente
Depois de criar sua conta de serviço do Atlas, você verá um ID de cliente e um segredo de cliente. Copie e salve o segredo do cliente. A IU não o exibirá novamente.
Você usará o ID e o segredo do cliente para definir apiClientId e apiClientSecret na seção Conectando com as credenciais da API Atlas posteriormente.
Adicionar entrada da lista de acesso
Para permitir que o Servidor MCP se conecte ao seu Atlas cluster, adicione uma entrada de lista de acesso para o endereço IP do computador no qual o Servidor MCP executa. Se você executar o servidor MCP em sua máquina local, adicione seu endereço IP local.
Clique em Adicionar entrada da lista de acesso.
Insira seu endereço IP.
Clique em Salvar.
Crie uma conta de serviço do Atlas com funções de organização
Se você precisar de uma conta de serviço com funções Organization, execute estas etapas:
Criar conta de serviço Atlas
Faça login no Atlas em cloud.mongodb.com.
As instruções pressupõem que você já tenha uma organização criada. Selecione sua organização na seção ORGANIZAÇÃO perto da parte superior da página.
Clique em Aplicativos na barra lateral na seção IDENTITY & ACCESS.
Clique em Adicionar nova > Conta de serviço.
Insira um Nome.
Insira uma Descrição.
Defina um período de expiração do segredo do cliente.
No menu Permissões da organização, selecione as funções apropriadas.
Clique em Criar.
Observação
A interface do Atlas user está sujeita a alterações e as etapas podem variar. Para obter detalhes, consulte Conceder Acesso Programático a uma Organização.
Salvar credenciais do cliente
Depois de criar sua conta de serviço do Atlas, você verá um ID de cliente e um segredo de cliente. Copie e salve o segredo do cliente. A IU não o exibirá novamente.
Você usará o ID e o segredo do cliente para definir apiClientId e apiClientSecret na seção Conectando com as credenciais da API Atlas posteriormente.
Adicionar entrada da lista de acesso
Para permitir que o Servidor MCP se conecte ao seu Atlas cluster, adicione uma entrada de lista de acesso para o endereço IP do computador no qual o Servidor MCP é executado. Se você executar o servidor MCP em sua máquina local, adicione seu endereço IP local.
Navegue até Acesso à Rede.
Clique em Adicionar Endereço IP.
Insira seu endereço IP.
Próximos passos
Depois de criar a conta de serviço, você pode configurar o servidor MCP para usar as credenciais da API Atlas . Para obter detalhes, consulte Conectando-se com as credenciais do Atlas API.