MongoDB MCP

mongodb-js/mongodb-mcp-server· Проверено 12.11.2026· 1,2 тыс.на GitHub

Подключает агента к MongoDB и Atlas: искать документы, считать агрегации, разбирать схему, индексы и медленные запросы, создавать кластеры и пользователей Atlas. В конфиге ниже сервер работает только на чтение.

2 реализации:

Сервер на вашем компьютере: подключается к любой базе по строке подключения, а с сервисным аккаунтом Atlas управляет ещё и кластерами.

Как подключить

Что сделать до подключения

Node.js 22.13 или новее; без Node.js сервер запускается в Docker из образа mongodb/mongodb-mcp-server

Строка подключения к базе или учётные данные сервисного аккаунта Atlas; мастер настройки запускается командой npx -y mongodb-mcp-server@latest setup

MDB_MCP_CONNECTION_STRING

строка подключения к локальной базе или кластеру Atlas с логином и паролем

MDB_MCP_API_CLIENT_ID

по желанию, для инструментов Atlas: Client ID сервисного аккаунта из Access Manager > Organization Access на cloud.mongodb.com, вместе с MDB_MCP_API_CLIENT_SECRET

MDB_MCP_API_CLIENT_SECRET

Client Secret того же аккаунта; показывается один раз, сохраните сразу

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'MDB_MCP_CONNECTION_STRING=<строка подключения mongodb://…>' --transport stdio mongodb \
  -- npx -y mongodb-mcp-server@latest --readOnly

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mongodb]
command = "npx"
args = ["-y", "mongodb-mcp-server@latest", "--readOnly"]

