Справочник MCP-инструментов
В QueryLane 1.0.94 MCP-сервер предоставляет 57 инструментов. Агенту, подключённому по MCP, доступны все. Встроенный ассистент работает с теми же инструментами, кроме отмеченных Нет в столбце Ассистент.
Все инструменты, кроме querylane_profiles_list и querylane_connectors_list, принимают необязательный параметр profileId. Без него инструмент работает в профиле, с которым запущен сервер (--profile в настройках клиента).
Описания инструментов приводятся на английском, как их получает агент.
Что означает столбец «Действие»
- Читает: смотрит задачи, подключения, схемы, запуски, результаты или плагины и ничего не меняет.
- Изменяет: сохраняет или удаляет данные: задачу, подключение, историю запусков, сохранённый результат запроса или файл экспорта.
- Выполняет: запускает или останавливает работу за пределами профиля: запрос к базе, запуск шага или задачи, проверку подключения, инструмент плагина.
Читающие инструменты querylane_jobs_export и querylane_chart_render принимают необязательный filePath и тогда дополнительно сохраняют копию результата в этот файл.
Во встроенном ассистенте инструмент, который изменяет или выполняет, ждёт вашего разрешения, а читающие инструменты не могут записывать файлы: необязательный аргумент filePath у них убран. Подробнее в разделе Ассистент.
Если инструмент вызван из MCP-клиента, QueryLane разрешения не запрашивает: это определяют настройки доступа самого агента. Подробнее в разделе Подключение агента.
Профиль и возможности
| Инструмент | Что делает | Действие | Ассистент |
|---|---|---|---|
querylane_capabilities_get | Read the QueryLane agent API version, available operations, run scopes, execution policy, and the job authoring guide with step field contracts and ${variable}/${step_id} template rules | Читает | Да |
querylane_profiles_list | List QueryLane storage profiles available to this local client | Читает | Нет |
querylane_packages_list | List packages installed for JavaScript pipeline steps | Читает | Да |
Подключения
| Инструмент | Что делает | Действие | Ассистент |
|---|---|---|---|
querylane_connectors_list | List supported QueryLane connector variants, configuration fields, defaults, and adapter capabilities before creating a connection | Читает | Да |
querylane_connections_list | Find redacted source and target connections by name, role, or adapter type | Читает | Да |
querylane_connection_get | Read one redacted connection and its semantic revision before testing, updating, or deleting it | Читает | Да |
querylane_connection_validate | Validate a new connection document or a patch merged with a stored connection without connecting or saving | Читает | Да |
querylane_connection_test | Test a stored or unsaved connection using normal adapter semantics and return structured diagnostics without exposing credentials | Выполняет | Да |
querylane_connection_create | Create and atomically persist a validated source or target connection in the selected profile | Изменяет | Да |
querylane_connection_update | Atomically patch a connection when its semantic revision still matches; omitted secrets are preserved | Изменяет | Да |
querylane_connection_usage_get | List jobs, steps, outputs, saved queries, and workspace state that reference one connection | Читает | Да |
querylane_connection_delete | Delete a connection at an expected revision; referenced connections require force=true and return affected objects | Изменяет | Да |
querylane_connection_capabilities_get | Inspect adapter capabilities and optionally effective database privileges for one connection without returning credentials | Читает | Да |
База данных
| Инструмент | Что делает | Действие | Ассистент |
|---|---|---|---|
querylane_schema_get | Read or refresh database schema metadata for one configured source or target connection | Читает | Да |
querylane_db_explorer_list | List databases, schemas, tables, collections, views, indexes, and other children through a stored connection | Читает | Да |
querylane_db_object_get | Read structured metadata and DDL details for one database object through a stored connection | Читает | Да |
querylane_db_query_execute | Execute arbitrary SQL or MongoDB code using the configured database user and return bounded rows plus an optional result reference | Выполняет | Да |
querylane_db_result_page | Read a bounded page from a large ad-hoc database query result reference | Читает | Да |
querylane_db_result_dispose | Release a stored ad-hoc database query result reference | Изменяет | Нет |
Задачи и расписания
| Инструмент | Что делает | Действие | Ассистент |
|---|---|---|---|
querylane_jobs_list | Primary agent tool to find, search, list, or locate QueryLane jobs, tasks, and pipelines by natural-language terms | Читает | Да |
querylane_job_get | Read a redacted job definition and its content revision before editing or running it | Читает | Да |
querylane_job_create | Create and validate a complete QueryLane job in the selected profile | Изменяет | Да |
querylane_jobs_export | Export jobs to a portable package for sharing without git: steps, variables with secret values removed, connection hints without credentials, and required JavaScript packages | Читает | Нет |
querylane_jobs_import | Import jobs from a package made by querylane_jobs_export | Изменяет | Нет |
querylane_job_delete | Delete a local job, optionally asserting the revision previously read by the agent | Изменяет | Да |
querylane_job_revisions_list | List durable job revision snapshots available for inspection or revert | Читает | Да |
querylane_job_validate | Validate a stored job or an supplied candidate against step, dependency, and connection contracts | Читает | Да |
querylane_schedules_list | Read the schedules of the profile: their cron expression, whether macOS runs them, the next run, and why a schedule is not running | Читает | Да |
Изменения задач
| Инструмент | Что делает | Действие | Ассистент |
|---|---|---|---|
querylane_change_propose | Build an immutable semantic job change, validate it, and return its diff without changing the job | Читает | Да |
querylane_change_get | Read a proposed change, redacted candidate, semantic diff, validation, and application status | Читает | Да |
querylane_change_apply | Atomically apply an already validated change if the job revision still matches its base revision | Изменяет | Да |
querylane_change_revert | Restore a job to a known durable revision while checking the current revision | Изменяет | Да |
Шаги, запуски и результаты
| Инструмент | Что делает | Действие | Ассистент |
|---|---|---|---|
querylane_step_preview | Inspect a step and its resolved execution plan without executing database, HTTP, file, or JavaScript effects | Читает | Да |
querylane_step_test | Execute a step using normal QueryLane semantics, including dependencies by default, and optionally wait for completion | Выполняет | Да |
querylane_runs_list | List unified durable UI, CLI, MCP, and scheduled pipeline executions and filter them by job, origin, or status | Читает | Да |
querylane_run_get | Read the current durable state and receipt of one pipeline run | Читает | Да |
querylane_run_diagnose | Return a compact deterministic diagnosis with failed step, reason code, details, statuses, and result handle | Читает | Да |
querylane_run_plan | Resolve which steps and connections a requested run scope will execute and whether a baseline is required | Читает | Да |
querylane_run_start | Start a durable asynchronous pipeline run with normal local-client execution permissions | Выполняет | Да |
querylane_run_wait | Wait for a durable run to finish or until a bounded timeout expires | Читает | Да |
querylane_run_cancel | Request cancellation of a queued or running local pipeline execution | Выполняет | Да |
querylane_runs_clear | Clear durable execution history for one job or the selected profile | Изменяет | Нет |
querylane_result_sample | Read a bounded sample from the final output or a selected step output of a durable run | Читает | Да |
querylane_result_check | Evaluate declarative row-count, field-presence, or non-null assertions against a run result | Читает | Да |
querylane_chart_render | Render one chart of a chart step from a finished run to PNG (returned as an image you can look at) or SVG, to check the drawing after querylane_step_test or querylane_run_wait | Читает | Да |
querylane_run_artifact_get | Read an image a run left behind, such as the screenshot of a failed plugin step | Читает | Да |
Экспорт данных
| Инструмент | Что делает | Действие | Ассистент |
|---|---|---|---|
querylane_exports_list | List durable data export operations and filter them by status, connection, or pipeline run | Читает | Да |
querylane_export_start | Export exactly one source—database object, query result reference, pipeline run result, step result, or supplied rows—to CSV, JSON, JSONL, or XLSX | Изменяет | Да |
querylane_export_get | Read current status, progress, output metadata, or structured failure for one export | Читает | Да |
querylane_export_wait | Wait for a durable export to finish or until a bounded timeout expires | Читает | Да |
querylane_export_cancel | Cancel a queued or running data export and remove its incomplete atomic output | Изменяет | Нет |
Плагины
| Инструмент | Что делает | Действие | Ассистент |
|---|---|---|---|
querylane_plugins_list | List installed QueryLane plugins and plugins available in the catalog, with their status (ready, needsPrepare, disabled, available) | Читает | Да |
querylane_plugin_get | Read one installed plugin: its step types and code language, settings schema, the profile presets, the AI tools it offers and its authoring guide for writing step code | Читает | Да |
querylane_plugin_tool_call | Call an AI tool of an installed plugin, for example open a page and look at it with the browser plugin | Выполняет | Да |
querylane_plugin_session_close | Close a plugin tool session and release its resources, such as an open browser page | Читает | Да |
Приложение
| Инструмент | Что делает | Действие | Ассистент |
|---|---|---|---|
querylane_ui_link_get | Create a querylane:// link that opens a job, exact step, connection, or settings section in the QueryLane desktop app | Читает | Нет |
querylane_ui_open | Open and navigate the QueryLane desktop app directly to a job, exact pipeline step, connection, or settings section | Читает | Да |