Formasty

Formasty MCP

AI エージェントから、本番環境ですぐに使えるフォーム、クイズ、アンケート、ワークフロー、回答パイプラインを構築・運用できます。

これは、Formasty 公式リモート Model Context Protocol（MCP）サーバーの公開ドキュメントリポジトリです。Formasty アプリケーションとバックエンドは非公開のままです。このリポジトリには、サーバーの実装、インフラストラクチャの設定、顧客データ、認証情報は意図的に含まれていません。

接続

設定	値
サーバー名	formasty
リモート MCP URL	https://app.formasty.com/api/mcp
トランスポート	Streamable HTTP
レガシー SSE URL	https://app.formasty.com/api/mcp/sse
認証	OAuth。開発者が制御するクライアント向けに API キーでの認証にも対応
公式レジストリ名	com.formasty/form-builder

リモート MCP サーバーに対応したクライアントでは、https://app.formasty.com/api/mcp を追加し、Formasty の OAuth フローを完了してください。このリポジトリはドキュメント専用です。サーバーとしてクローンしたり実行したりしないでください。

Claude

Claude で Customize > Connectors を開き、カスタムコネクターを追加して、リモート MCP URL を入力し、Formasty で認証してください。同じコネクターを、リモート MCP に対応したすべての Claude サーフェスで使用できます。

Cursor

Formasty プラグインが Cursor Marketplace で承認された後、Cursor Settings > Plugins からインストールするか、次を実行してください。

/add-plugin formasty

Marketplace で承認される前に手動で接続するには、ユーザーまたはプロジェクトの MCP 設定に次を追加してください。

{
  "mcpServers": {
    "formasty": {
      "url": "https://app.formasty.com/api/mcp"
    }
  }
}

Cursor はリモート MCP サーバー向けに Streamable HTTP と OAuth に対応しています。

VS Code と GitHub Copilot

次をユーザープロファイルまたはワークスペースの mcp.json に追加してください。

{
  "servers": {
    "formasty": {
      "type": "http",
      "url": "https://app.formasty.com/api/mcp"
    }
  }
}

Cline

Cline のリモートサーバー UI を使用するか、CLI からインストールしてください。

cline mcp install formasty --transport http https://app.formasty.com/api/mcp

ChatGPT

MCP アプリの開発者アクセス権があるワークスペースで、MCP サーバー URL として https://app.formasty.com/api/mcp を指定してカスタムアプリを作成し、OAuth を完了して、ワークスペースに公開する前に要求されたツールの権限を確認してください。

Gemini CLI

GitHub から Formasty 公式の Gemini CLI 拡張機能をインストールしてください。

gemini extensions install https://github.com/QuantumCoderSys/formasty-mcp

Gemini CLI を再起動し、/mcp list を実行してください。認証を求められた場合は、/mcp auth formasty で OAuth を完了してください。ルートの gemini-extension.json でホスト型 Streamable HTTP エンドポイントを設定します。バックエンドのパッケージやローカルサーバープロセスはインストールされません。

互換性ブリッジ

旧バージョンの Claude Desktop など、stdio のみ対応するクライアントでは、リモートブリッジを使用してください。

{
  "mcpServers": {
    "formasty": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.formasty.com/api/mcp"
      ]
    }
  }
}

Formasty API キーを公開リポジトリ、共有設定、issue、スクリーンショットに記載しないでください。ユーザー向けクライアントには OAuth を推奨します。

エージェントとマーケットプレイスの審査担当者は、簡潔なインストールおよび検証手順として llms-install.md を利用できます。Gemini CLI には、GEMINI.md による対象を絞った操作ガイダンスも提供されています。

エージェントでできること

• フォームを新規作成するか、Formasty のスターターテンプレートから作成します。
• リード獲得フォーム、アンケート、受付フォーム、申込フォーム、予約フォーム、ウェイトリスト、投票、クイズを作成します。
• ステップやフィールドの追加、更新、移動、並べ替え、削除を行います。
• テーマ、カバー、スケジュール、設定、お礼画面、終了画面を設定します。
• 条件付きワークフロー、変数、ルーティングルール、マッチングクイズ、スコアクイズを作成します。
• 公開前に下書きを検証および監査します。
• フォームを公開し、共有、埋め込み、接続用のアセットを取得します。
• ユーザー権限に応じて、送信内容を読み取り、管理し、回答のエクスポートを作成します。
• 対応する Webhook、アナリティクスピクセル、タグマネージャー、カスタムドメインを設定します。
• 対応する Google Forms および Typeform のフォームをインポートします。

現在の公開コントラクトでは、75 件の操作を利用できます。最新かつ正式なスキーマと安全性に関する注釈については、TOOLS.md を参照するか、MCP の tools/list を使用してください。

認証と権限

OAuth 接続は、サインインしている Formasty ユーザーとして動作します。ツールへのアクセスは、引き続き以下の制限を受けます。

• OAuth スコープまたは API キーのスコープ
• ワークスペースのメンバーシップとロール権限
• 選択したワークスペースへのアクセス権
• Free、Pro、Business の機能制限
• 楽観的ドラフトリビジョンとサーバー側の検証
• 影響の大きい操作に対するホストおよびユーザーの明示的な承認

公開ディスカバリーで確認できるのは、ツール定義のみです。ツールの呼び出しやワークスペースデータへのアクセスには、認証が必要です。

便利なリンク

• Formasty
• ドキュメント
• 公式 MCP Registry エントリー
• プライバシーポリシー
• セキュリティ
• 利用規約
• データ処理契約

セキュリティとプライバシー

脆弱性を報告する前に SECURITY.md を、MCP 固有のデータフローについては PRIVACY.md をお読みください。公開イシューには、アクセストークン、API キー、フォームの回答、顧客データ、非公開のフォーム URL、または実際のワークスペースから取得した再現データを記載しないでください。

サポート

アカウント、請求、プライバシー、またはセキュリティ上の機密性が高いサポートについては、SUPPORT.md をご覧いただくか、[email protected] までメールでお問い合わせください。

ライセンス

このリポジトリのドキュメントとメタデータは、MIT License のもとで提供されています。ホスト型 Formasty サービスの利用には、Formasty 利用規約 が適用されます。