Formgong

Formgong MCP 服务

Formgong 是一款表单后端，为静态网站和 AI 构建的网站提供免费套餐：它会将提交内容发送到 Telegram 和电子邮件，在欧盟存储数据，并支持 12 种语言。

与 Formspree、Web3Forms、Basin、Forminit、FormSubmit 和 Netlify Forms 的对比：formgong.com/en/compare

这是一个面向 Formgong 的远程 Model Context Protocol 服务。Formgong 是一款托管式表单后端，适用于静态网站和 AI 构建的网站。你的 AI 助手可以创建联系表单、获取可直接粘贴的表单代码并读取近期提交内容，无需再手动复制访问密钥。

• URL： https://formgong.com/mcp
• 传输方式： Streamable HTTP。它是无状态的，并返回 JSON 响应。
• 身份验证： 两种方式，选择客户端支持的方式即可。
  • OAuth 2.1（推荐）：使用授权码流程，必须启用 PKCE（S256），并在 https://formgong.com/oauth/register 进行动态客户端注册，因此 Claude Desktop、Cursor、VS Code、Lovable 和 Bolt 等客户端可通过浏览器登录连接，无需复制粘贴密钥。没有凭据的工具调用会返回 401，并附带 WWW-Authenticate: Bearer realm="formgong", resource_metadata="https://formgong.com/.well-known/oauth-protected-resource/mcp", scope="forms:read forms:write" (RFC 9728)；元数据位于 /.well-known/oauth-authorization-server 和 /.well-known/oauth-protected-resource/mcp。访问令牌有效期为 1 小时，并通过刷新令牌轮换。
  • 个人 API 令牌： 对于只发送静态标头的客户端，使用 Authorization: Bearer fgp_…。
  • 无论采用哪种方式，initialize、ping 和 tools/list 均无需身份验证即可使用，因此客户端和目录可在登录前查看工具。
• 权限范围： forms:read（始终授予）、forms:write、submissions:read（默认关闭，需请求启用）。
• 文档： https://formgong.com/en/docs/mcp/（支持 12 种语言）

无需安装任何内容：该服务运行在 formgong.com 上。此仓库包含文档，以及用于官方 MCP 注册表（com.formgong/mcp）的 server.json。

简短且可复用的服务卡片列出了连接详情、权限范围和提示词示例。

Formgong 的功能

• **交付方式：**所有套餐均支持即时发送 Telegram。免费版的邮件以每日摘要形式发送；Pro 和 Business 套餐则在每次提交后发送邮件。点击一个按钮即可连接 Telegram，也支持群组。签名 JSON webhook（HMAC-SHA256 X-Signature，最多尝试交付 5 次）附带 Make、n8n、Zapier 和 KeyCRM 的分步指南。
• **欧盟数据：**提交内容存储在欧盟（Cloudflare D1 采用欧盟管辖区），IP 地址仅以哈希形式保存。标准的 Art. 28 DPA 已纳入条款。
• **垃圾信息：**没有 CAPTCHA 谜题，也不使用 Cookie。所有套餐均提供蜜罐、无 Cookie 检查，以及可选的 Cloudflare Turnstile。没有 JavaScript 的纯 HTML 表单也能正常使用。
• **12 种语言：**感谢页面、错误信息和自动回复会使用访客的语言。
• 代理机构：Projects 可按客户归类表单（所有套餐最多 100 个），并支持邀请只能查看的客户，以及将项目移交到客户自己的账户。
• **定价：**免费套餐每月可接收 300 次提交，表单数量不限。Pro 每月 $5，Business 每月 $15（截至 2026 年 10 月）。免费版会在托管的感谢页面和邮件中显示一条小型的 “Form powered by Formgong” 链接。

工具

