FormVault

FormVault MCP 服务

通过任何兼容 MCP 的 AI 助手，创建和管理符合 GDPR 要求、托管于欧盟的表单。

这是一个用于 FormVault 的 MCP 服务。FormVault 是一款托管于德国的表单构建工具。将 Claude、ChatGPT、Cursor、Copilot 或任何兼容 MCP 的助手连接到你的 FormVault 账户，然后通过描述需求来创建表单。

前置条件

需要一个 FormVault 账户和一个 API 密钥。请在 formvault.eu/app/api-keys 创建密钥。

设置（托管版 — 推荐）

将托管服务添加到助手的 MCP 配置中，无需安装，也无需运行本地进程：

{
  "mcpServers": {
    "formvault": {
      "url": "https://api.formvault.eu/mcp",
      "headers": {
        "Authorization": "Bearer fv_your_key_here"
      }
    }
  }
}

Claude Desktop 对远程／基于标头的 MCP 服务的支持取决于版本 — 如果上述配置未显示为选项，请查看其最新文档。

没有任何工具会接收租户 ID。API 密钥包含自身的租户信息，因此它无法读取或写入其他组织的表单 — 如果尝试访问它无权处理的表单 ID，系统会报告_未找到_，而不是_禁止访问_，因此无法使用密钥来探查已有内容。服务本身不会保存任何长期凭据；每个请求的权限范围都由你发送的密钥决定。你可以随时在 API 密钥页面撤销密钥。

设置（npx / stdio）

适用于尚不支持远程／基于标头服务的客户端：

{
  "mcpServers": {
    "formvault": {
      "command": "npx",
      "args": ["-y", "@formvault/mcp"],
      "env": {
        "FORMVAULT_API_KEY": "fv_your_key_here"
      }
    }
  }
}

重启助手，然后提出你的需求，例如：

• “帮我创建一份客户登记表，并添加 GDPR 同意复选框。”
• “列出我的表单，并告诉我哪些还没有字段。”
• “删除我之前创建的测试表单。”

变量	必需	默认值
FORMVAULT_API_KEY	是	—
FORMVAULT_API_URL	否	https://api.formvault.eu

自托管／本地开发

你可以自行运行此软件包，将其作为本地 stdio 服务运行，也可以部署为自己的 HTTP 服务。它是 FormVault API 的客户端，因此仍需要 FormVault 账户和 API 密钥：

npm install
npm run build

# stdio (for a local Claude Desktop/Code config using "command"/"args")
FORMVAULT_API_KEY=fv_... node dist/index.js

# HTTP (what the hosted deployment runs)
PORT=3003 FORMVAULT_API_URL=https://api.formvault.eu node dist/httpServer.js

如需针对本地 FormVault API 开发，请将 FORMVAULT_API_URL 指向该 API（例如 http://localhost:3000）。

工具

工具	功能
list_forms	列出账户中的所有表单及其字段数量
get_form	获取一个表单的完整字段和设置定义
create_form	根据描述创建表单
delete_form	删除表单（不可撤销）
list_submissions	获取表单中已解密的答复

关于答题者数据

list_submissions 会以明文形式返回答题者的个人数据。系统会向模型说明，除非你明确要求查看答复，否则不要调用此工具，因此常规的表单构建工作不会将这些数据载入上下文。

这是一条有意设定的边界，并非功能限制。FormVault 会使用 AES-256-GCM 加密答复，并将其存储在德国纽伦堡的服务器上，所有套餐均附有签署的 DPA。你是否将数据发送给 AI 提供商由你决定 — 此服务的职责是确保这是你的主动决定，而非意外结果。

链接

• formvault.eu/mcp
• 数据处理协议
• 隐私

支持

如有问题或需报告错误：提交 issue。欢迎提交拉取请求。

许可证

MIT