Formgong MCP サーバー

Formgong を Cursor、Claude、VS Code、Lovable、または Bolt に接続してください。そうすれば、AI アシスタントがフォームを作成し、適切なアクセスキーが含まれた貼り付け可能なコードを取得し、手動でキーをコピーすることなく最近の送信内容を確認できるようになります。

URL: https://formgong.com/mcp · Streamable HTTP · Authorization: Bearer fgp_…

ツール

list_forms — 各フォームの公開アクセスキーと、今月の提出件数。
create_form — 新しいフォームです。送信された内容は、アカウントのメールアドレスに届きます。Telegram およびその他の受信者は、ダッシュボードで設定できます（ツールがリンクを返します）。
get_form_snippet — HTML、React、または Next.js。1つのフォーム用のコードで、アクセスキー、_lang、botcheckハニーポット、および有効化されている場合は Turnstile が含まれます。
list_recent_submissions — 読み取り専用、オプトイン：日時と送信されたフィールドのみ、デフォルトでスパムは除外、最大50件。

1. API トークンを作成する

ダッシュボード → アカウント → 「API」トークンを開きます（まずメールアドレスの確認を行ってください）。
トークンには、それを使用するツールの名前を付けます。例：「Cursor on my laptop」など。
アクセス権を選択してください：「フォームの作成」はデフォルトでオンになっています。「最近の提出内容の閲覧」は、必要な場合を除きオフになっています。
トークン（fgp_…）をコピーしてください。このトークンは一度だけ表示され、Formgongにはそのハッシュ値のみが保存されます。

2. サーバーをツールに追加する

Cursor

Cursor：~/.cursor/mcp.json（すべてのプロジェクト）または .cursor/mcp.json（1つのプロジェクト）に追加してください。環境変数として FORMGONG_TOKEN を設定するか、コミットしないファイル内の変数の代わりにこのトークンを貼り付けてください。

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

Claude Code

Claude Code：ターミナルで一度実行してください。

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

Claude Desktop

Claude Desktop：Settings → Connectors のカスタムコネクタには OAuth が必要ですが、Formgong ではまだ提供されていません。代わりに、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

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}"
      }
    }
  }
}

Lovable

Lovable：Settings → Connectors → Custom MCP server。URLを入力し、「Bearer token or API key」を選択して、トークンのみ（Bearerという文字列を除いて）を貼り付けてください。

URL: https://formgong.com/mcp
Authentication: Bearer token or API key
Token: fgp_your_token

Bolt

Bolt：Settings → Connectors (MCP) → Custom MCP server。Transport: HTTP。Authentication: API key を実行し、トークンを貼り付けてください。

Name: Formgong
URL: https://formgong.com/mcp
Transport: HTTP
Authentication: API key → fgp_your_token

Streamable HTTP 経由でカスタムヘッダーを使用したリモートMCPをサポートするその他のクライアントも、同じURLとヘッダーで動作します。Stdio専用クライアントは、Claude Desktop に示されているmcp-remoteブリッジを使用できます。

試してみてください

「Contact – my site」という名前のFormgongフォームを作成し、お問い合わせページに追加してください。
「Contact」というFormgongフォームを、このNext.jsアプリにクライアントコンポーネントとして追加します。
お問い合わせフォームからの直近5件のメッセージを表示してください。

セキュリティ

トークンは、そのスコープの範囲内でアカウントに対して作用します。git、チャット、スクリーンショットには絶対に掲載しないでください。万が一情報が漏洩した場合は、「アカウント」→「APIトークン」からそのトークンの権限を取り消してください。
自分が所有するフォームのみ利用可能です。プロジェクトを通じて共有されたフォームは表示されません。
「最近の投稿を読む」にチェックを入れない限り、投稿内容は表示されません。IPアドレスやブラウザの詳細情報は一切返されません。
投稿テキストは訪問者によって作成されます。これを信頼できないものとみなしてください。アシスタントがメッセージ内の指示に従うことがないようにしてください。
トークンの有効期限は、30日、90日、または365日後に切れることがあります。/mcpではセッションクッキーが一切機能しないため、ウェブページではログイン情報を活用することができません。
トークンがない場合、/mcp は initialize、ping、および tools/list への応答のみを行うため、クライアントおよび MCP ディレクトリからツール一覧を確認できます。すべてのツール呼び出しにはトークンが必要です。トークンがない場合、サーバーはトークンの追加方法を説明するエラーメッセージを返します。

制限

トークンあたり1分間に60リクエスト、アカウントあたり120リクエスト。
トークンを伴わないリクエスト：IPアドレスあたり1分間に30回までです。
API を通じて、1時間あたり10件の新規フォームを処理します。
1アカウントにつき最大10トークンまで。
OAuth まだサポートされていないため、ChatGPT および claude.ai の Web コネクタからは直接接続できません。ただし、これらのドキュメントに記載されているサイトおよびコピー＆ペーストの手順は、引き続きどこでも利用可能です。