翻譯頁面
本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。
如何搭配 Claude 使用 StackQL
Claude 透過 Model Context Protocol 連線到 StackQL:在 Claude Desktop(或 Claude Code)中將 stackql 註冊為 MCP 伺服器後,Claude 就能以自然語言驅動,對 StackQL 支援的每個 Provider 盤點及稽核雲端資源,並在您核准後修改這些資源。
步驟
- 安裝 StackQL,並確認它位於您的 PATH 中:
stackql --version
- 編輯 Claude Desktop 設定檔:
- Windows:
%APPDATA%\Claude\claude_desktop_config.json - macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Linux:
~/.config/Claude/claude_desktop_config.json
- 新增伺服器項目,包括您所使用 Provider 的憑證:
{
"mcpServers": {
"stackql": {
"command": "stackql",
"args": [
"mcp",
"--mcp.server.type=stdio",
"--mcp.config",
"{\"server\": {\"transport\": \"stdio\", \"mode\": \"safe\"}}"
],
"env": {
"AWS_ACCESS_KEY_ID": "your-aws-access-key-id",
"AWS_SECRET_ACCESS_KEY": "your-aws-secret-access-key",
"STACKQL_GITHUB_USERNAME": "your-github-username",
"STACKQL_GITHUB_PASSWORD": "your-github-personal-access-token"
}
}
}
}
只需包含您需要的 Provider(Azure 使用 AZURE_TENANT_ID/AZURE_CLIENT_ID/AZURE_CLIENT_SECRET,Google Cloud 使用 GOOGLE_CREDENTIALS,Databricks 使用 DATABRICKS_CLIENT_ID/DATABRICKS_CLIENT_SECRET)。切勿將此檔案提交至版本控制。
-
重新啟動 Claude Desktop。對話開始時,伺服器會自動啟動。
-
以自然語言提問。以下範例可直接對應到 StackQL 作業:
- 「列出 us-east-1 中所有具有公用 IP 位址的 EC2 執行個體」
- 「我們的 GitHub 組織中,哪些存放庫停用了分支保護?」
- 「在 us-west-2 建立名為 analytics-data 的 S3 儲存貯體」
對於讀取,Claude 會探索 schema 並立即執行 SELECT 陳述式。對於建立儲存貯體,safe 模式會在任何作業執行之前觸發核准要求,顯示確切的 INSERT。
控制 Claude 可以執行的作業
設定中的 mode 欄位就是契約:read_only 適用於僅限資源清單的助理,safe(預設)適用於需經核准的變更,delete_safe 允許建立與更新但管控刪除,full_access 僅適用於受信任的自動化。無論模式為何,Claude 進行的每次呼叫都會記錄在伺服器的 JSONL 稽核記錄中。
相關概念
- 如何搭配 AI 代理程式使用 StackQL:一般的 MCP 設定,包括 HTTP 傳輸方式
- StackQL MCP 架構:模式、徵詢(elicitation)與稽核的詳細說明
- 如何讓 StackQL 向 AWS 進行驗證:各 Provider 的憑證參考
- 什麼是代理式基礎架構?:更廣泛的模式
- StackQL vs 自訂 MCP 伺服器:為什麼一個通用伺服器勝過許多客製化伺服器