透过 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 证书是否有效。