工具	权限范围	功能
list_forms	forms:read	列出你的表单：id、名称、公开访问密钥（fk_…）以及本月提交数。
create_form	forms:write	创建表单（name、notify_email）。提交内容会发送到你的账户邮箱。返回表单 id、访问密钥，以及用于连接 Telegram 和添加额外收件人的控制面板链接。限制：每小时最多新建 10 个表单。
get_form_snippet	forms:read	返回一个表单的代码（form_id、framework：html / react / next、lang），其中包含访问密钥、_lang 字段、botcheck 蜜罐，以及启用时的 Turnstile。
list_recent_submissions	submissions:read	仅供读取，且须主动选择启用。返回最多 50 条近期提交，仅包含时间和已提交字段（不含 IP 或用户代理）。默认排除垃圾信息。字段值会标记为不可信的访客输入。
list_webhooks	forms:read	列出表单的 webhook（form_id）：id、URL 和创建时间，不会返回签名密钥。
create_webhook	forms:write	为表单添加公开的 https webhook，供 n8n、Make 或 Zapier 注册其触发器 URL。返回表单的签名密钥。每个表单的数量受套餐限制。
delete_webhook	forms:write	删除你拥有的某个表单中的一个 webhook。
list_website_templates	forms:read	列出免费的 MIT 许可网站模板（完整网站，联系表单已接入 Formgong）：细分领域、在线演示、源代码、HTML 下载和启动命令。可选参数 topic。从模板开始新建网站，无需生成每个页面。

1. 创建 API 令牌（仅当你的客户端无法使用 OAuth 时）

带有 OAuth 连接器的客户端可完全跳过此步骤——它们会通过浏览器为你登录。只有会发送静态 Authorization 标头的客户端才需要创建令牌。

1. 在 https://formgong.com 注册（免费套餐每月包含 300 次提交，数据存储在欧盟），然后确认你的邮箱。
2. 打开 Dashboard → Account → API tokens。
3. 使用将要使用该令牌的工具为令牌命名，并选择访问权限：
   • 默认启用 “Create forms”。
   • “Read recent submissions” 默认关闭，需手动启用。
   • 你可以设置可选的到期时间。
4. 复制令牌（fgp_…）。令牌只显示一次，Formgong 仅存储其哈希。你可以随时在同一页面撤销令牌。

2. 将服务添加到客户端

Cursor

~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）：

{
  "mcpServers": {
    "formgong": {
      "url": "https://formgong.com/mcp",
      "auth": { "CLIENT_ID": "cursor", "scopes": ["forms:read", "forms:write"] }
    }
  }
}

Claude Code

claude mcp add --transport http formgong https://formgong.com/mcp

批准浏览器登录。如果你更愿意使用个人令牌，请添加 --header "Authorization: Bearer fgp_your_token"。

Claude Desktop

设置 → 连接器 → 添加自定义连接器，输入 https://formgong.com/mcp 并点击连接。Claude Desktop 会从 401 挑战中发现 OAuth 元数据，动态注册自身，并打开浏览器窗口供你批准权限范围——无需粘贴令牌。

如果你的客户端不支持 OAuth，只发送静态标头，请在 claude_desktop_config.json 中使用 mcp-remote 桥接程序（需要 Node.js），然后重启 Claude Desktop：

{
  "mcpServers": {
    "formgong": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://formgong.com/mcp", "--header", "Authorization:${FORMGONG_AUTH}"],
      "env": { "FORMGONG_AUTH": "Bearer fgp_your_token" }
    }
  }
}

VS Code（Copilot Agent 模式）

.vscode/mcp.json。VS Code 会提示你输入一次令牌，并安全地存储该令牌：

