金数据 MCP:让 AI 帮你管理表单和数据

通过 MCP,你可以在 Claude、Cursor、Windsurf 等支持 MCP 的客户端中,用自然语言操作金数据——创建和编辑表单、查询和修改数据、调整表单设置(Webhook、提交限制等)、查看账户用量和账单,无需打开网页后台。

金数据已支持 Model Context Protocol(MCP),这是由 Anthropic 提出的开放标准协议,用于连接 AI 助手与外部工具。

通过金数据 MCP,你可以在 Claude、Cursor、Windsurf、Claude Code、OpenClaw 等支持 MCP 的客户端中,用自然语言直接操作金数据:创建表单、查询和修改数据、调整表单设置、查看账户与账单,无需打开网页后台。

适合谁用:

  • 希望让 AI 直接读写金数据的产品、销售、运营、管理员;
  • 希望把金数据接入 AI Agent 工作流的开发者;
  • 希望团队成员不进后台也能完成常见数据操作的企业。

适用场景

1. 创建活动报名表

适用于市场活动、线下沙龙、课程报名。

示例提示词:"帮我创建一个『2026 春季产品发布会』报名表,需要收集姓名、手机号、公司、职位、是否参加晚宴。"

AI 助手会创建新表单、添加字段、返回填写链接,并按需调整配置。

2. 查询和筛选表单数据

适用于销售线索、报名名单、客户反馈、问卷结果。

示例提示词:"查一下这个报名表里,最近 7 天提交、公司字段包含『科技』的记录有多少条。"

3. 批量更新跟进状态

适用于线索跟进、工单处理、活动邀约。

示例提示词:"把这个表单里『跟进状态』为『未联系』,并且城市是上海的记录,全部更新为『待电话跟进』。"

建议在批量修改或删除前,让 AI 先展示命中记录并等待你确认,再执行写操作。

4. 生成运营统计

适用于日报、周报、活动复盘、渠道分析。

示例提示词:"帮我统计这个报名表各渠道的报名人数,并按渠道转化效果排序。"

5. 查看账户和用量

适用于企业管理员了解账户状态。

示例提示词:"查一下我们当前金数据套餐什么时候到期,还剩多少短信额度。"

如何接入金数据 MCP

选择鉴权方式

金数据 MCP 支持两种鉴权方式:

方式适用场景凭证管理
OAuth 2.0(推荐)Claude、Cursor、Windsurf 等支持 OAuth 的 AI 工具客户端自动完成授权,无需手动保存凭证
API Key / Secret企业内部集成、自建 Agent 工作流需在金数据后台生成 API Key 与 Secret,并 Base64 编码后作为请求头

API Key 方式的 Base64 编码命令:

echo -n "api_key:api_secret" | base64

Server URL

所有客户端配置的核心都是同一个 Server URL:

https://jinshuju.net/mcp

在 Claude Code 中配置

OAuth(项目级):

claude mcp add jinshuju --transport http https://jinshuju.net/mcp

OAuth(用户级,跨项目可用):

claude mcp add jinshuju -s user --transport http https://jinshuju.net/mcp

API Key(项目级):

claude mcp add jinshuju --transport http https://jinshuju.net/mcp \
  --header "Authorization: Basic BASE64_ENCODED_CREDENTIALS"

API Key(用户级):

claude mcp add jinshuju -s user --transport http https://jinshuju.net/mcp \
  --header "Authorization: Basic BASE64_ENCODED_CREDENTIALS"

在 Cursor 中配置

OAuth:

{
  "mcpServers": {
    "jinshuju": {
      "url": "https://jinshuju.net/mcp"
    }
  }
}

API Key:

{
  "mcpServers": {
    "jinshuju": {
      "url": "https://jinshuju.net/mcp",
      "headers": {
        "Authorization": "Basic BASE64_ENCODED_CREDENTIALS"
      }
    }
  }
}

在 Windsurf 中配置

配置文件路径:~/.codeium/windsurf/mcp_config.json

OAuth:

{
  "mcpServers": {
    "jinshuju": {
      "serverUrl": "https://jinshuju.net/mcp"
    }
  }
}

API Key:

{
  "mcpServers": {
    "jinshuju": {
      "serverUrl": "https://jinshuju.net/mcp",
      "headers": {
        "Authorization": "Basic BASE64_ENCODED_CREDENTIALS"
      }
    }
  }
}

在 OpenClaw 中配置

