使用自選供應商
助手支援這些供應商：GitHub Copilot、ChatGPT、Cursor、Claude、Claude Agent、OpenAI、OpenRouter、Gemini、xAI、Ollama、llama.cpp、MLX、OpenCode Zen與OpenAI-compatible。根據供應商，可貼上 API 金鑰、使用現有帳號登入，或在 Mac 上執行模型。TablePro 不經營自己的 AI 服務：請求直接傳送至供應商，新增前不傳送任何內容。
每則訊息包含連線中資料表的結構，受所設上限限制，以及編輯器中的查詢。結果列僅在 Settings > AI 中啟用後才傳送。每個連線也有 AI 政策，Never 會禁止助手和 MCP 用戶端存取。
檢閱、解釋、最佳化與修正
將游標放在陳述式中，選擇 Review with AI（⌥⇧⌘L）檢閱正確性、成本和安全性，Explain（⌘L）逐步解釋，或 Optimize（⌥⌘L）建議改寫或索引；查詢失敗時，錯誤橫幅提供 Fix with AI。請求包含陳述式所參照資料表的結構，陳述式本身不會執行。Apply to Editor 僅在確認後取代陳述式。
行內建議在輸入時顯示淡色文字，預設關閉。AI Rules 可為連線固定純文字說明，例如哪些欄位絕不能選取，並隨每則訊息傳送。
聊天模式與 Agent 模式
聊天有三種模式。預設 Ask 查閱結構，不執行任何內容。Edit 可執行查詢，Agent 也可執行 DROP、TRUNCATE 等破壞性陳述式。在新連線預設安全模式 Silent 下，Edit 和 Agent 的寫入無須詢問；從 Alert 到 Safe Mode (Full)，每次都等待 Run，Read-Only 則拒絕。破壞性陳述式始終等待點選，不能預先核准。
Agent 模式（⌥⇧⌘A）讓一個工作階段使用整個視窗，顯示該連線的工作階段、對話，以及建議和執行的 SQL。開啟期間，連線保持 Alert 或更嚴格等級，點選 Run 前不會執行寫入。這是提醒而非鎖定，一個快捷鍵就能關閉。工作階段儲存在此 Mac 上。
MCP 伺服器
內建 MCP 伺服器讓 AI 用戶端透過 TablePro 已儲存連線工作，從不看到密碼。它僅接聽 127.0.0.1，無遠端模式，在手動開啟或已設定用戶端啟動前保持關閉。
工具涵蓋連線、結構探索、資料讀寫、資料庫和物件、伺服器管理以及 App 自身的分頁和歷史，並根據即時結構建立提示和資源。每次呼叫都進入 Mac 上的活動記錄，陳述式記錄為摘要而非文字；用戶端執行的查詢也會出現在查詢歷史中。
連線用戶端
Settings > Integrations 提供 Claude Code、Claude Desktop、Cursor與Zed 的設定步驟和可複製片段。附帶的 tablepro-mcp 橋接也支援 Claude Desktop、Claude Code、Cursor、VS Code、Cline、Continue、Zed、Windsurf、Antigravity與Goose：它依需啟動 TablePro 並探索伺服器，因此用戶端設定無須連接埠或權杖。官方 Raycast 擴充功能則與 App 配對，由你在 Mac 上核准。
典型請求：讓用戶端找出使用同一電子郵件地址的使用者。它可呼叫 list_tables 和 describe_table，發現欄位名稱為 email_address，再透過已儲存連線執行一個 SELECT，無須將結構貼到聊天中。
用戶端允許執行的操作
每次呼叫都經過以下所有檢查，以最嚴格的限制為準。
- 權杖範圍：Read Only、Read & Write 或 Full Access，可限制為指定名稱的連線。橋接自動取得 Read & Write 權杖，因此使用橋接的用戶端無法執行破壞性陳述式。
- 每個連線的 External Clients：Blocked、Read Only（預設）或 Read & Write。被阻止的連線甚至不會列出。
- 連線核准：用戶端首次存取連線時，Mac 上的對話框會詢問。可選擇每次詢問、每個連線詢問一次，或不再詢問。
- AI 政策：設為 Never 的連線也拒絕 MCP 用戶端。
- 安全模式：寫入依連線等級確認，DROP 或 TRUNCATE 每次都需要 Full Access 權杖和你的核准。讀寫檔案或在伺服器上執行程式碼的陳述式會被拒絕。
外部 MCP 伺服器
也可反向使用：TablePro 的 AI 工作階段透過 Streamable HTTP 呼叫你執行的 MCP 伺服器工具，除非伺服器在此 Mac 上，否則必須使用 HTTPS。可選擇每個伺服器在哪些連線上提供。每次呼叫都顯示卡片並等待點選，不接受長期核准。伺服器位址和權杖僅儲存在此 Mac 上。
聊天之外的自動化
AppleScript 可在連線的 External Clients 等級和安全模式限制內連線、執行查詢和開啟資料表。tablepro:// 連結開啟連線、資料表或查詢分頁；連結中的查詢在確認後填入，從不自行執行。postgresql:// 等資料庫 URL 以連線形式開啟。
tablepro shell 指令在 App 中開啟這些 URL 和檔案，不從終端機執行查詢。官方 Raycast 擴充功能搜尋連線、資料表和查詢歷史，並透過已配對 App 執行查詢。
資料傳送到哪裡
提示、結構內容和所有附件傳送至所選供應商，適用你與該供應商之間的帳號條款。使用 Ollama、llama.cpp、MLX 或自行執行的 OpenAI 相容伺服器時，內容留在自己的機器上。TablePro 不接收任何內容，Mac App 的每日使用報告也不包含 AI 或 MCP 資訊。
新增 GitHub Copilot 時，向 GitHub 傳送遙測的選項預設開啟；可在 Copilot 設定處關閉。
iPhone 與 iPad 不提供
iPhone 與 iPad App 不提供 AI 助手、Agent 模式或 MCP 伺服器。本頁所有功能都在 Mac App 中。
支援範圍
| 能力 |
|---|
| 使用自選供應商的 AI 聊天Mac: 免費iPhone與iPad: 不支援 |
| AI 檢閱、解釋、最佳化與修正Mac: 免費iPhone與iPad: 不支援 |
| 行內建議與 AI 規則Mac: 免費iPhone與iPad: 不支援 |
| Agent 模式Mac: 免費iPhone與iPad: 不支援 |
| MCP 伺服器Mac: 免費iPhone與iPad: 不支援 |
| 外部 MCP 伺服器Mac: 免費iPhone與iPad: 不支援 |
AppleScript 與 tablepro shell 指令Mac: 免費iPhone與iPad: 不支援 |
| Raycast 擴充功能Mac: 免費iPhone與iPad: 不支援 |
值得了解的限制
- Cursor 無法呼叫 TablePro 工具，因此以 Cursor 為供應商時，Edit 和 Agent 不執行查詢。本機模型僅在模型支援時呼叫工具。
- Claude Agent 使用 Claude Code 登入，並透過必須開啟的 MCP 伺服器存取結構。它依賴 Claude Code，可能因 Claude Code 更新而失效。
- MCP 伺服器僅接聽 127.0.0.1。從其他機器存取需要自行轉送連接埠，並承擔由此暴露存取的責任。
- Mac App 沒有捷徑動作，可透過 AppleScript、連結或 MCP 伺服器自動化。
- Agent 工作階段和外部 MCP 伺服器僅保留在設定它們的 Mac 上，不同步。
