Formgong MCP サーバー
Formgong を Cursor、Claude、VS Code、Lovable、または Bolt に接続してください。そうすれば、AI アシスタントがフォームを作成し、適切なアクセスキーが含まれた貼り付け可能なコードを取得し、手動でキーをコピーすることなく最近の送信内容を確認できるようになります。
URL: https://formgong.com/mcp · Streamable HTTP · OAuth 2.1 or Authorization: Bearer fgp_…
ツール
- list_forms — 各フォームの公開アクセスキーと、今月の提出件数。
- create_form — 新しいフォームです。送信された内容は、アカウントのメールアドレスに届きます。Telegram およびその他の受信者は、ダッシュボードで設定できます(ツールがリンクを返します)。
- get_form_snippet — HTML、React、または Next.js。1つのフォーム用のコードで、アクセスキー、_lang、botcheckハニーポット、および有効化されている場合は Turnstile が含まれます。
- list_recent_submissions — 読み取り専用、オプトイン:日時と送信されたフィールドのみ、デフォルトでスパムは除外、最大50件。
- list_webhooks、create_webhook、delete_webhook — フォームのWebhookを管理し、n8n・Make・ZapierがURLを自動で登録できるようにします。create_webhookは署名シークレットを返します。
- list_website_templates — お問い合わせフォームがすでにFormgongへ送信する無料の完成済みWebサイトテンプレート(ライブデモ、HTMLダウンロード、ソースコード)。サイトをゼロから生成せず、テンプレートから始められます。
1. サインインで接続する
Cursor、Claude、VS Code はブラウザーで Formgong を開けます。いつものメールリンクまたは Google アカウントでサインインし、ツールに許可する操作を選びます。貼り付けるものはありません。
- Cursor: 下の設定を保存します。CLIENT_ID は公開識別子 cursor です(秘密はありません)。forms:read と forms:write でフォームの一覧と作成ができます。メッセージを読む必要があるときだけ submissions:read を加えます。
- ウェブの Claude または Claude Desktop: MCP の URL でカスタムコネクタを追加します。Claude は公開クライアントを登録し、同じ承認ページを開きます。戻り先は https://claude.ai/api/mcp/auth_callback(または https://claude.com/api/mcp/auth_callback)です。
- Claude Code: 次の節のコマンドを実行し、ブラウザーのページを承認します。VS Code は自分で登録するか、識別子 vscode を使います。ローカルのツールは http://127.0.0.1 または http://localhost を使えます。
- forms:read は常に含まれます。承認ページでは、必要がない限り「最近の送信を読む」をオフのままにします。あとからダッシュボード → アカウント → 接続したアプリで切断できます。
2. API トークンを作成する
- ダッシュボード → アカウント → 「API」トークン を開きます(まずメールアドレスの確認を行ってください)。
- トークンには、それを使用するツールの名前を付けます。例:「Cursor on my laptop」など。
- アクセス権を選択してください:「フォームを作成し、Webhookを追加・削除する」はデフォルトでオンになっています。「最近の提出内容の閲覧」は、必要な場合を除きオフになっています。
- トークン(fgp_…)をコピーしてください。このトークンは一度だけ表示され、Formgongにはそのハッシュ値のみが保存されます。
{
"mcpServers": {
"formgong": {
"url": "https://formgong.com/mcp",
"headers": {
"Authorization": "Bearer ${env:FORMGONG_TOKEN}"
}
}
}
}
3. サーバーをツールに追加する
Cursor
Cursor: 下のOAuth設定をこのプロジェクトの.cursor/mcp.json、またはすべてのプロジェクトの~/.cursor/mcp.jsonに保存してください。Formgongにログインして権限を承認します。公開識別子cursorは秘密ではありません。
{
"mcpServers": {
"formgong": {
"url": "https://formgong.com/mcp",
"auth": {
"CLIENT_ID": "cursor",
"scopes": [
"forms:read",
"forms:write"
]
}
}
}
}
Claude Code
Claude Code:ターミナルで一度実行してください。
claude mcp add --transport http formgong https://formgong.com/mcp
Claude Desktop
Claude Desktop:Settings → Connectors に MCP の URL を追加します。Claude が Formgong のサインインを開きます。API トークンを貼る場合は、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: Connectors → + → MCP server。名前: Formgong。URLを入力し、Direct connectionとOAuthを選択してAdd & authorizeをクリック。Formgongにログインして権限を承認してください。代わりにBearer token or API keyで個人トークンのみを入力できます。
URL: https://formgong.com/mcp Authentication: OAuth Add & authorize → Formgong
Bolt
Bolt: Settings → Connectors (MCP) → Custom MCP server。名前: Formgong。Transport: HTTP。Authentication: MCP OAuth。Connectをクリックし、Formgongにログインして権限を承認し、プロジェクトでコネクターを有効にしてください。API keyで個人のFormgongトークンも使用できます。
Name: Formgong URL: https://formgong.com/mcp?auth=required Transport: HTTP Authentication: MCP OAuth Connect → Formgong
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ではセッションクッキーが一切機能しないため、ウェブページではログイン情報を活用することができません。
- OAuth のアクセス トークンとリフレッシュ トークンはハッシュのみ保存されます。リフレッシュ トークンは使用のたびに変わり、古いトークンを再送するとその接続は取り消されます。アカウント → 接続済みアプリから切断できます。登録は既知の MCP コールバックと http://localhost または http://127.0.0.1 のみを受け付けます。
- トークンがない場合、/mcp は initialize、ping、および tools/list への応答のみを行うため、クライアントおよび MCP ディレクトリからツール一覧を確認できます。すべてのツール呼び出しにはトークンが必要です。トークンがない場合、サーバーはトークンの追加方法を説明するエラーメッセージを返します。
制限
- トークンあたり1分間に60リクエスト、アカウントあたり120リクエスト。
- トークンを伴わないリクエスト:IPアドレスあたり1分間に30回までです。
- API を通じて、1時間あたり10件の新規フォームを処理します。
- 1アカウントにつき最大10トークンまで。
- OAuth登録はCursor、Claude、VS Codeの記載されたコールバック、lovable.devとbolt.newのHTTPSアドレス(サブドメイン、クエリ、フラグメントなし)、ローカルHTTPアドレスを受け付けます。各クライアントは登録した完全な戻り先URLに固定されます。他のクライアントはAPIトークンを使います。ログインとトークン交換はIPごとに制限されます。 Lovable: https://api.lovable.dev/workspaces/connectors/mcp/oauth/callback.