Formgong

Formgong MCP サーバー

Formgong は、静的サイトや AI で構築したサイト向けの無料プランを備えたフォームバックエンドです。送信内容を Telegram とメールに配信し、データを EU 内に保存し、12 言語に対応しています。

Formspree、Web3Forms、Basin、Forminit、FormSubmit、Netlify Forms との比較については、こちらをご覧ください：formgong.com/en/compare

静的サイトや AI で構築したウェブサイト向けのホスト型フォームバックエンド、Formgong 用のリモート Model Context Protocol サーバーです。AI アシスタントでお問い合わせフォームを作成し、すぐに貼り付けられるフォームコードを取得し、最近の送信内容を確認できます。アクセスキーを手作業でコピーする必要はありません。

• URL： https://formgong.com/mcp
• トランスポート： Streamable HTTP。ステートレスで、JSON レスポンスを返します。
• 認証： 2 つの方法があり、クライアントが対応しているほうを選べます。
  • OAuth 2.1（推奨）：必須の PKCE（S256）を使用する認可コードフローと、https://formgong.com/oauth/register での動的クライアント登録に対応しています。そのため、Claude Desktop、Cursor、VS Code、Lovable、Bolt などのクライアントは、秘密情報をコピーして貼り付けることなく、ブラウザーでサインインして接続できます。認証情報なしでツールを呼び出すと、WWW-Authenticate: Bearer realm="formgong", resource_metadata="https://formgong.com/.well-known/oauth-protected-resource/mcp", scope="forms:read forms:write" を含む 401 が返されます（RFC 9728）。メタデータは /.well-known/oauth-authorization-server および /.well-known/oauth-protected-resource/mcp にあります。アクセストークンの有効期間は 1 時間で、リフレッシュトークンを使って更新されます。
  • 個人用 API トークン： 静的ヘッダーのみを送信するクライアント向けの Authorization: Bearer fgp_… です。
  • どちらの方法でも、initialize、ping、tools/list は認証なしで利用できます。そのため、クライアントやディレクトリはサインイン前にツールを確認できます。
• スコープ： forms:read（常に付与）、forms:write、submissions:read（リクエストがない場合は無効）。
• ドキュメント： https://formgong.com/en/docs/mcp/（12 言語対応）

インストールは不要です。サーバーは formgong.com 上で稼働しています。このリポジトリには、ドキュメントと公式 MCP Registry 用の server.json（com.formgong/mcp）が含まれています。

再利用できる簡潔なサーバーカードには、接続情報、スコープ、プロンプトの例を掲載しています。

Formgong の機能

• 配信： すべてのプランで Telegram に即時通知します。無料プランではメールが毎日のダイジェストで届き、Pro と Business では送信のたびに届きます。Telegram はボタンを 1 つ押すだけで接続でき、グループにも対応しています。署名付き JSON webhook（HMAC-SHA256 X-Signature、最大 5 回の配信試行）には、Make、n8n、Zapier、KeyCRM向けの手順ごとのレシピが用意されています。
• EU のデータ： 送信内容は EU 内（EU 管轄の Cloudflare D1）に保存され、IP アドレスはハッシュとしてのみ保持されます。標準的な Art. 28 DPA は利用規約に含まれています。
• スパム： CAPTCHA パズルも Cookie もありません。ハニーポット、Cookie を使わないチェック、任意の Cloudflare Turnstile がすべてのプランで利用できます。JavaScript を使わない通常の HTML フォームも引き続き動作します。
• 12 言語： サンクスページ、エラー、自動返信は訪問者の言語に合わせて表示されます。
• 代理店： プロジェクトでクライアントごとにフォームをまとめられます（すべてのプランで最大 100 件）。閲覧専用のクライアント招待や、クライアント自身のアカウントへの引き継ぎにも対応しています。
• 料金： 無料プランでは月 300 件の送信と無制限のフォームを利用できます。Pro は月額 $5、Business は月額 $15 です（2026 年 10 月時点）。無料プランでは、ホストされたサンクスページとメールに小さな「Form powered by Formgong」リンクが表示されます。

ツール