[mcp_servers.mongodb.env]
MDB_MCP_CONNECTION_STRING = "<строка подключения mongodb://…>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": ["-y", "mongodb-mcp-server@latest", "--readOnly"],
      "env": {
        "MDB_MCP_CONNECTION_STRING": "<строка подключения mongodb://…>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mongodb": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mongodb-mcp-server@latest", "--readOnly"],
      "env": {
        "MDB_MCP_CONNECTION_STRING": "<строка подключения mongodb://…>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": ["-y", "mongodb-mcp-server@latest", "--readOnly"],
      "env": {
        "MDB_MCP_CONNECTION_STRING": "<строка подключения mongodb://…>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": ["-y", "mongodb-mcp-server@latest", "--readOnly"],
      "env": {
        "MDB_MCP_CONNECTION_STRING": "<строка подключения mongodb://…>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mongodb": {
        "type": "local",
        "command": ["npx", "-y", "mongodb-mcp-server@latest", "--readOnly"],
        "environment": {
          "MDB_MCP_CONNECTION_STRING": "<строка подключения mongodb://…>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": ["-y", "mongodb-mcp-server@latest", "--readOnly"],
      "env": {
        "MDB_MCP_CONNECTION_STRING": "<строка подключения mongodb://…>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mongodb": {
      "command": "npx",
      "args": ["-y", "mongodb-mcp-server@latest", "--readOnly"],
      "env": {
        "MDB_MCP_CONNECTION_STRING": "<строка подключения mongodb://…>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

findищет документы в коллекции

aggregateвыполняет агрегацию

countсчитает документы

list-databasesпоказывает базы

list-collectionsпоказывает коллекции

collection-schemaописывает схему коллекции

collection-indexesпоказывает индексы

explainпоказывает план запроса

create-indexсоздаёт индекс

insert-manyвставляет документы

update-manyобновляет документы

delete-manyудаляет документы по фильтру

exportвыгружает результат в EJSON

atlas-list-clustersпоказывает кластеры Atlas

atlas-create-free-clusterсоздаёт бесплатный кластер Atlas

atlas-connect-clusterподключается к кластеру Atlas

atlas-create-db-userсоздаёт пользователя базы

atlas-create-access-listоткрывает доступ по IP

atlas-get-performance-advisorдаёт советы по индексам и медленным запросам

search-knowledgeищет по документации MongoDB

Показано 20 из 53.

Сервер на стороне MongoDB для кластеров Atlas: вход через OAuth, ставить ничего не нужно, каждый пользователь работает под своей учётной записью.

Как подключить

Что сделать до подключения

Аккаунт MongoDB Atlas

Клиент с поддержкой OAuth; в Cursor, VS Code, Claude, Codex, GitHub Copilot CLI и Grok Build сервер подключает плагин mongodb-atlas

MDB_MCP_API_CLIENT_ID

для клиентов без OAuth: Client ID из MCP-конфигурации Atlas, вместе с MDB_MCP_API_CLIENT_SECRET, через обёртку npx -y mongodb-atlas-mcp-remote@latest; создать конфигурацию может Organization Owner или Project Owner

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http mongodb-mcp-server https://mcp.mongodb.com

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mongodb-mcp-server]
url = "https://mcp.mongodb.com"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mongodb-mcp-server": {
      "url": "https://mcp.mongodb.com"
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mongodb-mcp-server": {
      "type": "http",
      "url": "https://mcp.mongodb.com"
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mongodb-mcp-server": {
      "httpUrl": "https://mcp.mongodb.com"
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mongodb-mcp-server": {
      "httpUrl": "https://mcp.mongodb.com"
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mongodb-mcp-server": {
        "type": "remote",
        "url": "https://mcp.mongodb.com"
      }
    }
  }
}

Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://mcp.mongodb.com

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mongodb-mcp-server": {
      "url": "https://mcp.mongodb.com"
    }
  }
}

Что попросить агента

«Какие базы и коллекции есть в <строка подключения или кластер>? Опиши схему <коллекция>»Агент вызовет list-databases, list-collections и collection-schema

«Сколько заказов за <месяц> по каждому городу?»Агент соберёт пайплайн и вызовет aggregate по коллекции заказов

«Почему тормозит запрос <запрос>? Предложи индекс»Агент вызовет explain и collection-indexes, для Atlas добавит atlas-get-performance-advisor

«Создай бесплатный кластер Atlas, пользователя и открой доступ с моего IP»Агент вызовет atlas-create-free-cluster, atlas-create-db-user и atlas-create-access-list

«Выгрузи пользователей без email из <коллекция>»Агент вызовет find с фильтром и export, результат сохранится в EJSON

Для каких задач

Найти документы и посчитать агрегацию по коллекции

Описать схему коллекции и её индексы

Разобрать медленный запрос через explain и советы Performance Advisor

Создать кластер Atlas, пользователя базы и открыть доступ по IP

Выгрузить результат запроса в EJSON

Найти ответ в документации MongoDB

Ограничения

find и aggregate по умолчанию отдают не больше 100 документов и 16 777 216 байт за вызов

Инструменты Atlas работают только с учётными данными сервисного аккаунта Atlas

Локальный сервер рассчитан на одного пользователя и не проверяет, кто к нему обращается: открывать его в сеть без своей авторизации нельзя

Подтверждение перед удалением работает только в клиентах с поддержкой elicitation, в остальных инструмент выполняется сразу

Если не работает

Агент в CI или в режиме codex exec пишет «User did not confirm the execution of the <tool> tool so the operation was not performed»

Отвечать на подтверждение некому, и сервер считает это отказом. Если агенту можно доверять, запустите сервер с MDB_MCP_CONFIRMATION_REQUIRED_TOOLS="".

Агент не видит insert-many, update-many и других инструментов записи

Сервер запущен с --readOnly или MDB_MCP_READ_ONLY=true. Уберите флаг, если запись нужна.

Запрос отклонён из-за того, что не использует индекс

Включён режим --indexCheck: создайте индекс через create-index или выключите режим.

К удалённому серверу Atlas не подключиться по статическому ключу API

Удалённый сервер принимает только OAuth. Используйте клиент с OAuth или обёртку mongodb-atlas-mcp-remote с MDB_MCP_API_CLIENT_ID и MDB_MCP_API_CLIENT_SECRET.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
MongoDB MCP Server (локальный)разработчик сервиса	MongoDB	1,2 тыс.	локально	токен	53	12 ноября 2026
MongoDB Atlas-Managed MCP Server (удалённый)разработчик сервиса	MongoDB	1,2 тыс.	HTTP	вход	—	12 ноября 2026

Частые вопросы

Как разрешить агенту менять данные?

Уберите --readOnly из args. В режиме только чтения сервер регистрирует инструменты чтения, подключения и метаданных, а создание, изменение и удаление не регистрирует.

Агент удалит базу без спроса?

drop-database, drop-collection, delete-many, drop-index и ещё 4 инструмента по умолчанию просят подтверждения, если клиент поддерживает elicitation. Целые группы отключаются переменной MDB_MCP_DISABLED_TOOLS, например create,update,delete.

Чем удалённый сервер отличается от локального?

Удалённый работает на стороне MongoDB, только с Atlas, и сам ведёт вход каждого пользователя через OAuth или сервисный аккаунт. Локальный подключается к любой базе, включая базы на своих серверах.

Как отключить телеметрию?

Задайте MDB_MCP_TELEMETRY=disabled, флаг --telemetry disabled или DO_NOT_TRACK=1. Иначе сервер отправляет в MongoDB данные об использовании.

Как запретить запросы без индекса?

Включите --indexCheck или MDB_MCP_INDEX_CHECK=true: запросы с полным сканированием коллекции будут отклоняться с ошибкой.

Работает ли сервер из России?

Локальный сервер работает на вашем компьютере и подключается к базе по строке подключения; для Atlas нужен аккаунт MongoDB Atlas, прокси задаётся переменной HTTPS_PROXY или параметрами SOCKS5 в строке подключения.

MongoDB MCP

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы