透過 MCP 讀取 Ragic 資料

你可以透過 MCP（Model Context Protocol），在授權後讓第三方 AI 工具讀取你自己 Ragic 帳號裡的資料。連接完成後，就能直接請 AI 幫你搜尋資料、整理內容、比對表單記錄，或回答跟 Ragic 資料有關的問題。

注意：目前 Ragic MCP 只提供資料讀取功能。AI 可以查詢你有權限看到的資料，但無法新增、修改或刪除資料。

功能應用

連接完成後，AI 可以協助你：

1. 查詢你能存取的資料庫帳號、表單與欄位。

2. 用關鍵字搜尋資料，不必事先知道資料位於哪張表單。

3. 瀏覽表單列表頁資料，或讀取單筆完整記錄，包含子表格、留言、欄位註解與 email 對話紀錄。

4. 依建立者、資料管理者或建立日期篩選資料。

MCP 資料讀取範圍

Ragic MCP 會依照你在 Ragic 中原本擁有的存取權限讀取資料：

1. 只讀取並回傳你有權限查看的資料庫帳號、表單與欄位。

2. 若你在某個資料庫帳號中屬於外部使用者，MCP 不會讀取該帳號的資料。

3. Ragic 系統內部設定表單不開放透過 MCP 讀取。

連接方法

連接前準備

1. 確認你的資料庫帳號：你需要先知道要查詢哪一個 Ragic 資料庫帳號，可以從網址判斷。例如你的資料庫首頁網址是：

https://www.ragic.com/mycompany

其中 mycompany 就是你的資料庫帳號名稱。連接完成後，可以直接對 AI 說：「在 mycompany 這個帳號裡，幫我找……」。如果不確定資料庫帳號名稱，也可以請 AI「列出我可以存取的 Ragic 資料庫帳號」。

2. 確認連接網址：如果你使用 Ragic 雲端版，請填入：

https://www.ragic.com/api/mcp

如果你使用的是私有主機版，請先向管理員確認連接網址，通常會是：

https://你的主機網址/api/mcp

在 claude.ai 連接

在 claude.ai 中，可以透過自訂連接器（Connectors）加入 Ragic MCP。

步驟：

1. 開啟 claude.ai 的「Customize」設定頁面。

2. 新增一個自訂連接器（Custom Connector）。

3. 名稱填入「Ragic」。

4. 連接網址填入：https://www.ragic.com/api/mcp

備註：如果你使用的是私有主機，請將連接網址換成管理員提供的網址。

5. 驗證方式選擇 OAuth，或依畫面提示使用預設設定。

6. 儲存後，依照畫面指示登入 Ragic 並完成授權。

7. 回到對話畫面，啟用 Ragic 連接器後即可開始詢問資料。

在 ChatGPT 連接

在 chatgpt.com 中，可以透過開發者模式建立 Ragic 連接器。如果你的帳號或組織沒有顯示相關設定，請先確認你的方案，或詢問組織管理員。

步驟：

1. 開啟 ChatGPT 設定頁面。

2. 進入應用程式的進階設定，開啟「Developer mode（開發者模式）」。

3. 回到應用程式設定，點擊「建立應用程式」。

4. 名稱填入「Ragic」。

5. 連接網址填入：https://www.ragic.com/api/mcp

備註：如果你使用的是私有主機，請將連接網址換成管理員提供的網址。

6. 驗證方式選擇 OAuth。

7. 儲存後，依照畫面指示登入 Ragic 並完成授權。

8. 在對話中選用這個 Ragic 應用程式後，就可以請 ChatGPT 讀取你的 Ragic 資料。

注意：ChatGPT 開發者模式的入口與可用方案可能會依 OpenAI 介面調整。如果你看不到開發者模式或建立應用程式的選項，請先確認帳號方案與組織設定。

進階設定：在 Claude Code / Codex 連接

如果你使用 Claude Code 或 Codex 這類開發者工具，也可以連接 Ragic MCP，這部分適合熟悉命令列或設定檔的使用者。

雲端版

若你使用 Ragic 雲端版，可以直接在 terminal 新增遠端 MCP 伺服器。

Claude Code：

claude mcp add --transport http --scope user ragic https://www.ragic.com/api/mcp

新增完成後，在 Claude Code 的互動視窗中輸入：

/mcp

依照畫面指示完成 Ragic 登入與授權。

Codex：設定會寫入使用者層級的 ~/.codex/config.toml：

codex mcp add ragic --url https://www.ragic.com/api/mcp

接著依照 Codex 的登入流程完成授權。

私有主機版

如果你使用私有主機版，且沒有受信任的 CA 憑證，或使用環境只支援本機指令形式的 MCP 連接，需要改用 mcp-remote 連接，這時才需要先安裝 Node.js、npm 與 npx。

