Clipform

@clipform/mcp-server

Clipform 向けの MCP サーバーです。Claude、ChatGPT、Cursor、Windsurf など、あらゆる MCP クライアントから動画形式のフォームを作成・管理できます。

インストール

接続方法は 2 つあります。リモート（推奨。Clipform アカウントを使用）とローカル（匿名。無料プランの制限が適用されます）です。

リモート（推奨）

Clipform アカウントをお持ちの場合に使用してください。フォームはワークスペースに直接作成され、契約プランが適用されます（Pro ではノード数の上限は 3 ではありません）。

Claude（claude.ai）： Settings → Connectors → Add custom connector → https://mcp.clipform.io を入力

ChatGPT： Settings → Connectors → Advanced → Developer Mode を有効化 → Create connector → https://mcp.clipform.io を入力（Pro／Team／Enterprise が必要です）

OAuth 対応の MCP クライアント： https://mcp.clipform.io を指定してください。検出、登録、認証は OAuth 2.1 と Dynamic Client Registration（RFC 7591）を通じて自動的に処理されます。

ローカル - Claude Code / Claude Desktop / Cursor / など

stdio ベースの MCP クライアントで使用します。API キーを渡して、ワークスペースと契約プランに対する認証を行います。

Claude Code：

claude mcp add clipform -e CLIPFORM_API_KEY=cf_xxx -- npx -y @clipform/mcp-server

Claude Desktop / Cursor / Windsurf / OpenClaw - MCP 設定に追加します：

{
  "mcpServers": {
    "clipform": {
      "command": "npx",
      "args": ["-y", "@clipform/mcp-server"],
      "env": {
        "CLIPFORM_API_KEY": "cf_xxx",
        "API_URL": "https://api.clipform.io"
      }
    }
  }
}

Clipform ダッシュボードの Developers > API keys で API キーを生成してください。ローカルサーバーには常に API キーが必要です。アカウントなしで Clipform を試すには、代わりに https://mcp.clipform.io に接続してください（「仕組み」を参照）。

環境変数

変数	必須	用途
CLIPFORM_API_KEY	ワークスペース認証に必要	Bearer キーです。フォームはこのキーのワークスペースに作成され、その契約プランの制限が適用されます。また、クリエイティブツール（検索、TTS、動画レンダリング）も利用できるようになります。ローカルサーバーでは必須です。
API_URL	はい	Clipform API のベース URL（https://api.clipform.io、またはローカル／セルフホストの API）です。

ツール

接続すると、MCP クライアントがこれらを自動的に一覧表示します（tools/list 経由）。引数、スキーマ、使用例を含む完全なリファレンスはドキュメントを参照してください。

ツール	説明
clipform_create_form	新しい Clipform（インタラクティブな動画形式のフォーム）を作成します。
clipform_import_form	公開されている Google Form、Typeform、または Tally フォームの質問を、新しい Clipform の下書きにコピーします。
clipform_list_forms	オプションのフィルターを指定して、ワークスペース内のフォームを一覧表示します。
clipform_whoami	現在の ID、認証モード（api key、oauth、session、anonymous）、アクティブなワークスペース、プランの上限を表示します。
clipform_get_form	順番に並んだすべてのノードとそのルーティングを含む、フォームの詳細を取得します。
clipform_update_form	フォームのタイトル、公開ステータス、設定、またはタグを更新します。
clipform_delete_form	フォームとすべてのノードをごみ箱に移動します。
clipform_get_results	フォームの回答数、選択肢・アクション別の回答内訳、最近の自由記述回答を表示します。
clipform_get_responses	時間で絞り込んで、Clipform フォームの個別の回答（送信内容）を一覧表示します。集計結果を表示する clipform_get_results を補完します。
clipform_add_node	既存のフォームに新しいノードを追加します。
clipform_update_node	既存のノードのテキスト、タイプ、設定、または選択肢を更新します。
clipform_delete_node	フォームからノードを削除します。
clipform_upload_media_asset	1 つ以上のメディアファイルをワークスペースのメディアライブラリに追加します（最大 10 個。順次アップロードされます）。
clipform_complete_media_upload	clipform_upload_media_asset が返す upload_url にバイトデータを PUT した後、署名付き PUT による静止画のアップロードが完了したことを確認します。
clipform_attach_node_media	既存のワークスペースメディアアセット（clipform_upload_media_asset で追加したもの）を、1 つ以上のノードに添付します（最大 10 個）。
clipform_get_node_media	処理ステータスを含む、ノードに添付されたメディアを取得します。
clipform_delete_node_media	リンクを解除してノードからメディアを削除します。メディアアセットとそのファイルはワークスペースのライブラリに残り、ほかのノードや使用中の公開フォームでは引き続き利用できます。
clipform_set_logic	1 つ以上のノードの次のノードを設定し、直線的なルート（A から B、B から C）を接続します。
clipform_log_generation	フォーム生成ワークフローによって実行される内部監査ステップです。
clipform_search_news	NewsAPI と The Guardian の最近のニュース記事を検索し、構造化された結果として返します。
clipform_generate_tts	テキストから、単語単位の字幕付きナレーション音声を生成します。
clipform_search_media	画像またはストック動画クリップを検索します。
clipform_render_composition	動画テンプレートでは作成できない、地理アニメーションやデザインされたモーショングラフィックスなどのカスタムアニメーションビジュアルを、専用の動画コンポジションとして MP4 または PNG にレンダリングします。
clipform_search_music	ロイヤリティフリーの音楽トラックや環境音を検索します。
clipform_list_compositions	利用可能な動画コンポジションと、想定される props スキーマを確認します。
clipform_list_video_templates	利用可能な動画テンプレートを確認します。動画テンプレートは、少数のコントロールオブジェクトを使って Scene コンポジション経由でレンダリングされる、厳選された Scene の構成（bed + overlay + 適切なデフォルト設定）です。
clipform_render_video_template	少数のコントロールオブジェクトから、厳選された動画テンプレート（事前構成済みの Scene：bed + overlay + 適切なデフォルト設定）を MP4 または PNG にレンダリングします。Scene レイヤーを手動で組み立てる必要はありません。
clipform_list_assets	動画コンポジション用のクリエイティブアセット（効果音、アニメーション、フォント）を一覧表示します。
clipform_check_render	clipform_render_video_template または clipform_render_composition で開始したレンダリングジョブのステータスを確認します。
clipform_fetch_boundary	国、都市、または地域の GeoJSON 境界ポリゴンを取得します。
clipform_get_guide	特定のフォームタイプの作成に関するノウハウを取得します。
clipform_get_workflow	特定のフォームタイプを作成するための、手順を追った構築ワークフローを取得します。

