# 如何搭配 Claude 使用 StackQL

> 在 Claude Desktop 或 Claude Code 中將 StackQL 註冊為 MCP 伺服器，讓 Claude 以自然語言查詢及管理 AWS、Azure、Google Cloud、GitHub 等 Provider 的雲端基礎架構。

Source: https://stackql.io/zh-hant/ai/how-tos/use-stackql-with-claude

Claude 透過 Model Context Protocol 連線到 StackQL：在 Claude Desktop（或 Claude Code）中將 `stackql` 註冊為 MCP 伺服器後，Claude 就能以自然語言驅動，對 StackQL 支援的每個 Provider 盤點及稽核雲端資源，並在您核准後修改這些資源。

## 步驟

1. **安裝 StackQL**，並確認它位於您的 PATH 中：

```bash
stackql --version
```

2. **編輯 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`

3. **新增伺服器項目**，包括您所使用 Provider 的憑證：

```json
{
  "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`）。切勿將此檔案提交至版本控制。

4. **重新啟動 Claude Desktop**。對話開始時，伺服器會自動啟動。

5. **以自然語言提問**。以下範例可直接對應到 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](/ai/how-tos/use-stackql-with-ai-agents)：一般的 MCP 設定，包括 HTTP 傳輸方式
- [StackQL MCP 架構](/ai/architecture/stackql-mcp-architecture)：模式、徵詢（elicitation）與稽核的詳細說明
- [如何讓 StackQL 向 AWS 進行驗證](/ai/how-tos/authenticate-stackql-to-aws)：各 Provider 的憑證參考
- [什麼是代理式基礎架構？](/ai/canonical-definitions/what-is-agentic-infrastructure)：更廣泛的模式
- [StackQL vs 自訂 MCP 伺服器](/ai/comparisons/stackql-vs-custom-mcp-servers)：為什麼一個通用伺服器勝過許多客製化伺服器