如果電腦尚未安裝 npm 或 npx，請先到 Node.js 官方網站下載並安裝 LTS 版本，安裝時會一併安裝 npm。安裝完成後，重新開啟終端機，執行以下指令確認版本：

node -v
npm -v
npx -v

三個指令都能顯示版本號後，即可使用下方的設定。執行 npx -y mcp-remote 時，系統會自動取得 mcp-remote，不需要另外安裝。

Claude Code：可以在專案的 .mcp.json 中改用 mcp-remote：

claude mcp add ragic --scope user -e NODE_TLS_REJECT_UNAUTHORIZED=0 -- npx -y mcp-remote https://localhost/api/mcp --allow-http

請將 https://localhost/api/mcp 換成你實際的 Ragic MCP 連接網址。

Codex：可以改用 mcp-remote 新增：

codex mcp add ragic --env NODE_TLS_REJECT_UNAUTHORIZED=0 -- npx -y mcp-remote https://localhost/api/mcp --allow-http

請將 https://localhost/api/mcp 換成你實際的 Ragic MCP 連接網址。

注意：mcp-remote 沒有登出功能，如果需要切換帳號或重新登入，請先手動刪除本機的認證資料，再重新啟動 Claude Code 或 Codex，就會重新導向 Ragic 登入流程。

Mac：

rm -rf ~/.mcp-auth

Windows：

1. PowerShell：

Remove-Item "$HOME\.mcp-auth" -Recurse -Force

2. cmd：

rmdir /s /q "%USERPROFILE%\.mcp-auth"

私有主機的連線設定

如果你的 Ragic 是私有主機版，請先向管理員確認：

• Ragic MCP 是否已啟用，啟用方式請參考這裡。
• 正確的連接網址。
• 該網址是否可由你使用的 AI 服務連到。
• HTTPS 憑證是否有效。

如果你使用 claude.ai 或 chatgpt.com 這類網頁版 AI，實際上是由雲端服務連線到你的 Ragic MCP 連接網址，並非由瀏覽器直接呼叫 MCP endpoint，因此不需要另外設定允許的瀏覽器來源。Ragic 雲端版不需要額外設定；私有主機則需要確認該網址可以被外部服務連接到。

AI 提問範例

你可以像平常提問一樣使用 Ragic MCP，以下列出幾種常見的問法。

1. 先確認資料庫帳號

• 「列出我可以存取的 Ragic 資料庫帳號。」
• 「我有哪些 Ragic 帳號可以查？」

2. 查看表單

• 「在 mycompany 裡有哪些表單？」
• 「在 mycompany 裡，客戶表有哪些欄位？」

3. 搜尋資料

• 「幫我在 mycompany 裡搜尋『年度合約』。」
• 「找出包含『退貨』的記錄。」
• 「我不確定資料在哪張表單，幫我找跟台北物流有關的資料。」

4. 讀取與整理記錄

• 「列出 mycompany 客戶表前 20 筆資料。」
• 「把這幾筆訂單的完整內容整理成摘要。」
• 「幫我比較這三筆客戶記錄的差異。」

5. 依人員或日期查詢

• 「列出 jane@example.com 建立的訂單。」
• 「找出王小明負責管理的客戶。」
• 「列出 2026 年 1 月建立的記錄。」

備註：如果你只記得人名、不確定 email，可以先請 AI 幫你找出對應的人員，再用找到的 email 進一步查詢資料。

常見問題

1. 第一次連接時要怎麼登入？

第一次連接時，AI 服務會導引你進入 Ragic 登入流程。請使用你自己的 Ragic 帳號登入；如果你的公司支援 Google 登入，也可以用 Google 帳號登入。完成後，AI 才能依照你的權限讀取資料。

2. AI 會不會修改我的資料？

不會。目前 Ragic MCP 只提供資料讀取功能，AI 可以查詢你有權限看到的資料，但無法新增、修改或刪除資料。未來如果開放其他類型的功能，我們會另行說明授權方式與使用限制。

3. 找不到資料該怎麼辦？

請先確認以下幾點：

• 資料庫帳號名稱是否正確。
• 你在 Ragic 中是否原本就能看到該表單或資料。
• 搜尋關鍵字是否太過限定。
• 日期或人員條件是否設定得太嚴格。

如果不確定資料位於哪張表單，可以先請 AI 用關鍵字搜尋看看。

4. 為什麼有些欄位沒有出現？

MCP 會依照你在 Ragic 中的權限來讀取資料。如果你原本就看不到某個欄位，AI 也同樣看不到該欄位的內容。

5. 網頁版 AI 連不上私有主機該怎麼辦？

請聯絡管理員確認以下項目：

• 連接網址是否正確。
• 私有主機是否可以被外部服務連接到。
• HTTPS 憑證是否有效。