Hovercode

Hovercode MCP server

通过聊天，即可在 Claude、ChatGPT、Cursor 或任何 Model Context Protocol 客户端中管理你的 Hovercode 二维码、短链接、落地页和表单。

• 端点： https://hovercode.com/mcp/（Streamable HTTP，托管服务——无需运行任何程序）
• 身份验证： OAuth 2.1（动态客户端注册 + PKCE），或将 Hovercode API 令牌作为持有者令牌
• 文档： https://hovercode.com/integrations/mcp/ · https://hovercode.com/api/#mcp-server
• 此软件包： 一个轻量级 stdio 桥接程序（npx hovercode-mcp），适用于无法直接连接远程服务的客户端。它封装了 mcp-remote，并将其指向托管端点，因此工具和行为完全相同。

助手创建的所有内容都会像其他代码一样出现在你的 Hovercode 仪表板中；每个创建工具都会返回可分享的链接和生成的二维码图片。

连接

Claude、ChatGPT 和其他连接器客户端（推荐）

添加自定义连接器，使用 URL https://hovercode.com/mcp/，并批准访问权限。像往常一样登录 Hovercode；无需复制令牌。

Claude Code

claude mcp add --transport http hovercode https://hovercode.com/mcp/ \
  --header "Authorization: Bearer YOUR_API_TOKEN"

你的 API 令牌位于 https://hovercode.com/api/。

Cursor、Claude Desktop、VS Code 和其他配置文件客户端

远程（首选）：

{
  "mcpServers": {
    "hovercode": {
      "type": "http",
      "url": "https://hovercode.com/mcp/",
      "headers": { "Authorization": "Bearer YOUR_API_TOKEN" }
    }
  }
}

通过此软件包（适用于仅支持 stdio 服务的客户端）：

{
  "mcpServers": {
    "hovercode": {
      "command": "npx",
      "args": ["-y", "hovercode-mcp"]
    }
  }
}

如果未设置令牌，桥接程序会在首次使用时打开浏览器进行 Hovercode OAuth 登录。如需跳过浏览器，请设置 HOVERCODE_API_TOKEN：

{
  "mcpServers": {
    "hovercode": {
      "command": "npx",
      "args": ["-y", "hovercode-mcp"],
      "env": { "HOVERCODE_API_TOKEN": "YOUR_API_TOKEN" }
    }
  }
}

助手可以做什么

范围	工具
工作区	list_workspaces、set_workspace
二维码	create_qr_code（URL、文本或 vCard 联系人）、create_qr_codes_bulk、get_qr_code、list_qr_codes（按文件夹筛选，包含标签和扫描次数）、update_qr_code（更改目标、直接调整样式、重命名、移至文件夹、添加/移除标签）、delete_qr_code、download_qr（适合打印的 PNG + SVG）、get_qr_activity、list_templates（含设计详情）
组织管理	list_folders、create_folder、update_folder（重命名/移动）、delete_folder（代码将变为未归档状态）、list_tags
PDF 二维码	create_pdf_qr — 将 PDF（URL 或 base64）托管在动态二维码 + 短链接后；之后可替换 PDF，无需重新打印
分析	get_analytics — 查看单个代码或整个工作区的总量、每日趋势，以及热门国家/城市/操作系统/浏览器
短链接	create_short_link、get_short_link、list_short_links、update_short_link、delete_short_link、get_short_link_activity
落地页	build_page（丰富的区块式页面：页眉、链接、文本、图片、按钮、视频、图库、常见问题、倒计时、社交媒体、表单等）、list_block_types、create_page（简单的 bio 链接页）、get_page、list_pages、update_page、delete_page
表单	create_form、update_form、list_forms、get_form、get_form_responses

你可以这样提问

• “为 https://example.com/summer 创建一个动态二维码，使用我们的品牌色，并配上说明文字 SCAN ME。”
• “将我印刷的 菜单 二维码指向这个链接中的新 PDF。”
• “将我的活动二维码改成圆角定位点和我们的藏青色——保留同一个码，不要替换。”
• “为我们的发布活动制作一个落地页，包含日程、地图链接和报名表单，并为海报生成二维码。”
• “为这 20 个产品 URL 创建二维码，全部使用相同样式。”
• “创建一个表单，用于收集姓名、邮箱和 T 恤尺码，并提供可分享的链接和二维码。”
• “在 Campaigns 下创建一个名为 Spring 2026 的文件夹，并将这五个代码移入其中。”
• “为 Menus 文件夹中的每个代码添加 'print' 标签。”
• “总结一下本周我的反馈表单收到的回复。”
• “我的二维码这个月效果如何？大家都在哪里扫描？”

套餐与限制

该服务适用于所有 Hovercode 套餐，并遵循与控制台和 REST API 相同的限制。静态代码数量不限；免费套餐包含少量可用的动态（可编辑、可追踪）代码，付费套餐则会提高此上限。

发现元数据

• 服务卡片：https://hovercode.com/.well-known/mcp/server-card.json
• OAuth 受保护资源：https://hovercode.com/.well-known/oauth-protected-resource/mcp
• Markdown 格式的连接指南：https://hovercode.com/mcp/docs
• llms.txt：https://hovercode.com/llms.txt

环境变量（仅限桥接）

变量	用途
HOVERCODE_API_TOKEN	可选。使用你的 API 令牌，而不是 OAuth 浏览器流程。
HOVERCODE_MCP_URL	可选。覆盖端点（默认值为 https://hovercode.com/mcp/）。

额外的 CLI 参数会传递给 mcp-remote。

支持

有疑问或发现错误：请访问 https://hovercode.com/contact/，或在此代码库中提交 issue。

许可证

MIT © Hovercode Ltd