Formasty

Formasty MCP

通过 AI Agent 构建和运营可用于生产环境的表单、测验、问卷、工作流和响应管道。

这是 Formasty 官方远程模型上下文协议（MCP）服务的公开文档仓库。Formasty 应用和后端仍为私有。本仓库有意不包含服务实现、基础设施配置、客户数据或凭据。

连接

设置	值
服务名称	formasty
远程 MCP URL	https://app.formasty.com/api/mcp
传输方式	Streamable HTTP
旧版 SSE URL	https://app.formasty.com/api/mcp/sse
身份验证	OAuth；开发者可控客户端可使用 API 密钥作为备用方式
官方注册表名称	com.formasty/form-builder

对于支持远程 MCP 服务的客户端，请添加 https://app.formasty.com/api/mcp 并完成 Formasty OAuth 流程。本仓库仅提供文档：请勿克隆或将其作为服务运行。

Claude

在 Claude 中，打开 Customize > Connectors，添加自定义连接器，输入远程 MCP URL，并通过 Formasty 完成身份验证。该连接器适用于所有支持远程 MCP 的 Claude 界面。

Cursor

Formasty 插件获准上架 Cursor Marketplace 后，可从 Cursor Settings > Plugins 安装，也可以运行：

/add-plugin formasty

在获准上架 Marketplace 之前手动连接，请将以下内容添加到用户或项目 MCP 配置中：

{
  "mcpServers": {
    "formasty": {
      "url": "https://app.formasty.com/api/mcp"
    }
  }
}

Cursor 支持远程 MCP 服务的 Streamable HTTP 和 OAuth。

VS Code 和 GitHub Copilot

将以下内容添加到用户配置文件或工作区的 mcp.json：

{
  "servers": {
    "formasty": {
      "type": "http",
      "url": "https://app.formasty.com/api/mcp"
    }
  }
}

Cline

使用 Cline 的远程服务界面，或通过命令行安装：

cline mcp install formasty --transport http https://app.formasty.com/api/mcp

ChatGPT

在具有 MCP 应用开发者权限的工作区中，使用 https://app.formasty.com/api/mcp 作为 MCP 服务 URL 创建自定义应用，完成 OAuth，并在将其发布到工作区之前检查所请求的工具权限。

Gemini CLI

从 GitHub 安装官方 Formasty Gemini CLI 扩展：

gemini extensions install https://github.com/QuantumCoderSys/formasty-mcp

重启 Gemini CLI，运行 /mcp list，并在系统要求身份验证时通过 /mcp auth formasty 完成 OAuth。根目录下的 gemini-extension.json 用于配置托管的 Streamable HTTP 端点；不会安装后端软件包或本地服务进程。

兼容性桥接

对于仅支持 stdio 的客户端（例如较旧版本的 Claude Desktop），请使用远程桥接：

{
  "mcpServers": {
    "formasty": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.formasty.com/api/mcp"
      ]
    }
  }
}

切勿将 Formasty API 密钥放入公开仓库、共享配置、问题或截图中。面向用户的客户端应优先使用 OAuth。

Agent 和 Marketplace 审核人员可参阅 llms-install.md，了解简明的安装和验证流程。Gemini CLI 还可通过 GEMINI.md 获取针对性的操作指南。

Agent 可以执行的操作

• 从头开始创建表单，或使用 Formasty 入门模板创建表单。
• 构建线索收集表单、问卷、信息收集表单、申请表、预约表、候补名单、投票和测验。
• 添加、更新、移动、重新排序和移除步骤与字段。
• 配置主题、封面、排期、设置、感谢页面和结束页。
• 构建条件工作流、变量、路由规则、匹配测验和评分测验。
• 在发布前验证和审查草稿。
• 发布表单并获取分享、嵌入和连接资源。
• 根据用户权限读取和管理提交内容，并创建响应导出文件。
• 配置受支持的 Webhook、分析像素、标签管理器和自定义域名。
• 导入受支持的 Google Forms 和 Typeform 表单。

当前公开接口提供 75 项操作。请参阅 TOOLS.md，或使用 MCP tools/list 查看实时且权威的架构和安全注释。

身份验证和权限

OAuth 连接以已登录的 Formasty 用户身份运行。工具访问仍受以下因素限制：

• OAuth 作用域或 API 密钥作用域
• 工作区成员资格和角色权限
• 所选工作区的访问权限
• Free、Pro 和 Business 功能限制
• 乐观草稿版本和服务器端验证
• 对重要操作的主机和用户明确批准

公开发现仅会显示工具定义。调用工具或访问工作区数据需要进行身份验证。

实用链接

• Formasty
• 文档
• 官方 MCP Registry 条目
• 隐私政策
• 安全
• 服务条款
• 数据处理协议

安全与隐私

报告漏洞前请阅读 SECURITY.md，并阅读 PRIVACY.md 了解 MCP 特定的数据流。请勿在公开问题中包含访问令牌、API 密钥、表单回复、客户数据、私人表单 URL，或来自真实工作区的复现数据。

支持

账户、账单、隐私或安全敏感问题，请参阅 SUPPORT.md 或发送邮件至 [email protected]。

许可证

本仓库中的文档和元数据遵循 MIT 许可证。Formasty 托管服务的使用受 Formasty 服务条款约束。