Ваши API.
В контексте агента.

Проверьте Node.js и npm

Нужен Node.js 18 или новее и npm. В терминале (Windows: PowerShell) выполните:

node --version
npm --version

Обе команды должны вывести номер версии. Если команда не найдена, установите Node.js с официального сайта и заново откройте терминал.

Распакуйте сервер в постоянную папку

Скачайте ZIP выше. Переместите папку insomnia-mcp-server, например, в ~/Tools/ или C:\Tools\. Не удаляйте её после подключения: клиент запускает сервер из этой папки.

insomnia-mcp-server/
├── dist/
│   └── index.js  ← файл запуска
├── package.json
├── package-lock.json
└── README.md

Установите зависимости сервера

Откройте терминал именно в распакованной папке — рядом должен быть package.json. Выполните:

npm ci --omit=dev

Нужен доступ к npm registry. Дождитесь завершения без ошибок; рядом появится node_modules. При запуске из исходного репозитория вместо релизного ZIP нужны npm ci и npm run build.

Зарегистрируйте сервер в MCP-клиенте

В настройках вашего AI-клиента найдите локальные MCP-серверы. Укажите транспорт STDIO, команду node и один аргумент — абсолютный путь к dist/index.js. Точное название раздела и формат настроек зависят от клиента.

Для клиентов, принимающих конфигурацию в формате mcpServers, пример выглядит так. Добавьте запись к существующим серверам, не заменяя весь файл:

{
  "mcpServers": {
    "insomnia": {
      "command": "node",
      "args": ["/home/alice/Tools/insomnia-mcp-server/dist/index.js"]
    }
  }
}

{
  "mcpServers": {
    "insomnia": {
      "command": "node",
      "args": ["C:\\Tools\\insomnia-mcp-server\\dist\\index.js"]
    }
  }
}

Если клиент не видит node, укажите полный путь к исполняемому файлу. Узнать его: command -v node на Linux/macOS или (Get-Command node).Source в PowerShell.

Укажите данные Insomnia, если автопоиск не сработал

Обычно сервер находит данные автоматически. Если нет — добавьте env внутри настройки сервера insomnia:

"env": {
  "INSOMNIA_DATA_DIR": "/home/alice/.config/Insomnia"
}

Это фрагмент конфигурации: перед env нужна запятая после поля args. Нужна папка с файлами insomnia.Workspace.db и insomnia.Request.db, не папка plugins.

Проверьте соединение и папки OpenAPI

1. Сохраните настройки и перезапустите MCP-клиент. Убедитесь, что сервер подключён и его инструменты доступны.
2. Попросите агента вызвать list_collections. Ожидаемый результат — список локальных коллекций Insomnia без ошибки доступа к данным.
3. Создайте отдельную тестовую коллекцию через create_collection, затем передайте содержимое демо OpenAPI в import_from_openapi с её collectionId.
4. Вызовите list_requests: должны появиться папки Users, Orders и Без группы. Группировка включена по умолчанию.
5. Вызовите export_collection и импортируйте полученный JSON-файл через Import в Insomnia. Проверьте те же три папки в новой коллекции.

Для отдельной проверки в приложении можно сразу скачать готовый тестовый экспорт Insomnia и открыть его через Import. Это проверит импорт папок в Insomnia; подключение MCP проверяется шагами выше.

Демо использует адрес https://example.invalid: оно предназначено для проверки структуры, а не отправки запросов. Исходные коллекции не меняются.

OpenAPI demo
├── Users
│   └── List users
├── Orders
│   └── List orders
└── Без группы
    └── Health