> ## Documentation Index
> Fetch the complete documentation index at: https://jinshuju-20a27453.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# 用自然语言操作表单：金数据 MCP 入门指南
> 告别繁琐的表单后台操作！本文详细介绍金数据 MCP 协议的使用教程。只需通过自然语言，即可在 Claude、OpenClaw 或 Qclaw 中实现表单查询、数据录入与修改。涵盖 API 配置步骤、OAuth 授权流程及 HR/销售/办公自动化等三大实战场景，让 AI 成为你真正的数字化助理
> 不写代码，不用打开后台，对着 AI 说一句话，就能创建表单、查询数据、修改记录。这不是未来，是现在已经可以做到的事。
## 先搞清楚：MCP 是什么？
很多人第一次听到 MCP，觉得是个很技术的词。其实理解它不需要任何编程背景。
**一句话解释：MCP 是 AI 助手和外部工具之间的「通用接口」。**
你可以把它想象成一根数据线。手机要充电、传照片、连电脑，用同一根 USB-C 就够了，不需要为每个场景换一根线。MCP 做的事情一样——让 AI 助手可以通过同一套标准，连接任何支持这个协议的工具。
金数据已经支持 MCP 协议。这意味着，你可以在 Claude、OpenClaw、Qclaw 这类 AI 客户端里，直接操作你的金数据表单和数据，全程用自然语言。
## 金数据 MCP 能做什么？
配置完成后，你可以直接对 AI 说：
* **「帮我列出所有表单」** → AI 会返回你账户下的表单列表
* **「查一下『用户反馈』表单最近 10 条数据」** → 直接返回结果，无需登录后台
* **「在『活动报名』表单里新增一条记录，姓名张三，手机 138xxxx」** → 数据写入完成
* **「把表单 ID 为 xxx 的第 5 条数据的备注字段改成『已处理』」** → 修改生效
目前金数据 MCP Server 支持的操作覆盖三大类：
| 功能类别 | 支持的操作 |
| - | - |
| 管理表单 | 查询表单列表、获取表单详情、创建新表单 |
| 管理数据 | 查询数据列表、获取单条数据、新增/修改/删除数据 |
| 账单查询 | 查询发票信息、查询付款记录 |
## 开始之前：了解套餐要求
金数据 MCP 对所有套餐用户开放，包括免费版。配置时支持两种认证方式：
* **OAuth 方式**：所有用户均可使用，免费。
* **API Key 方式**：需要企业版套餐，才能在金数据后台生成 API Key。
如果你是免费版或低套餐用户，选择 OAuth 方式即可正常使用 MCP 的全部功能。
## 三种工具，选适合你的那个
金数据 MCP 支持多种客户端接入，根据你的使用习惯选一个就行。
**Claude Desktop**：Anthropic 官方客户端，对话体验最流畅，适合已经在用 Claude 的用户。
**OpenClaw**（开源，开发者友好）：开源 MCP 客户端，配置最简单——只需把金数据官方文档页面发给模型，告诉它「帮我安装金数据 MCP」，OpenClaw 会自动通过内置的 mcporter skill 完成整个安装和配置流程。
**Qclaw**（国内网络环境友好）： 针对国内网络环境优化，适合大多数国内用户的日常使用场景。
## 配置步骤（以 Claude Desktop 为例）
### 第一步：获取 API Key
登录金数据账号，进入右上角 **「个人中心」→「API」**，获取你的 **API Key** 和 **API Secret**。
> 企业账号路径略有不同：**「系统设置」→「企业 API」**。
### 第二步：生成认证字符串
打开终端（Mac 用 Terminal，Windows 用 PowerShell），运行：
```bash theme={null}
echo -n "你的api_key:你的api_secret" | base64
```
把 `你的api_key` 和 `你的api_secret` 替换成你刚才获取的实际值，运行后会输出一串字符，复制备用。
### 第三步：编辑 Claude 配置文件
找到 Claude Desktop 的 MCP 配置文件（通常位于 `~/Library/Application Support/Claude/claude_desktop_config.json`），添加以下内容：
```json theme={null}
{
"mcpServers": {
"jinshuju": {
"url": "https://jinshuju.net/mcp",
"headers": {
"Authorization": "Basic 你在第二步得到的字符串"
}
}
}
}
```
### 第四步：重启 Claude，验证连接
重启 Claude Desktop，在对话框里输入：
> 「列出我的所有表单」
如果 AI 能返回你账户下的表单列表，配置成功。
## 配置步骤（以 OpenClaw / Qclaw 为例）
OpenClaw 和 Qclaw 的配置方式相同，也是最简单的——几乎不需要任何手动操作。
打开客户端，在对话框里直接把金数据 MCP 文档地址发给模型：
```
https://open.jinshuju.net/mcp/
```
然后说：**「帮我安装金数据 MCP」**。
客户端会自动读取文档、完成配置，并引导你通过浏览器完成 OAuth 授权（跳转到金数据登录页，授权后自动返回）。全程不需要手动编辑任何配置文件。
## 上手之后，你能做什么
这里给几个真实场景，帮你感受实际用法。以下示例中的表单名替换成你自己的即可。
### **场景一：HR 整理面试报名**
活动开始前，HR 需要确认哪些候选人已提交资料。以前要登录金数据后台、找到表单、翻数据页。现在在 Claude 里直接说：
> 「列出『春季校招报名』表单今天的新提交，按学历分组」
几秒钟返回结果，不用离开对话窗口。
想进一步筛选？继续说：
> 「只看投递产品运营专员岗位的」
Claude 会在同一对话里继续处理，不需要重新操作。
### **场景二：销售录入线下收集的线索**
跑完一场展会，手上有一批名片信息需要录入表单。整理成文字发给 AI：
> 「帮我把以下信息录入『客户线索』表单：李小敏，13800138000，北京，对 SaaS 产品感兴趣；周传伟，13900139000，上海，已约下周演示」
AI 逐条写入，你只需要最后核查一遍。比手动一条条填快得多。
### **场景三：结合其他 MCP 工具，数据直接变行动**
金数据 MCP 可以和其他 MCP Server 同时接入，让数据不只是「存起来」，而是直接驱动下一步动作。
***金数据 + 邮件***
> 「查一下『合作咨询』表单昨天的新提交，帮我给每个人写一封跟进邮件草稿，提到他们填写的咨询方向」
AI 先从金数据拿数据，再根据每个人的填写内容生成个性化邮件草稿，全程在一个对话里完成。
***金数据 + 企业微信***
> 「查一下『活动报名』表单今天的新提交，把摘要发到运营群」
不需要有人盯着后台，新数据摘要自动同步给团队。
***金数据 + 飞书文档***
> 「把『客户反馈』表单本周的提交整理成摘要，按问题类型分类，存到飞书的『产品反馈』多维表格」
从收集到归档，一句话完成。
## 常见问题
**Q：需要购买什么套餐才能使用 MCP？**
A：MCP 对所有套餐用户开放，包括免费版。区别在于认证方式：OAuth 认证免费，所有用户都可以用；API Key 认证需要企业版套餐才能生成。选择 OAuth 方式的话，不需要任何付费套餐。
**Q：OAuth 和 API Key 两种认证方式有什么区别？**
A：API Key 方式适合企业内部自己用，一次配置长期有效，权限最高。OAuth 方式适合第三方工具接入，可以按需控制权限范围（比如只开放读取权限），更安全灵活。个人使用推荐 OAuth，企业内部集成推荐 API Key。
**Q：配置之后数据安全吗？**
A：金数据 MCP 使用 HTTPS 加密传输，认证凭证只存在你本地的配置文件中，不会上传到任何第三方服务器。使用 OAuth 方式还可以随时在金数据后台撤销授权。
***
*本文涉及工具：Claude Desktop / OpenClaw / Qclaw + 金数据 MCP Server*\
*文档参考：[金数据开放平台 MCP Server 文档](https://open.jinshuju.net/mcp/)*
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.