ツール	スコープ	機能
list_forms	forms:read	フォームの ID、名前、公開アクセスキー（fk_…）、今月の送信件数を一覧表示します。
create_form	forms:write	フォーム（name、notify_email）を作成します。送信内容はアカウントのメールアドレスに届きます。フォーム ID、アクセスキー、Telegram と追加の受信者を接続するためのダッシュボードリンクを返します。作成上限：1 時間あたり 10 件。
get_form_snippet	forms:read	1 つのフォーム（form_id、framework：html / react / next、lang）のコードを、アクセスキー、_lang フィールド、botcheck ハニーポット、ならびに有効になっている場合は Turnstile とともに返します。
list_recent_submissions	submissions:read	読み取り専用で、オプトインが必要です。最近の送信を最大 50 件、時刻と送信されたフィールドのみ（IP アドレスやユーザーエージェントは含まない）返します。デフォルトではスパムは除外されます。フィールド値には、信頼できない訪問者からの入力であることを示すマークが付けられます。
list_webhooks	forms:read	フォーム（form_id）の webhook を一覧表示します。ID、URL、作成日時を返し、署名シークレットは決して返しません。
create_webhook	forms:write	フォームに公開 https webhook を追加し、n8n、Make、Zapier がトリガー URL を登録できるようにします。フォームの署名シークレットを返します。フォームごとにプラン上限があります。
delete_webhook	forms:write	自分が所有するフォームから webhook を 1 つ削除します。
list_website_templates	forms:read	無料で MIT ライセンスのウェブサイトテンプレートを一覧表示します（お問い合わせフォームが Formgong に接続済みの完成サイト）。分野、ライブデモ、ソース、HTML ダウンロード、起動コマンドが含まれます。任意の topic を指定できます。すべてのページを生成する代わりに、テンプレートから新しいサイトを始められます。

1. API トークンを作成する（クライアントが OAuth に対応していない場合のみ）

OAuth コネクターを備えたクライアントでは、この手順は不要です。ブラウザー経由でサインインできます。静的な Authorization ヘッダーを送信するクライアントでのみトークンを作成してください。

1. https://formgong.com で登録します（無料プランには月 300 件の送信が含まれ、データは EU 内に保存されます）。その後、メールアドレスを確認します。
2. ダッシュボード → アカウント → API トークンを開きます。
3. トークンを使用するツールの名前を付け、アクセス権を選択します。
   • 「フォームの作成」はデフォルトで有効です。
   • 「最近の送信を読み取る」は、有効にしない限り無効です。
   • 有効期限を任意で設定できます。
4. トークン（fgp_…）をコピーします。トークンは一度だけ表示され、Formgong にはハッシュのみが保存されます。いつでも同じページから取り消せます。

2. サーバーをクライアントに追加する

Cursor

（すべてのプロジェクト）~/.cursor/mcp.json または（1 つのプロジェクト）.cursor/mcp.json：

{
  "mcpServers": {
    "formgong": {
      "url": "https://formgong.com/mcp",
      "auth": { "CLIENT_ID": "cursor", "scopes": ["forms:read", "forms:write"] }
    }
  }
}

Claude Code

claude mcp add --transport http formgong https://formgong.com/mcp

ブラウザーでのサインインを承認します。個人用トークンを使用する場合は、--header "Authorization: Bearer fgp_your_token" を追加してください。

Claude Desktop

Settings → Connectors → Add custom connector を開き、https://formgong.com/mcp を入力して Connect をクリックします。Claude Desktop は 401 チャレンジから OAuth メタデータを検出し、自身を動的に登録して、スコープを承認するブラウザーウィンドウを開きます。トークンを貼り付ける必要はありません。

OAuth に対応しておらず、静的ヘッダーのみを送信するクライアントの場合は、claude_desktop_config.json で mcp-remote ブリッジ（Node.js が必要です）を使用してから、Claude Desktop を再起動します。

{
  "mcpServers": {
    "formgong": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://formgong.com/mcp", "--header", "Authorization:${FORMGONG_AUTH}"],
      "env": { "FORMGONG_AUTH": "Bearer fgp_your_token" }
    }
  }
}

VS Code（Copilot エージェントモード）

.vscode/mcp.json。VS Code はトークンを一度だけ要求し、安全に保存します。

