Formswrite

Formswrite MCP

Claude Desktop、Cursor、Claude Codeなどの MCP クライアントをFormswrite API に接続します。

ドキュメントを Google Forms に変換したり、質問を編集したり、フォームを一覧表示・公開したり、AI フォームアシスタントのツールを実行したりできます。すべて LLM から操作できます。

できること

インストールすると、LLM から Formswrite のツールセットを利用できるようになります。

• create_form — Google Doc、PDF、または貼り付けたテキストから Formswrite ジョブを作成します
• get_form_data — フォームの現在の質問、選択肢、メタデータを読み取ります
• modify_questions — 質問の追加、編集、削除、並べ替えを行います
• update_form_metadata — タイトル、説明、または導入文を更新します
• publish_form — 下書きフォームを公開して回答を受け付けられるようにします
• export_form — フォームを Google Forms、Moodle、Kahoot、Quizizz、Canvas、およびその他 25 以上の形式にエクスポートします
• list_jobs / get_job — 変換ジョブを一覧表示して確認します

インストール

1. API トークンを取得する

Formswrite ダッシュボードにサインインし、以下で API トークンを作成します。 https://app.formswrite.com/settings/api-tokens

2. MCP クライアントに追加する

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）を編集します。

{
  "mcpServers": {
    "formswrite": {
      "command": "npx",
      "args": ["-y", "@formswrite/mcp"],
      "env": {
        "FORMSWRITE_API_TOKEN": "fw_..."
      }
    }
  }
}

Claude Desktop を再起動します。ツール一覧に Formswrite のツールが表示されます。

Cursor

Settings → MCP で、以下を追加します。

{
  "formswrite": {
    "command": "npx",
    "args": ["-y", "@formswrite/mcp"],
    "env": { "FORMSWRITE_API_TOKEN": "fw_..." }
  }
}

Claude Code

claude mcp add formswrite -- npx -y @formswrite/mcp

次に、トークンを ~/.claude/settings.json に設定します。

{ "env": { "FORMSWRITE_API_TOKEN": "fw_..." } }

Streamable HTTP に直接接続する（npm 不要）

クライアントが Streamable HTTP トランスポートにネイティブ対応している場合（Cursor 0.45 以降、ChatGPT MCP、最近の Claude Desktop）、このパッケージを使わずに直接接続できます。

URL:    https://mcp.formswrite.com/mcp
Header: Authorization: Bearer fw_...

仕組み

このパッケージは、stdio と Streamable HTTP をつなぐ小さなブリッジです。マシン上でローカルに実行され、API トークンを使って https://mcp.formswrite.com/mcp への接続を開き、MCP クライアント（stdio）と Formswrite サーバー（HTTP）の間で JSON-RPC メッセージを転送します。

すべてのツールのロジックは Formswrite のバックエンドにあります。このパッケージにはビジネスロジックは含まれておらず、フォームデータを転送する以外の目的で扱うこともありません。

設定

環境変数	必須	デフォルト	説明
FORMSWRITE_API_TOKEN	はい	—	Formswrite ダッシュボードで取得した API トークン
FORMSWRITE_MCP_URL	いいえ	https://mcp.formswrite.com/mcp	ステージング環境またはセルフホスト環境で使う URL の上書き

トラブルシューティング

診断出力は stderr に書き込まれます（stdout は JSON-RPC チャネルです）。ログを確認するには、次の手順を実行します。

• Claude Desktop：MCP ログパネルを開きます（Settings → Developer）
• CLI：FORMSWRITE_API_TOKEN=... npx @formswrite/mcp 2>&1 >/dev/null を実行します

よくある問題：

• Missing token — クライアントの MCP env ブロックに FORMSWRITE_API_TOKEN が設定されていません
• 401 unauthorized — トークンが無効か期限切れであるか、環境が間違っています。上記のダッシュボード URL で新しいトークンを生成してください
• 429 rate_limited — 60 req/min の上限を超えています。リクエストを減らしてください

ライセンス

MIT — LICENSE を参照してください。

リンク

• Formswrite：https://formswrite.com
• ダッシュボード：https://app.formswrite.com
• 問題の報告：https://github.com/formswrite/formswrite-mcp/issues
• MCP 仕様：https://modelcontextprotocol.io