{
  "inputs": [{ "type": "promptString", "id": "formgong-token", "description": "Formgong API token (fgp_…)", "password": true }],
  "servers": {
    "formgong": {
      "type": "http",
      "url": "https://formgong.com/mcp",
      "headers": { "Authorization": "Bearer ${input:formgong-token}" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "formgong": {
      "serverUrl": "https://formgong.com/mcp",
      "headers": { "Authorization": "Bearer ${env:FORMGONG_TOKEN}" }
    }
  }
}

Lovable 和 Bolt

• Lovable： 打开连接器 → + → MCP 服务。将名称设为 Formgong，并输入 https://formgong.com/mcp。保留 Direct connection 和 OAuth 设置；点击 Add & authorize，登录 Formgong 并批准权限。也可以通过 Bearer token 或 API key 使用个人令牌。
• Bolt： 打开设置 → 连接器（MCP）→ 自定义 MCP 服务。名称：Formgong。URL：https://formgong.com/mcp?auth=required。传输方式：HTTP。身份验证：MCP OAuth。点击连接，登录并批准权限，然后为你的项目启用该连接器。使用个人 Formgong 令牌时，仍可使用 API key。

设置控件的说明见 Lovable 和 Bolt。Bolt URL 会在初始化前请求身份验证，以免将匿名发现误认为已授权连接。连接器可让构建工具获取代码；发布后的联系表单仍会直接提交到 Formgong。

v0

打开提示词旁边的 + 菜单并选择 MCP。配置自定义服务，URL 填写 https://formgong.com/mcp，选择 Bearer Token 并粘贴你的个人 Formgong API 令牌。这些控件的说明见 v0 MCP 集成。请使用个人令牌，因为 Formgong 目前不允许 v0 OAuth 回调。v0 联系表单指南还提供了直接生成表单的提示词；发布后的表单会直接发送到 Formgong。

其他客户端

支持通过 Streamable HTTP 使用远程 MCP 的客户端，可以使用相同的 URL 和个人令牌。浏览器登录需要使用 Formgong 接受的回调：列出的 Cursor/Claude/VS Code 回调、Lovable 的精确回调 https://api.lovable.dev/workspaces/connectors/mcp/oauth/callback、域名必须恰好为 lovable.dev 或 bolt.new 的 HTTPS 回调（不允许子域名、非标准端口、userinfo、查询字符串或片段），或 HTTP loopback 回调。每个动态客户端都会绑定到其完整的注册 URI。即使其他托管来源的客户端自称 Lovable 或 Bolt，也会被拒绝。仅支持 Stdio 的客户端可以使用 mcp-remote 桥接程序。

试用

• “创建一个名为 ‘Contact – acme.com’ 的 Formgong 表单，并将其作为 React 组件添加到联系页面。”
• “列出我的 Formgong 表单，并用德语提供最新表单的 Next.js 代码片段。”
• “显示我的联系表单最近的 5 条提交记录。”（此操作需要具有‘读取最近提交记录’权限的令牌。）

安全性

• 令牌采用作用域限制（forms:read、forms:write、submissions:read），仅以哈希形式存储，可设置过期时间，并可在控制面板中撤销。
• OAuth 授权的处理方式相同：除非客户端请求 submissions:read，否则绝不会授予该权限；访问令牌在 1 小时后过期，刷新令牌在 30 天后过期并进行轮换。每个已连接的应用都会列在 控制面板 → 账户 → 已连接的应用 下，你可以在此撤销授权。https://formgong.com/oauth/revoke 实现了 RFC 7009。
• 每个令牌每分钟可发起 60 次请求。未携带令牌的请求按 IP 每分钟限制为 30 次，身份验证失败的尝试也会按 IP 限流。
• 不带有效凭据的工具调用会收到 HTTP 401，并附带 JSON-RPC 错误（代码 -32001），其 data 包含 resourceMetadata，客户端可据此启动 OAuth 流程，或告知用户创建令牌的位置。
• 工具只能查看令牌所有者拥有的表单。提交内容不会包含 IP 地址或用户代理。
• 请将安全问题报告至 [email protected]。

相关内容

• 起始模板：nextjs-starter、astro-starter、html-starter、react-contact-form
• npm（源代码）：formgong（npx formgong init）、create-formgong、@formgong/react，以及适用于 Next.js、Vue、Svelte、Astro 和 Angular 的软件包
• 集成方案（Make、n8n、Zapier、KeyCRM）：https://formgong.com/en/integrations/
• 面向 AI 构建工具的文档：https://formgong.com/en/docs/

许可证

MIT © Formgong。此许可证适用于本仓库中的文档和配置。托管服务受 https://formgong.com/terms 约束。