将 NocoDB MCP 连接到 Claude：查看数据表与记录

💡 无需安装?直接使用 cloud.anythingmcp.com。 登录后,点击 Connectors → NocoDB,粘贴你的凭据,生成 MCP API 密钥即可。无需 Docker,无需 git clone,也无需本地服务器。

NocoDB + Claude

从 NocoDB Cloud 或自托管实例读取 NocoDB 的工作区、数据库(base)、数据表和记录。提供 7 个只读工具,使用 xc-token API 密钥对 v3 REST API 进行身份验证。

前提条件

完整的设置说明已内置在连接器中(在应用内商店选择该连接器即可查看)。此连接器所需的环境变量如下:

NOCODB_URL, NOCODB_API_TOKEN

步骤 1 — 获取凭据

设置大约需要 2 分钟。你需要 NocoDB 的地址和一个 API 令牌。

1. 在 NocoDB 中,打开 Team & Settings → API Tokens 并创建一个令牌。请尽可能使用只读权限的令牌。将其复制到 NOCODB_API_TOKEN。
2. 将 NOCODB_URL 设置为 NocoDB 的根主机地址,末尾不要带斜杠:NocoDB Cloud 使用 https://app.nocodb.com,或者使用你自己的主机,例如 https://nocodb.example.com。
3. 安装连接器并运行 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 — 在 Claude 中添加连接器

**你的服务器 URL:**在 AnythingMCP 中,打开 MCP Servers → 此连接器所在的服务器,复制其 URL(https://cloud.anythingmcp.com/mcp/…)。本指南中出现 YOUR_SERVER_ID 的地方都使用它。

推荐方式 — 可在 claude.ai 网页版中使用,无需编辑任何配置文件。

1. 在 Claude 中,打开 Customize → Connectors。
2. 点击 +,然后点击 Add custom connector。
3. 输入名称,例如 NocoDB,以及远程 MCP 服务器 URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,然后点击 Add。
4. 点击 Connect 并登录 AnythingMCP(OAuth)以授予访问权限。

下面列出的所有工具都会出现在你的聊天中,直接开始输入提示词即可。

可用工具

常见问题

除了 Claude Desktop,它也能用于 Claude Code 吗? 可以 — 将两者都指向 https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID 即可。

后续步骤

• 连接器介绍页
• 连接到 ChatGPT