formpaste

formpaste-mcp

コーディングエージェントから問い合わせフォームを作成し、ページに組み込めます。フォーム、スニペット、送信内容を扱う6つのツールを提供します。

これは何ですか

このパッケージは、ホスト型 Formpaste MCP サーバー（https://api.formpaste.com/mcp、streamable-http トランスポートを使用）を指定して mcp-remote を起動する軽量なラッパーです。手動で設定する mcp-remote の構成も同じように動作します。このパッケージがあるのは主に、手動設定ではできないことを実現するためではなく、エージェントやクライアントが Formpaste の MCP サーバーを名前で見つけてインストールできるようにするためです。

要件

• Node.js 18 以降
• Formpaste アカウント
• Formpaste ダッシュボードの Settings -> API & MCP で発行した API トークン

インストール

以下の各クライアントは、ホスト型 MCP エンドポイント https://api.formpaste.com/mcp に接続するよう設定されています。fpat_YOUR_TOKEN を Settings -> API & MCP で発行したトークンに置き換えてください。

Claude Code

claude mcp add formpaste --transport http https://api.formpaste.com/mcp \
  --header "Authorization: Bearer fpat_YOUR_TOKEN"

Codex

# ~/.codex/config.toml
[mcp_servers.formpaste]
command = "npx"
args = ["mcp-remote", "https://api.formpaste.com/mcp", "--header", "Authorization: Bearer fpat_YOUR_TOKEN"]

Cursor

// .cursor/mcp.json
{
  "mcpServers": {
    "formpaste": { "command": "npx", "args": ["mcp-remote", "https://api.formpaste.com/mcp", "--header", "Authorization: Bearer fpat_YOUR_TOKEN"] }
  }
}

Claude Desktop

// claude_desktop_config.json
{
  "mcpServers": {
    "formpaste": { "command": "npx", "args": ["mcp-remote", "https://api.formpaste.com/mcp", "--header", "Authorization: Bearer fpat_YOUR_TOKEN"] }
  }
}

VS Code

// .vscode/mcp.json
{
  "servers": {
    "formpaste": { "command": "npx", "args": ["mcp-remote", "https://api.formpaste.com/mcp", "--header", "Authorization: Bearer fpat_YOUR_TOKEN"] }
  }
}

このパッケージを使う任意の MCP クライアント

FORMPASTE_TOKEN=fpat_YOUR_TOKEN npx formpaste-mcp

formpaste-mcp は環境変数 FORMPASTE_TOKEN（または --token フラグ）からトークンを読み取り、ホスト型エンドポイントに接続する mcp-remote を起動します。

6つのツール

ツール	用途	スコープ
create_form	フォームを作成し、アクセスキーと組み込み用スニペットを返します	setup
get_snippet	html/react/nextjs/astro/vue/svelte 用のコピー＆ペースト可能なスニペットを返します	setup
list_forms	ID、名前、アクセスキー、受信トレイ／スパム件数とともに、すべてのフォームを一覧表示します	setup
get_form	フォームの設定を読み取り、正しく組み込まれていることを確認します	setup
send_test_submission	テスト送信を保存し、フォームが稼働中であることを確認します	setup
list_submissions	必要に応じてメッセージ本文を含め、送信内容を一覧表示します	full

トークンのスコープ

Formpaste API トークンには2つのスコープがあります。

• full では、list_submissions による送信内容の読み取りを含め、すべての操作を実行できます。
• setup では、list_submissions を除くすべての操作を実行できます。そのため、第三者からの送信内容を読み取ることはありません。

エージェントには setup スコープのトークンを使用してください。フォームの作成、スニペットの取得、フォームが正しく組み込まれていることの確認が可能で、フォームで収集したデータへのアクセス権は付与されません。

使用例

examples/wire-a-form.md で、フォームの作成、スニペットの取得、ページへの貼り付け、テスト送信、フォームが正しく組み込まれていることの確認までを順に説明しています。

リンク

• ドキュメント：https://formpaste.com/docs
• MCP サーバーのドキュメント：https://formpaste.com/docs/agents/mcp-server
• インストールガイド：https://formpaste.com/docs/agents/install
• 問題の報告：https://github.com/webrating/formpaste-mcp/issues