例

「Customer Feedback」という Clipform を作成します。「弊社のサービスをどのように評価しますか？」という選択式の質問を作成し、選択肢を「Excellent」「Good」「Fair」「Poor」にします。次に「ほかにご意見はありますか？」という自由回答形式の質問を追加し、最後に「フィードバックをお寄せいただき、ありがとうございます！」と表示する終了画面を設定します。

仕組み

リモート（OAuth）： ベアラートークンは https://mcp.clipform.io（RFC 8707）を対象とし、スコープは mcp のみです。デフォルトでは、フォームは同意時に承認したワークスペースに直接作成されます。同じ会社で所属しているすべてのワークスペースに、1つの接続でアクセスできます。clipform_create_form、clipform_import_form、clipform_list_forms、clipform_upload_media_asset、clipform_generate_tts では workspace_id（clipform_whoami から取得できる ID）を渡すか、任意のフォームツールで別のワークスペースにある form_id を渡してください。これには clipform_upload_media_asset、clipform_generate_tts、clipform_complete_media_upload も含まれます。これらの場合、form_id はルーティングのヒントとしてのみ使われます（結果は引き続きそのワークスペースのメディアライブラリに保存され、ノードには追加されません）。メンバーシップは呼び出しごとに再確認され、結果にはワークスペース名が含まれます。

API キーを使ったローカル接続： CLIPFORM_API_KEY は標準の Authorization: Bearer ヘッダーで送信されます。フォームはキーが属するワークスペースに直接作成され、プランの上限が適用されます。

リモートの匿名接続（サインイン不要）： サインインせずに https://mcp.clipform.io に接続すると、そのセッション専用の一時アカウントが作成されます。コンテンツチェック後、フォームは作成時に公開され、最大3件の回答を受け付けます。サインアップしない場合は7日後にオフラインになります。アカウントが必要な機能（支払い、アップロード、ダウンロード、予約、外部リンク）は、サインアップするまで無効になります。フォームの作成結果には、一時的なサインアップリンクが含まれます。このリンクを使うとフォームが新しいアカウントに移行されます（最初のフォームの作成後、その後は定期的に、またはフォーム上限に達したときに表示されます）。すでにアカウントをお持ちの場合は、「sign in」と伝えてください。こうした機能を含む、アカウントに移行済みのフォームは下書きとして作成されるため、機能を有効にするには公開してください。移行前のフォームを編集する際の認証情報は、フォームの UUID です。無料プランの上限が適用されます。ローカルの stdio サーバーでは、常に CLIPFORM_API_KEY が必要です。

以下のツールには、サインイン済みの Clipform アカウント（OAuth または API キー）が必要です：clipform_list_forms、clipform_whoami、clipform_get_results、clipform_get_responses、clipform_delete_form。これらのいずれかを呼び出した匿名のリモートセッションには、代わりにサインインを求めます（結果を取得するツールでは、「このフォームの回答を確認するにはサインインしてください」と表示されます）。clipform_get_guide、clipform_get_workflow、clipform_list_assets を含む、それ以外のすべての機能はアカウントなしで利用できます。

フォームには開始ノードと終了画面が自動的に作成されるため、その間にノードを追加するだけです。

リンク

• Clipform - インタラクティブ動画フォームを作成
• ドキュメント - ノードの種類などを含む完全ガイド

制作ガイド（clipform://guides/*、clipform_get_guide）は実行時に Clipform API から取得されるため、これらを提供するには、サーバーから API_URL に到達でき、CLIPFORM_API_KEY が有効である必要があります。