ShipMyForm MCP Server已验证已精选

什么是 ShipMyForm MCP Server？

ShipMyForm MCP Server 是 ShipMyForm 的官方远程 MCP 服务器。ShipMyForm 是面向静态网站的表单后端。借助它，编码代理可以创建表单端点、把现成的表单代码粘贴进你的网站、把提交内容转发到 Slack 或 webhook 等工具，并读取提交统计，全程无需打开浏览器。

ShipMyForm 自称 AI 原生的表单后端：控制台能做的每件事都是 MCP 服务器上的一个工具，还有少数事情只有 MCP 能做。代理甚至可以自己创建并验证账号。提交内容会经过垃圾过滤、存储，并转发到邮件、Slack、Sheets 等 20 多种工具。免费套餐每月包含 100 次提交，无需绑卡。

如何使用 ShipMyForm MCP Server？

服务器是远程的（Streamable HTTP），无需安装任何东西。每个客户端都需要这三项信息：

URL:        https://shipmyform.com/api/mcp
Transport:  Streamable HTTP (not SSE, not stdio)
Auth:       Authorization: Bearer smf_YOUR_KEY

API 密钥可以在 Settings → API keys 中获取（所有套餐都可以，包括免费套餐），也可以让代理用你的邮箱调用 sign_up。ShipMyForm 会发送一个 6 位验证码，用这个验证码调用 verify_account 即可返回密钥。ShipMyForm 建议把密钥放在 SMF_API_KEY 之类的环境变量里，而不是写进会提交到仓库的文件。

Claude Code

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

如需通过项目的 .mcp.json 与团队共享（该文件会展开环境变量）：

{
  "mcpServers": {
    "shipmyform": {
      "type": "http",
      "url": "https://shipmyform.com/api/mcp",
      "headers": { "Authorization": "Bearer ${SMF_API_KEY}" }
    }
  }
}

Claude Desktop / claude.ai

“Add custom connector” 对话框是为 OAuth 设计的，没有填写 API 密钥请求头的地方，而 ShipMyForm 不提供 OAuth。在 Claude Desktop 上，请在 claude_desktop_config.json 中使用 mcp-remote 桥接（需要 Node.js），然后重启应用：

{
  "mcpServers": {
    "shipmyform": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://shipmyform.com/api/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer smf_YOUR_KEY" }
    }
  }
}

在 Team 和 Enterprise 套餐中，组织管理员可以把它添加为带 authorization 请求头的自定义连接器（Anthropic 的测试功能）。

Cursor

~/.cursor/mcp.json 或 .cursor/mcp.json：

{
  "mcpServers": {
    "shipmyform": {
      "url": "https://shipmyform.com/api/mcp",
      "headers": { "Authorization": "Bearer ${env:SMF_API_KEY}" }
    }
  }
}

VS Code

.vscode/mcp.json（顶层键为 servers）。输入变量会让 VS Code 只提示一次密钥并安全保存：

{
  "inputs": [
    { "type": "promptString", "id": "shipmyform-key", "description": "ShipMyForm API key (smf_…)", "password": true }
  ],
  "servers": {
    "shipmyform": {
      "type": "http",
      "url": "https://shipmyform.com/api/mcp",
      "headers": { "Authorization": "Bearer ${input:shipmyform-key}" }
    }
  }
}

ShipMyForm 文档还介绍了 Codex CLI、Gemini CLI、Windsurf、Cline、Zed、opencode 和 JetBrains 的配置。

ShipMyForm MCP Server 的主要功能

• 纯代理开通：sign_up 和 verify_account 无需浏览器即可创建账号并返回密钥。
• 提供 HTML、React、Vue 和原生 fetch 的现成代码片段。
• 可转发到邮件、webhook、Slack、Discord、Airtable、HubSpot、Telegram 等。
• 在 shipmyform.com 上托管表单页面，适合没有后端的网站，并附带嵌入脚本。
• 带权限范围的密钥：预设 wiring、triage、readonly 和 full。密钥无法授予自己不具备的权限，因此窄权限密钥是真正的限制。
• 垃圾分类：你对提交内容打的标签会用于训练分类器。
• 速率限制：免费套餐每个密钥每分钟 30 次请求，付费套餐 120 次。

ShipMyForm MCP Server 工具

线上服务器提供 29 个工具，分为几组：

• 账号与密钥：sign_up、verify_account、resend_verification_code、get_account、create_api_key、list_api_keys、revoke_api_key。用 create_api_key 可以给另一个代理一个权限更窄的密钥。
• 账单：start_upgrade 返回一个由人来完成付款的托管结账链接；get_billing_portal 提供管理套餐和银行卡的链接。
• 表单：create_form、list_forms、get_form、update_form（允许的域名、跳转、垃圾模式、校验规则、黑名单、自动回复）、delete_form 和 get_form_snippet。
• 投递：list_connector_types、add_connector、test_connector、set_connector_active、remove_connector。Google Sheets、Notion 等 OAuth 连接器必须在控制台中添加。
• 托管页面：publish_hosted_page、unpublish_hosted_page。
• 提交内容：get_submission_stats 在所有套餐可用。list_submissions、get_submission、label_submissions、delete_submissions 和 export_submissions（CSV，最多 2,000 行）需要付费套餐。

ShipMyForm MCP Server 的使用场景

• 一句话生成联系表单：“在 ShipMyForm 上创建一个名为 ‘Portfolio contact’ 的联系表单，并把 React 代码片段加到 src/components/ContactForm.tsx。”
• 从零开始：“用我的邮箱注册，用收件箱里的验证码完成验证，创建一个会给我发邮件的 ‘Contact’ 表单，并把 Slack 提醒发到 #leads。”
• 没有托管服务器的静态网站：发布一个托管表单页面并嵌入。
• 付费套餐的每周整理：“检查 Contact 表单本周的提交，标记明显的垃圾，把其余的按主题分组，并为每条真实提交起草回复。”
• 查看额度：“我的表单这个月收到了多少次提交，还剩多少额度？”

ShipMyForm MCP Server 常见问题排查

• 401 错误：密钥错误、已被吊销或触发了速率限制。
• 已连接但没有工具：客户端可能在用 SSE。请改用 Streamable HTTP。
• claude.ai 自定义连接器无法填写密钥：改在 Claude Desktop 上使用 mcp-remote 桥接。
• 无法读取提交内容：通过 MCP 读取、标记和导出提交内容属于付费套餐。免费密钥仍可查看统计，控制台中也始终能看到提交内容。
• 请求头在 args 中被破坏：像 Claude Desktop 示例那样，把带空格的值放到 env 里。