MongoDB Compass: подключение и первая коллекция без командной строки

Почему Compass стоит открыть раньше, чем консоль

MongoDB можно изучать через команды, и это полезно. Но если ты только начинаешь, терминал часто скрывает главное: как выглядят документы, где коллекции, что реально сохранилось после запроса

MongoDB Compass решает эту проблему. Он показывает базу визуально: слева базы и коллекции, в центре документы, сверху фильтр. Это не делает Compass “игрушкой”. Это нормальный рабочий инструмент, особенно когда нужно быстро посмотреть данные

Что получится в конце

После урока ты:

• подключишь Compass к MongoDB;
• создашь базу crm_demo;
• создашь коллекцию leads;
• добавишь документ заявки;
• найдешь документы через фильтр;
• поймешь, почему Compass не заменяет сервер MongoDB.

Что нужно заранее

Есть два варианта

Первый: MongoDB установлена локально. Тогда строка подключения обычно такая:

mongodb://localhost:27017

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

Важно: не публикуй Atlas connection string с паролем в статьях, скриншотах и репозиториях

Подключаемся к локальной MongoDB

Открой Compass. На стартовом экране будет поле для connection string

Вставь:

mongodb://localhost:27017

Нажми Connect

Если подключение не работает, не спеши переустанавливать Compass. Compass — только клиент. Проверь, запущен ли MongoDB Server

Подключаемся к Atlas

Для Atlas логика другая:

1. В Atlas должен быть создан кластер.
2. Должен быть database user.
3. В Network Access должен быть разрешен твой IP.
4. Строка подключения должна содержать правильный пароль.

Если хотя бы один пункт пропущен, Compass может показывать ошибку подключения

Типичная ошибка новичка: использовать пароль от аккаунта MongoDB вместо пароля database user. Это разные вещи

Создаем базу и коллекцию

После подключения нажми Create database

Заполни:

Database Name: crm_demo
Collection Name: leads

MongoDB создает базу только когда в ней появляется первая коллекция или первый документ. Поэтому пустая “идея базы” сама по себе может не отображаться

Добавляем первый документ

Открой коллекцию leads и добавь документ:

{
  "name": "Мария",
  "email": "maria@example.com",
  "source": "website",
  "budget": 80000,
  "status": "new",
  "createdAt": "2026-05-22"
}

Compass может сам добавить _id. Это нормальное поле MongoDB: уникальный идентификатор документа

Не удаляй _id без причины. Он нужен базе, чтобы отличать документы

Добавляем еще несколько документов

Чтобы фильтры были полезными, добавь еще два:

{
  "name": "Игорь",
  "email": "igor@example.com",
  "source": "telegram",
  "budget": 25000,
  "status": "in_progress"
}

{
  "name": "Анна",
  "email": "anna@example.com",
  "source": "landing",
  "budget": 50000,
  "status": "new"
}

Теперь коллекция уже похожа на маленькую CRM-таблицу, только в документном виде

Фильтр по статусу

В верхнем поле Filter вставь:

{ "status": "new" }

Compass покажет новые заявки

Если фильтр не сработал, проверь:

• двойные кавычки;
• название поля;
• значение new;
• нет ли лишней запятой.

Фильтр по бюджету

Найдем заявки с бюджетом больше 40000:

{ "budget": { "$gt": 40000 } }

Если поле budget сохранено строкой, а не числом, сравнение может вести себя не так, как ты ждешь. Для бюджета лучше использовать число:

"budget": 50000

а не:

"budget": "50000"

Что удобно смотреть в Compass

Compass хорошо подходит для:

• быстрой проверки, записались ли данные из приложения;
• ручного добавления тестовых документов;
• проверки фильтров;
• просмотра индексов;
• анализа структуры коллекции;
• отладки connection string.

Но Compass не заменяет код приложения. Если проект пишет данные через Node.js, все равно нужно проверять обработку ошибок, валидацию и права доступа

Частые ошибки

“Я установил Compass, но MongoDB не работает”

Compass не является сервером. Нужно установить или подключить MongoDB Server/Atlas

“Я не вижу новую базу”

MongoDB может не показывать пустую базу без коллекции и документов. Создай коллекцию и первый документ

“Фильтр не работает”

Чаще всего ошибка в JSON: одинарные кавычки, лишняя запятая, неправильное имя поля или строка вместо числа

“Atlas не подключается”

Проверь IP whitelist, database user, пароль и правильный cluster URI

Ответы на эти вопросы могут быть для вас полезными

MongoDB Compass нужно скачивать отдельно?

Да, Compass — отдельный GUI-инструмент. Иногда установщик MongoDB может предложить его дополнительно, но это не то же самое, что сервер

Можно ли работать с MongoDB без Compass?

Да. Можно использовать mongosh или код приложения. Compass просто делает первые шаги нагляднее

Compass подходит для продакшена?

Compass можно использовать для просмотра и администрирования, но рабочие операции лучше автоматизировать кодом, миграциями и контролируемыми скриптами

Почему в документе появляется _id?

MongoDB добавляет уникальный идентификатор документа. Он нужен, чтобы отличать одну запись от другой

Следующий шаг

Открой материал Node.js + MongoDB: мини-проект с заявками. Там мы возьмем эту же идею коллекции leads, но будем сохранять документы уже из приложения

Что почитать дальше по MongoDB

Если вы собираете тему по шагам, рядом лучше открыть:

• MongoDB простыми словами: создаем первую коллекцию — освежить базовые понятия: база, коллекция, документ.
• MongoDB Atlas: облачная база для первого проекта — подключить Compass уже к облачному кластеру.
• Node.js + MongoDB: мини-проект с заявками — перейти от ручных документов к API с заявками.
• Как установить MongoDB Community Server и проверить, что база работает — вернуться к локальной установке, если подключение не получилось.