直接把金数据 MCP 接入页面(https://open.jinshuju.net/mcp)的网页内容发送给模型,OpenClaw 会通过内置 mcporter skill 自动完成安装。

在其他支持 MCP 的工具中配置

ChatGPT、Cline、Continue 等遵循标准 MCP 协议的工具,按其自身配置规范填入下列参数:

配置项
MCP Server URLhttps://jinshuju.net/mcp
OAuth 鉴权由客户端自动处理授权流程
API Key 鉴权Authorization: Basic BASE64(api_key:api_secret)

验证连接

接入完成后,在 AI 助手中尝试以下任意一条指令验证连接是否成功:

  • "列出我的金数据表单"
  • "查看某个表单的数据"
  • "创建一个活动报名表"
  • "查一下账户套餐和用量"

金数据 MCP 支持的能力

金数据 MCP 当前提供以下五类能力,AI 助手会根据你的提问自动调用对应工具。

管理表单

可让 AI 完成的操作:查询表单列表、获取表单详情、创建新表单、编辑表单结构与设置。

典型提问:

  • "我有哪些表单?"
  • "帮我看看 XX 表单收集了哪些字段。"
  • "新建一个客户反馈表,包含姓名、邮箱、反馈内容。"
  • "把 XX 表单的『手机号』字段改成必填。"

配置表单设置

可让 AI 调整的设置项:提交后行为、发布 / 停止收集、提交限制、访问密码 / 可见人群、Webhook

典型提问:

  • "把 XX 表单设置成提交后跳转到我们官网首页。"
  • "在本周五 18:00 自动停止收集。"
  • "限制每个 IP 每天只能提交一次。"
  • "给这个表单加访问密码:spring2026。"
  • "把新提交的数据 Webhook 推到 https://example.com/hook。"

完整的表单设置字段、取值范围与校验规则见开放平台 《表单设置 Schema》

管理数据

可让 AI 完成的操作:查询数据列表、获取单条数据、新增数据、修改数据、删除数据。

典型提问:

  • "把 XX 报名表里最近 7 天的数据列出来。"
  • "看一下编号 12345 那条记录的完整内容。"
  • "往客户表里新建一条记录:姓名张三、电话 138……。"
  • "把跟进状态全部从『未联系』改成『待电话跟进』。"
  • "删掉测试时提交的那几条记录。"

涉及修改和删除时,强烈建议让 AI 先列出命中记录,由你确认后再执行写操作。

查看账户与团队

可让 AI 查询的信息:当前用户信息、企业账户信息(套餐 / 用量 / 到期时间)、企业成员列表。

典型提问:

  • "我现在登录的是哪个金数据账户?"
  • "我们企业的套餐是哪一档?什么时候到期?"
  • "本月还剩多少短信额度 / 表单数 / 数据量?"
  • "我们企业有哪些成员?"

查看账单

可让 AI 查询的信息:发票信息、付款记录。

典型提问:

  • "把今年开过的发票列一下。"
  • "查最近三笔付款记录。"

MCP 创建表单时支持的字段类型

类型说明
TextField单行文本
TextArea多行文本
NumberField数字
EmailField邮箱
MobileField手机号
IdCardField身份证号
NameField姓名
RadioButton单选按钮
CheckBox复选框
DropDown下拉选择
DateTimeField日期时间
RatingField评分(支持 3/5/10 级)
TableField表格(支持多列、嵌套选项)

OAuth 权限范围

接入支持 OAuth 的 AI 工具时,授权过程中客户端会按需申请以下权限范围(scope):

Scope对应能力
public公开信息
profile当前用户信息
forms表单读写(创建、编辑、查询)
read_entries读取表单数据
write_entries新增、修改、删除表单数据
form_setting表单设置(发布、限制、Webhook 等)
read_contacts企业成员信息
users账户相关信息

完整 OAuth 协议细节(动态客户端注册、PKCE、Token 端点等)仅 MCP 客户端开发者需要了解,见开放平台 《OAuth 协议细节》

常见问题

Q:金数据 MCP 支持哪些 AI 客户端?

A:已验证 Claude、Claude Code、Cursor、Windsurf、OpenClaw。任何遵循 MCP 标准协议的工具(ChatGPT、Cline、Continue 等)都可以按统一参数接入。

Q:OAuth 和 API Key 应该选哪个?

A:日常使用推荐 OAuth,由客户端自动完成授权与凭证管理,更安全也更省事。如果是企业内部自动化集成或自建 Agent 工作流,可选 API Key。

Q:API Key 在哪里生成?

A:进入金数据后台,在账户设置中的「开放接口 / API」相关入口创建 API Key 和 Secret。将两者用 : 拼接后做 Base64 编码(命令见「选择鉴权方式」一节),作为 Authorization: Basic ... 请求头使用。若找不到入口,请联系你的账户管理员或金数据客户经理。

Q:AI 会不会误删我的数据?

A:MCP 协议本身不限制写操作。涉及批量修改和删除时,请要求 AI 先列出命中记录、确认无误后再执行;也可以通过企业账户权限设置限定 API Key 可访问的表单范围。

Q:连接失败怎么排查?

A:先在 AI 助手里发送"列出我的金数据表单"。如果报错:

  1. 确认 Server URL 是 https://jinshuju.net/mcp,无尾部斜杠或多余路径;
  2. 如果用 API Key,确认 Base64 编码正确,且 Key 未被禁用;
  3. 如果用 OAuth,重新触发一次授权流程;
  4. 检查所在客户端的 MCP 配置文件路径与 JSON 格式是否正确。

Q:MCP 支持哪些字段类型 / 是否支持附件、图片、地理位置?

A:MCP 创建表单时支持的字段类型见上方表格。MCP 和 API v1 均已支持向「收集附件」字段上传附件:先调用上传附件接口获取附件 ID,再在新增/修改数据时引用该 ID 即可。详见开放平台文档:上传附件接口。其他字段类型(如地理位置)暂不支持通过 MCP/API 写入,如需扩展能力,请通过帮助中心或客户经理反馈需求。

相关链接

本页内容