Подключение агента
В QueryLane есть MCP-сервер. AI-агент с поддержкой MCP, например Claude Code или Cursor, может через него читать и собирать задачи, выполнять запросы и запуски и смотреть результаты в вашем профиле QueryLane. Агент работает со своей моделью и своей учётной записью. Встроенный ассистент для этого не нужен.
Подключить поддерживаемый клиент
QueryLane умеет сам настраивать эти клиенты: Claude Code, Claude Desktop, Codex, Cursor, VS Code, Z Code, OpenCode, Hermes Agent и OpenClaw.
- Установите клиент на Mac.
- В QueryLane откройте Настройки > CLI и MCP.
- Найдите клиент в разделе QueryLane MCP и нажмите Подключить. Клиенты, которых QueryLane не нашёл на вашем Mac, перечислены в разделе Другие поддерживаемые клиенты. Установив такой клиент, нажмите Обновить.
- Перезапустите клиент или начните в нём новую сессию. QueryLane напомнит об этом, когда сохранит настройки.
- Проверьте в клиенте, что инструменты QueryLane доступны. Их названия начинаются с
querylane_.
Подключить устанавливает QueryLane CLI в ~/.local/bin/querylane, если его ещё нет, и добавляет запись сервера querylane в настройки клиента. Остальные записи в этом файле остаются на месте. Для VS Code запись попадает в профиль VS Code по умолчанию.
Статус рядом с клиентом показывает Подключён, Не подключён, Нужно обновить или Нужен CLI. Для клиента со статусом Нужно обновить нажмите Обновить подключение. Если QueryLane предупреждает, что CLI указывает на старое расположение приложения, нажмите Обновить CLI.
Кнопки для отключения клиента в QueryLane нет. Чтобы отключить клиент, удалите запись querylane из его настроек.
Настроить другой клиент
Для клиента, которого нет в списке, но который запускает локальные stdio MCP-серверы:
- Откройте Настройки > CLI и MCP.
- Если QueryLane CLI не установлен, нажмите Установить CLI.
- В разделе Другой MCP-клиент нажмите Показать настройки.
- Скопируйте Команда и Аргументы или Пример конфигурации в настройки MCP вашего клиента.
- Перезапустите клиент или начните новую сессию.
Пример выглядит так:
{
"mcpServers": {
"querylane": {
"command": "/Users/you/.local/bin/querylane",
"args": ["mcp", "serve", "--profile", "main"]
}
}
}Клиент запускает сервер с транспортом stdio. --profile задаёт профиль QueryLane, в котором работает агент. Некоторые клиенты используют вместо mcpServers другой ключ верхнего уровня, например servers, mcp_servers, mcp или context_servers.
Что может агент
Агенту доступны все инструменты MCP-сервера QueryLane. С ними он может:
- читать задачи, подключения, схемы баз данных, запуски, результаты и плагины;
- создавать задачи и подключения, предлагать изменение задачи с diff, применять и откатывать его;
- тестировать шаги, запускать и отменять запуски, проверять результаты;
- выполнять SQL- и MongoDB-запросы через сохранённое подключение;
- экспортировать данные в CSV, JSON, JSONL или XLSX и строить графики;
- вызывать инструменты установленных плагинов;
- открывать задачу, шаг, подключение или раздел настроек в окне QueryLane.
В справочнике MCP-инструментов перечислены все инструменты и то, что каждый из них читает, меняет или запускает.
Разрешения
QueryLane не спрашивает разрешения, когда агент вызывает инструмент по MCP. Кнопки разрешений встроенного ассистента здесь не действуют. Спрашивать ли вас, решает клиент по своим настройкам разрешений.
Настройте эти разрешения до того, как дадите агенту задачу:
- разрешите инструменты чтения, если хотите, чтобы агент изучал данные сам;
- оставьте подтверждение для инструментов, которые что-то меняют или запускают, например
querylane_db_query_execute,querylane_change_applyилиquerylane_run_start.
Запрос выполняется от имени пользователя базы данных, указанного в подключении, поэтому агент может делать всё, что разрешено этому пользователю. Если агент должен только читать базу, подключайтесь к ней пользователем с правами только на чтение.
Агент получает реальные данные из запросов и результатов. Настройка Данные для AI действует только во встроенном ассистенте, см. Приватность данных.