金数据 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" | base64Server URL
所有客户端配置的核心都是同一个 Server URL:
https://jinshuju.net/mcp在 Claude Code 中配置
OAuth(项目级):
claude mcp add jinshuju --transport http https://jinshuju.net/mcpOAuth(用户级,跨项目可用):
claude mcp add jinshuju -s user --transport http https://jinshuju.net/mcpAPI 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 URL | https://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 助手里发送"列出我的金数据表单"。如果报错:
- 确认 Server URL 是
https://jinshuju.net/mcp,无尾部斜杠或多余路径; - 如果用 API Key,确认 Base64 编码正确,且 Key 未被禁用;
- 如果用 OAuth,重新触发一次授权流程;
- 检查所在客户端的 MCP 配置文件路径与 JSON 格式是否正确。
Q:MCP 支持哪些字段类型 / 是否支持附件、图片、地理位置?
A:MCP 创建表单时支持的字段类型见上方表格。MCP 和 API v1 均已支持向「收集附件」字段上传附件:先调用上传附件接口获取附件 ID,再在新增/修改数据时引用该 ID 即可。详见开放平台文档:上传附件接口。其他字段类型(如地理位置)暂不支持通过 MCP/API 写入,如需扩展能力,请通过帮助中心或客户经理反馈需求。
相关链接
- 金数据 MCP Server 总览:https://open.jinshuju.net/mcp
- 快速接入:https://open.jinshuju.net/mcp/configuration/
- 场景案例:https://open.jinshuju.net/mcp/use_cases/
- OAuth 协议细节:https://open.jinshuju.net/mcp/oauth/
- 表单设置 Schema:https://open.jinshuju.net/api_v1/schemas/form_setting