接続ガイド

まず URL を追加し、クライアント側の初回認証後に使い始めます。

まずはお使いの AI クライアントに MCP サーバー URL を登録してください。接続方法の確認や URL の登録はアカウント不要です。実際に使い始める際は、クライアント側の初回認証フローからログインまたは新規登録できます。

始めるまでの3ステップ

1

MCP追加画面を開く

普段使っている AI クライアントで、MCP サーバーを追加する画面を開きます。

2

URLを登録

AIクライアントの MCP 追加画面に FORMLOVA の URL を登録します。

3

初回認証で開始

最初に FORMLOVA を使うタイミングで、クライアント側の認証フローからログインまたは新規登録します。

先にアカウントを作りたい場合はこちら。無料でアカウントを作成

一番かんたんな始め方

お使いの AI チャットに「MCP サーバーを追加する方法を教えて」と聞いてみてください。追加画面を開けたら、以下の URL を貼り付けて保存してください。

MCPサーバーURL

以下のURLをクライアントの MCP 設定に登録してください。

https://formlova.com/api/mcp

設定画面の場所や追加手順は、クライアント側の更新で予告なく変わることがあります。迷ったときはAIクライアントにそのまま「MCPサーバーの追加方法を教えて」と聞くのが早いかもしれません。

対応クライアント

主要クライアントの接続例です。追加画面や再読み込みの挙動はクライアントごとに異なります。

Web / アプリ

Claude

Claude

通常の追加手順

Claude の設定 > コネクタ から追加

公式ドキュメント
ChatGPT

ChatGPT

通常の追加手順

ChatGPT は開発者モード時に 設定 > アプリ > 高度な設定(アプリを作成する)

公式ドキュメント

開発ツール

一発セットアップ(任意)

開発ツール向け。プロジェクトに設定ファイルをまとめて生成します。認証完了やクライアント側の再読み込みは別途必要です。

bash
npx -y formlova-mcp install --client all --scope project --yes

公開 helper リポジトリ

README、補助 CLI、サンプル設定はこの公開リポジトリにまとめています。

https://github.com/formlova/formlova-mcp
Claude Code

Claude Code

通常の追加手順

Claude Code CLI から追加

bash
claude mcp add --transport http formlova https://formlova.com/api/mcp
公式ドキュメント
Gemini CLI

Gemini CLI

通常の追加手順

Gemini CLI の mcp add でサーバーを追加

bash
gemini mcp add --transport http formlova https://formlova.com/api/mcp
公式ドキュメント
Codex

Codex

通常の追加手順

Codex CLI から追加

bash
codex mcp add formlova --url https://formlova.com/api/mcp
公式ドキュメント
Cursor

Cursor

通常の追加手順

Settings > MCP > Add new MCP server

設定ファイルで追加する場合

json
{
  "mcpServers": {
    "formlova": {
      "url": "https://formlova.com/api/mcp"
    }
  }
}
公式ドキュメント

クライアント側の設定画面や追加手順は予告なく変わることがあります。

まず、これを打ってみてください

初回認証が終わり、クライアント側でツールが読み込まれたら、チャットに話しかけるだけ。

「フォーム作って」

目的をヒアリングしてフォームを作成し、URLを返します。

「このスクショに寄せて」

スクリーンショットの雰囲気をフォームのデザインに反映します。

「今の状況を見せて」

全フォームの回答数やステータスをまとめて確認できます。

トラブルシューティング

接続できない+

URL が正しいか確認してください。どのクライアントでも https://formlova.com/api/mcp を使用します。余分なスラッシュや文字がないかもご確認ください。

認証画面が表示されない+

ブラウザのポップアップブロッカーが原因の可能性があります。formlova.com のポップアップを許可してから、もう一度お試しください。

認証後にクライアントに戻れない+

ブラウザで FORMLOVA にログインした状態で、クライアント側から再度接続してください。クライアントによっては手動でウィンドウを切り替える必要があります。

ツールが表示されない+

クライアントを再起動してください。初回接続後はツール一覧の読み込みに時間がかかる場合があります。再起動後も表示されない場合は、接続を削除して再追加してください。

ツールが一部しか表示されない+

クライアントを再起動してください。ツール一覧の更新が反映されていない可能性があります。再起動後も変わらない場合は、接続を一度削除して再追加してください。

公開フォーム URL を渡したのに項目を再現できない+

ログインが必要なページや、外部から見えない private URL は抽出できません。誰でも開ける公開フォーム URL を使ってください。

スクショに寄せたけど完全に同じ見た目にならない+

スクショだけだと exact なフォント名や hover 状態、隠れた要素までは分からないことがあります。公開画像 URL や公開ページ URL を補助で渡すと精度が上がります。

外部フォームを複製したら一部の挙動が違う+

visible な項目構造は再現できますが、元サービス固有の確認用メール一致チェックや複雑な条件分岐は clone 後に見直しが必要な場合があります。

「Unauthorized」エラーが出る+

ログイン状態が切れているか、クライアント側の認証がうまく完了していない可能性があります。接続を一度削除してから再追加し、認証をやり直してください。

helper の install を実行したのに使えない+

install は設定ファイルを生成するだけです。クライアントを開き直すか MCP 設定を再読み込みし、その後に最初の利用で認証フローを完了してください。

ChatGPT で接続エラーになる+

ChatGPT では開発モードを有効にしたあとに Add MCP を使ってください。Settings & Integrations の一覧と Add MCP は別導線です。URL が https://formlova.com/api/mcp になっているか確認し、/api/sse の設定がある場合は削除して /api/mcp で再追加してください。

Cursor でステータスが赤い+

設定画面で URL が正しいか確認し、一覧の「Reconnect」ボタンをクリックしてください。それでも解決しない場合は、設定を削除して再追加してください。

フォームが作成できない /「プラン制限」と言われる+

フォーム作成は無料プランでも無制限です。このエラーが出た場合は、ログアウトしてから再ログインしてください。改善しない場合はブラウザのキャッシュをクリアしてお試しください。

日本語で話しかけているのに英語で返ってくる+

プロフィール設定で言語を日本語に変更してください。チャットで「プロフィールの言語を日本語にして」と話しかけるだけで変更できます。

ファイルアップロードでエラーが出る+

対応形式は PDF、Word、Excel、PowerPoint、画像(JPEG / PNG / GIF / WebP)、テキスト、CSV、ZIP です。1ファイルあたりの上限は10MBです。これらの条件を超えている場合はアップロードできません。ファイルアップロードはスタンダードプラン以上で利用可能です。

フォームに表示されないフィールドタイプがある+

FORMLOVA は29種のフィールドタイプに対応しています。hidden_field は回答者に表示されず、UTM パラメータやトラッキング用途に使います。statement と section_break は入力不要の表示要素で、説明文やフォームの区切りに使います。これらは意図的に非表示または入力不要になっています。

メールが届かない+

メール送信クォータを確認してください。月間上限は無料プラン100通、スタンダードプラン1,000通、プレミアムプラン10,000通です。上限に達した場合、翌月1日にリセットされます。配信停止リストに含まれている受信者には送信されません。

フォームの表示が遅い+

フィールド数が多い場合はページ分割をお試しください。フォーム作成時にページ番号を指定することで、複数ページに分割できます。

接続できましたか?

使い方ガイドでFORMLOVAの全機能とプロンプト例を確認できます。

使い方を見る

まだアカウントをお持ちでない方 無料ではじめる