{
  "inputs": [{ "type": "promptString", "id": "formgong-token", "description": "Formgong API token (fgp_…)", "password": true }],
  "servers": {
    "formgong": {
      "type": "http",
      "url": "https://formgong.com/mcp",
      "headers": { "Authorization": "Bearer ${input:formgong-token}" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "formgong": {
      "serverUrl": "https://formgong.com/mcp",
      "headers": { "Authorization": "Bearer ${env:FORMGONG_TOKEN}" }
    }
  }
}

Lovable と Bolt

• Lovable： Connectors → + → MCP server を開きます。名前に Formgong を入力し、https://formgong.com/mcp を入力します。Direct connection と OAuth をそのまま使用し、Add & authorize をクリックして Formgong にサインインし、権限を承認します。Bearer token または API key を使って個人用トークンを利用することもできます。
• Bolt： Settings → Connectors (MCP) → Custom MCP server を開きます。名前：Formgong。URL：https://formgong.com/mcp?auth=required。トランスポート：HTTP。認証：MCP OAuth。Connect をクリックしてサインインし、権限を承認したら、プロジェクトでコネクターを有効にします。個人用 Formgong トークンを使えば、API key も引き続き利用できます。

セットアップ用のコントロールについては、Lovable と Bolt のドキュメントをご覧ください。Bolt の URL は初期化の前に認証を要求するため、匿名での検出が認証済み接続と誤認されることはありません。コネクターを使うとビルダーはコードを取得できます。公開されたお問い合わせフォームは引き続き Formgong に直接送信されます。

v0

プロンプトの横にある + メニューを開き、MCPs を選択します。URL に https://formgong.com/mcp を指定してカスタムサーバーを設定し、Bearer Token を選択して個人用 Formgong API トークンを貼り付けます。これらのコントロールについては、v0 MCP Integrations のドキュメントをご覧ください。Formgong は現在 v0 の OAuth コールバックを許可していないため、個人用トークンを使用してください。v0 のお問い合わせフォームガイドには、フォームを直接生成するプロンプトもあります。公開されたフォームは Formgong に直接送信されます。

その他のクライアント

Streamable HTTP 経由のリモート MCP に対応するクライアントでは、同じ URL と個人用トークンを使用できます。ブラウザーでのサインインには、Formgong が受け入れるコールバックが必要です。対象は、記載されている Cursor／Claude／VS Code のコールバック、Lovable の正確な https://api.lovable.dev/workspaces/connectors/mcp/oauth/callback コールバック、ホストが厳密に lovable.dev または bolt.new の HTTPS（サブドメイン、標準外ポート、ユーザー情報、クエリ、フラグメントは不可）、または HTTP ループバックコールバックです。動的クライアントはそれぞれ、登録済みの完全な URI に紐付けられます。クライアントが自らを Lovable または Bolt と名乗っても、その他のホスト型オリジンは拒否されます。stdio のみ対応するクライアントでは、mcp-remote ブリッジを使用できます。

試してみる

• 「『Contact – acme.com』という名前の Formgong フォームを作成し、React コンポーネントとしてお問い合わせページに追加してください。」
• 「Formgong のフォーム一覧を表示し、最新のフォームの Next.js スニペットをドイツ語で提示してください。」
• 「お問い合わせフォームの最新の送信内容を5件表示してください。」（「最近の送信内容を読み取る」権限のあるトークンが必要です。）

セキュリティ

• トークンにはスコープ（forms:read、forms:write、submissions:read）が設定され、ハッシュのみが保存されます。有効期限を設定でき、ダッシュボードで取り消すこともできます。
• OAuth の許可も同様に機能します。クライアントが要求しない限り、submissions:read は許可されません。アクセストークンの有効期限は 1 時間、リフレッシュトークンの有効期限はローテーション付きで 30 日です。接続済みのアプリはすべて ダッシュボード → アカウント → 接続済みアプリ に一覧表示され、そこで取り消すことができます。https://formgong.com/oauth/revoke は RFC 7009 を実装しています。
• 各トークンで 1 分あたり 60 件のリクエストを送信できます。トークンなしのリクエストは IP ごとに 1 分あたり 30 件に制限され、認証失敗の試行も IP ごとにレート制限されます。
• 有効な認証情報を使わないツール呼び出しには、JSON-RPC エラー（コード -32001）を含む HTTP 401 が返されます。その data には resourceMetadata が含まれるため、クライアントは OAuth フローを開始するか、トークンの作成場所をユーザーに案内できます。
• ツールから参照できるのは、トークン所有者が所有するフォームのみです。送信データに IP アドレスやユーザーエージェントが含まれることはありません。
• セキュリティ上の問題は [email protected] までご報告ください。

関連情報

• スターター：nextjs-starter、astro-starter、html-starter、react-contact-form
• npm（ソース）：formgong（npx formgong init）、create-formgong、@formgong/react、および Next.js、Vue、Svelte、Astro、Angular 向けのパッケージ
• インテグレーションのレシピ（Make、n8n、Zapier、KeyCRM）：https://formgong.com/en/integrations/
• AI ビルダー向けドキュメント：https://formgong.com/en/docs/

ライセンス

MIT © Formgong。このライセンスは、このリポジトリ内のドキュメントと設定に適用されます。ホスティングサービスには https://formgong.com/terms が適用されます。