formpaste

formpaste-mcp

通过编码 Agent 创建并接入联系表单。提供六种用于表单、代码片段和提交内容的工具。

这是什么

此软件包是一个轻量封装，用于启动 mcp-remote，并将其指向托管的 Formpaste MCP 服务（https://api.formpaste.com/mcp，采用 streamable-http 传输）。等效的手动 mcp-remote 配置效果完全相同；此软件包的主要作用是让 Agent 和客户端能够按名称发现并安装 Formpaste 的 MCP 服务，而不是提供手动配置无法实现的功能。

要求

• Node.js 18 或更高版本
• Formpaste 账户
• 从 Formpaste 控制台的 Settings -> API & MCP 获取的 API 令牌

安装

以下每种客户端的配置都指向托管的 MCP 端点 https://api.formpaste.com/mcp。请将 fpat_YOUR_TOKEN 替换为从 Settings -> API & MCP 获取的令牌。

Claude Code

claude mcp add formpaste --transport http https://api.formpaste.com/mcp \
  --header "Authorization: Bearer fpat_YOUR_TOKEN"

Codex

# ~/.codex/config.toml
[mcp_servers.formpaste]
command = "npx"
args = ["mcp-remote", "https://api.formpaste.com/mcp", "--header", "Authorization: Bearer fpat_YOUR_TOKEN"]

Cursor

// .cursor/mcp.json
{
  "mcpServers": {
    "formpaste": { "command": "npx", "args": ["mcp-remote", "https://api.formpaste.com/mcp", "--header", "Authorization: Bearer fpat_YOUR_TOKEN"] }
  }
}

Claude Desktop

// claude_desktop_config.json
{
  "mcpServers": {
    "formpaste": { "command": "npx", "args": ["mcp-remote", "https://api.formpaste.com/mcp", "--header", "Authorization: Bearer fpat_YOUR_TOKEN"] }
  }
}

VS Code

// .vscode/mcp.json
{
  "servers": {
    "formpaste": { "command": "npx", "args": ["mcp-remote", "https://api.formpaste.com/mcp", "--header", "Authorization: Bearer fpat_YOUR_TOKEN"] }
  }
}

通过此软件包配置任意 MCP 客户端

FORMPASTE_TOKEN=fpat_YOUR_TOKEN npx formpaste-mcp

formpaste-mcp 会从环境变量（或 --token 标志）读取 FORMPASTE_TOKEN，并为你启动 mcp-remote，连接到托管端点。

六种工具

工具	用途	范围
create_form	创建表单，返回其访问密钥和接入代码片段	setup
get_snippet	返回可复制粘贴的 html/react/nextjs/astro/vue/svelte 代码片段	setup
list_forms	列出所有表单及其 ID、名称、访问密钥、收件箱／垃圾邮件数量	setup
get_form	读取一个表单的配置，以确认接入正确	setup
send_test_submission	保存一条测试提交，以确认表单已上线	setup
list_submissions	列出提交内容，可选择包含消息正文	full

令牌范围

Formpaste API 令牌有两种范围：

• full 可以执行所有操作，包括通过 list_submissions 读取提交内容。
• setup 可以执行除 list_submissions 之外的所有操作，因此不会读取第三方提交内容。

请为 Agent 使用 setup 范围的令牌。它可以创建表单、获取代码片段并验证表单是否正确接入，但不会授予访问表单收集数据的权限。

操作示例

请参阅 examples/wire-a-form.md，了解完整操作流程：创建表单、获取代码片段、将其粘贴到页面中、发送测试提交，并确认表单已正确接入。

链接

• 文档：https://formpaste.com/docs
• MCP 服务文档：https://formpaste.com/docs/agents/mcp-server
• 安装指南：https://formpaste.com/docs/agents/install
• 问题反馈：https://github.com/webrating/formpaste-mcp/issues