Hovercode

Hovercode MCP サーバー

Claude、ChatGPT、Cursor、またはその他のModel Context Protocolクライアントから、チャットでHovercodeのQRコード、短縮リンク、ランディングページ、フォームを管理できます。

• エンドポイント： 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ダッシュボードに保存されます。また、すべての作成ツールは共有可能なリンクと生成済みQR画像の両方を返します。

接続

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
QRコード	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）を動的QR＋短縮リンクの背後でホストします。再印刷せずに後から差し替えられます
分析	get_analytics — 1つのコードまたはワークスペース全体の合計、日別推移、上位の国／都市／OS／ブラウザー
短縮リンク	create_short_link、get_short_link、list_short_links、update_short_link、delete_short_link、get_short_link_activity
ランディングページ	build_page（ヘッダー、リンク、テキスト、画像、ボタン、動画、ギャラリー、FAQ、カウントダウン、ソーシャル、フォームなどを含むリッチなブロック形式のページ）、list_block_types、create_page（シンプルなリンク集ページ）、get_page、list_pages、update_page、delete_page
フォーム	create_form、update_form、list_forms、get_form、get_form_responses

こんなことを頼めます

• 「ブランドカラーとキャプションのSCAN MEを使って、https://example.com/summer 用の動的QRコードを作成してください。」
• 「印刷済みのメニューQRコードのリンク先を、この新しいPDFに変更してください。」
• 「イベントQRを、同じコードのまま差し替えずに、角丸の目とネイビーでスタイル変更してください。」
• 「スケジュール、地図へのリンク、申し込みフォームを含むローンチイベント用のランディングページを作成し、ポスター用のQRも作ってください。」
• 「これら20個の製品URLすべてに、同じスタイルのQRコードを作成してください。」
• 「名前、メールアドレス、Tシャツのサイズを収集するフォームを作成し、共有用のリンクとQRを用意してください。」
• 「Campaignsの下にSpring 2026フォルダーを作成し、この5つのコードをその中に移動してください。」
• 「Menusフォルダー内のすべてのコードに'print'タグを付けてください。」
• 「今週のフィードバックフォームへの回答を要約してください。」
• 「今月のQRコードの実績と、スキャンされた場所を教えてください。」

プランと上限

このサーバーはすべての 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	任意。OAuth のブラウザーフローの代わりに、API トークンを使用します。
HOVERCODE_MCP_URL	任意。エンドポイントを上書きします（デフォルトは https://hovercode.com/mcp/）。

追加の CLI 引数は mcp-remote に渡されます。

サポート

質問やバグの報告：https://hovercode.com/contact/ またはこのリポジトリで issue を作成してください。

ライセンス

MIT © Hovercode Ltd