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 アカウントでサインインし、ツールに許可する操作を選びます。貼り付けるものはありません。

  1. Cursor: 下の設定を保存します。CLIENT_ID は公開識別子 cursor です(秘密はありません)。forms:read と forms:write でフォームの一覧と作成ができます。メッセージを読む必要があるときだけ submissions:read を加えます。
  2. ウェブの Claude または Claude Desktop: MCP の URL でカスタムコネクタを追加します。Claude は公開クライアントを登録し、同じ承認ページを開きます。戻り先は https://claude.ai/api/mcp/auth_callback(または https://claude.com/api/mcp/auth_callback)です。
  3. Claude Code: 次の節のコマンドを実行し、ブラウザーのページを承認します。VS Code は自分で登録するか、識別子 vscode を使います。ローカルのツールは http://127.0.0.1 または http://localhost を使えます。
  4. forms:read は常に含まれます。承認ページでは、必要がない限り「最近の送信を読む」をオフのままにします。あとからダッシュボード → アカウント → 接続したアプリで切断できます。

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

  1. ダッシュボード → アカウント → 「API」トークン を開きます(まずメールアドレスの確認を行ってください)。
  2. トークンには、それを使用するツールの名前を付けます。例:「Cursor on my laptop」など。
  3. アクセス権を選択してください:「フォームを作成し、Webhookを追加・削除する」はデフォルトでオンになっています。「最近の提出内容の閲覧」は、必要な場合を除きオフになっています。
  4. トークン(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.

AI builder prompts · Agent rules files