Цю сторінку перекладено з англійської мови за допомогою ШІ. Якщо тексти відрізняються, еталоном є англійська версія.
Агенти ШІ
StackQL надає агентам ШІ той самий інтерфейс SQL, за допомогою якого люди виконують запити до хмарних сервісів і сервісів SaaS, створюють у них ресурси та керують ними. Агент з'ясовує, що надає провайдер, перевіряє запит перед виконанням, читає поточний стан за допомогою SELECT і змінює його за допомогою INSERT, UPDATE і DELETE, без файлу стану й без окремого SDK для кожної хмари.
Як підключаються агенти
- MCP через stdio для редакторів і настільних клієнтів, як-от Claude Desktop, Cursor і Continue. Клієнт сам запускає команду
stackql mcp --mcp.server.type=stdio. Див. Сервер MCP. - MCP через HTTP для автономних агентів і засобів автоматизації, що підключаються до постійно запущеного процесу
stackql mcpабоstackql srv, з автентифікацією за токеном bearer і необов'язковим TLS. - Вбудований MCP для скомпільованих застосунків: сервер працює в процесі застосунку на Go, Rust, Swift, Kotlin, .NET і Gleam. Див. Вбудований MCP.
- Мережевий протокол PostgreSQL через
stackql srvдля фреймворків агентів, блокнотів та інструментів BI, які вже працюють із Postgres.
Швидкий старт із Claude Desktop
Встановіть сервер з Anthropic Connector Directory (рекомендовано) або із завантажуваного MCP Bundle, або зареєструйте його вручну у файлі claude_desktop_config.json:
{
"mcpServers": {
"stackql": {
"command": "stackql",
"args": ["mcp", "--mcp.server.type=stdio"],
"env": {
"AWS_ACCESS_KEY_ID": "your-aws-access-key-id",
"AWS_SECRET_ACCESS_KEY": "your-aws-secret-access-key"
}
}
}
}
Вказуйте облікові дані лише для тих провайдерів, якими плануєте користуватися. Докладні вказівки, зокрема завантаження пакета та використання файлу облікових даних, наведено на сторінці Використання StackQL із Claude Desktop.
Що може агент
Сервер MCP надає невеликий типізований набір інструментів. Кожен інструмент повертає відформатоване відображення для моделі та структуроване корисне навантаження для програмних клієнтів.
- Виявлення:
list_providers,list_services,list_resources,list_methodsіdescribe_methodпроходять ієрархією провайдера й повертають вхідні параметри та вихідні поля кожної операції, тож обов'язкові параметриWHEREвідомі ще до написання запиту. - Перевірка й читання:
validate_select_queryвиконує синтаксичний аналіз і планування інструкціїSELECTбез її запуску;run_select_queryвиконує її. - Змінення:
run_mutation_queryвиконуєINSERT,UPDATE,REPLACEіDELETE;run_lifecycle_operationвиконує операції життєвого циклуEXEC. Обидва інструменти контролюються режимом сервера, описаним нижче. - Обслуговування:
server_info,list_registry,pull_providerіreload_credentials.
Повний довідник із вхідними даними, поведінкою контролю та прикладом промпту для кожного інструмента див. на сторінці Інструменти MCP.
Запобіжники
Режим сервера визначає контракт безпеки для всього сеансу:
| Режим | SELECT / метадані | INSERT / UPDATE / REPLACE | DELETE / EXEC |
|---|---|---|---|
read_only | дозволено | відхилено | відхилено |
safe (за замовчуванням) | дозволено | потрібне схвалення | потрібне схвалення |
delete_safe | дозволено | дозволено | потрібне схвалення |
full_access | дозволено | дозволено | дозволено |
"Потрібне схвалення" означає використання elicitation MCP: клієнти, що його підтримують (Claude Desktop, Cursor, Continue), показують користувачеві назву інструмента, клас запиту та SQL і чекають рішення, перш ніж щось буде виконано; клієнти, які не оголошують цієї можливості, отримують відмову. Кожен виклик інструмента записується в журнал аудиту, прослуховувачі HTTP вимагають токен bearer, якщо їх явно не відкрито за допомогою allow_unauthenticated, а облікові дані завантажуються із середовища або файлу dotenv, і значення секретів ніколи не повертаються клієнту. Докладніше див. Режими сервера, Автентифікація клієнтів HTTP і Журнал аудиту.
Наступні кроки
- Сервер MCP - режими розгортання, конфігурація, режими сервера, журнал аудиту та прапорці.
- Інструменти MCP - повний довідник інструментів із вхідними даними, контролем і прикладами промптів.
- Вбудований MCP - запуск сервера у вашому власному застосунку на Go, Rust, Swift, Kotlin, .NET або Gleam.
- Query Library - готовий до виконання SQL для типових питань експлуатації хмари, згрупований за провайдерами.
- Довідник для ШІ - концепції, практичні посібники, порівняння та усунення несправностей, написані для агентів і людей, які їх створюють.