摘要
从 NocoDB Cloud 或自托管实例读取 NocoDB 的工作区、数据库(base)、数据表和记录。提供 7 个只读工具,针对 v3 REST API 使用 xc-token API 密钥认证。
引导式设置
2 分钟将 NocoDB 连接到 ChatGPT
开始 AnythingMCP Cloud 免费试用，在引导式设置中连接 NocoDB，再把你的 MCP URL 添加到 ChatGPT。无需代码，也无需自行运行服务器。
无需信用卡 · 7 天试用 · 提供自托管方案
ChatGPT 插件目录中的 AnythingMCP 插件可在 AnythingMCP Cloud 上回答有关企业数据库的问题（PostgreSQL、MySQL、SQL Server、Oracle、SAP HANA、SQLite、MongoDB，只读）：打开插件页面 (在新标签页中打开)并点击 Install plugin。其他所有连接器都以自定义 MCP 服务器的方式添加到 ChatGPT，使用你的 AnythingMCP MCP URL。
试试这样问
NocoDB 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装?直接使用 cloud.anythingmcp.com。 登录后点击 Connectors → NocoDB,粘贴你的凭据,生成 MCP API 密钥即可。无需 Docker,无需
git clone,无需本地服务器。
NocoDB + ChatGPT
从 NocoDB Cloud 或自托管实例读取 NocoDB 的工作区、数据库(base)、数据表和记录。提供 7 个只读工具,针对 v3 REST API 使用 xc-token API 密钥认证。
前提条件
完整的设置说明已内置在连接器中(在应用内商店选择该连接器即可查看)。此连接器所需的环境变量如下:
NOCODB_URL, NOCODB_API_TOKEN
第 1 步 — 获取凭据
设置大约需要 2 分钟。你需要 NocoDB 的地址和一个 API 令牌。
- 在 NocoDB 中,打开 Team & Settings → API Tokens 并创建一个令牌。尽可能使用只读权限的令牌。将其复制到
NOCODB_API_TOKEN。 - 将
NOCODB_URL设置为 NocoDB 的根主机地址,末尾不要加斜杠:NocoDB Cloud 使用https://app.nocodb.com,或使用你自己的主机,例如https://nocodb.example.com。 - 安装连接器并运行
nocodb_list_workspaces:它会列出你的令牌可见的工作区。
令牌范围:NocoDB API 令牌作用于整个 NocoDB 实例,并通过 xc-token 请求头发送。若要限制 AI 可见的内容,请使用仅拥有所需权限的用户账号来创建令牌。
NocoDB 的运行位置:AnythingMCP Cloud 只能访问公网可达的 NocoDB 实例。如果你的 NocoDB 主机位于私有网络,或解析到私有地址空间,请在同一网络中自托管 AnythingMCP,并通过 SSRF_ALLOWED_HOSTS 放行该主机,否则出站防护会拦截请求。
可读取的内容:通过 NocoDB v3 API,可读取你的工作区、数据库(base)和数据表,数据表的列(含名称和类型)、记录、按数字行 ID 获取的单条记录,以及记录数量。ID 按链式关系传递:nocodb_list_workspaces 返回工作区 ID(以 w 开头),nocodb_list_bases 返回 base ID(以 p 开头),nocodb_list_tables 返回数据表 ID。在筛选或排序之前,AI 会调用 nocodb_get_table 获取准确的字段名。筛选使用 NocoDB 语法,例如 (Status,eq,Open)~and(Priority,eq,High),排序使用 JSON,例如 [{"field":"CreatedAt","direction":"desc"}]。
社区版:未获许可的自托管 NocoDB 可能只有一个隐式工作区,因此 nocodb_list_workspaces 可能返回一个条目或空列表。此时请直接使用已知的工作区 ID 调用 nocodb_list_bases,如果你已经知道 base ID,则直接查看数据表。
限制:pageSize 在 NocoDB Cloud 上会被静默限制为 100,在自托管实例上为 1000;在翻页遍历大型数据表之前,可用 nocodb_count_records 获取总数。NocoDB 允许每位用户每秒约 5 个请求,该用户的所有令牌共享这一额度。超出后会返回 HTTP 429,并附带 Retry-After 响应头。
该连接器为只读:不会创建、更新或删除记录、数据表、base 或工作区,也不使用视图(受套餐限制)、附件、Webhook,以及已弃用的 v1 和 v2 API。
第 2 步 — 安装适配器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
第 3 步 — 在 ChatGPT 中添加连接器
你的服务器 URL: 在 AnythingMCP 中,打开 MCP Servers → 此连接器所在的服务器,复制其 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都使用它。
ChatGPT 在其 Plugins 页面中将 MCP 服务器作为插件添加,支持网页端和付费套餐。不再需要开发者模式。在 Business 工作区中,只有管理员和所有者可以添加;在 Enterprise 和 Edu 中,管理员可以授予 Create plugins with MCPs 权限。
- 前往 chatgpt.com/plugins,点击 Add,然后选择 Add custom MCP server。
- 输入名称,例如 Name:
NocoDB。 - 在 Connection 下,输入 Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,并将 Authentication 保持为 OAuth。 - 选择 I understand and want to continue,然后点击 Create as a plugin。当 ChatGPT 提示时,登录 AnythingMCP 并允许访问。
- 从你的个人插件中安装新插件,然后在聊天中输入 @ 并选择它。
可用工具
| 工具 | 功能 |
|---|---|
nocodb_list_workspaces | 列出已配置的 API 令牌可见的所有工作区 |
nocodb_list_bases | 列出 NocoDB 工作区中的 base(项目) |
nocodb_list_tables | 列出 NocoDB base 中的数据表 |
nocodb_get_table | 获取某个 NocoDB 数据表的完整结构:包括列的名称、类型和选项 |
nocodb_list_records | 列出 NocoDB 数据表中的记录 |
nocodb_get_record | 按数字行 ID 获取 NocoDB 数据表中的单条记录 |
nocodb_count_records | 统计 NocoDB 数据表中的记录数,可选使用 where 子句进行筛选 |
常见问题
免费版 ChatGPT 套餐可以使用自定义 MCP 服务器吗? OpenAI 的文档中仅为付费套餐提供自定义 MCP 服务器;免费套餐不在其列表中。
后续步骤
这份指南对你有帮助吗?