Pdfmakerapi について
Pdfmakerapi は MCP クライアントを PDFMakerAPI に接続し、文書の説明から PDF をプレビュー・編集・ダウンロードできる共有リンクを生成します。`create_document` ツールを 1 つ公開し、ローカル設定とリモート接続に対応します。
主な機能
- 01説明文から PDF を生成
- 02編集用の共有リンクを返却
- 03文書フィールドのプレビューと編集
- 04ローカル接続とリモート接続
活用シーン
- 01請求書や領収書の作成
- 02証明書やレポートの作成
- 03履歴書や契約書の作成
- 04リンク経由で文書を入力してもらう
MCP 対応
MCP サーバーは `create_document` ツールをクライアントに公開し、文書の説明を PDFMakerAPI に渡して生成物へのリンクを返します。ローカルインストールまたはリモートエンドポイント https://api.pdfmakerapi.com/mcp で接続できます。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://api.pdfmakerapi.com/mcpclaude mcp add --transport http pdfmakerapi https://api.pdfmakerapi.com/mcp{"mcpServers":{"pdfmakerapi":{"type":"http","url":"https://api.pdfmakerapi.com/mcp"}}}Cursor で開く{"servers":{"pdfmakerapi":{"type":"http","url":"https://api.pdfmakerapi.com/mcp"}}}VS Code で開く{"mcpServers":{"pdfmakerapi":{"type":"http","url":"https://api.pdfmakerapi.com/mcp"}}}{"mcpServers":{"pdfmakerapi":{"serverUrl":"https://api.pdfmakerapi.com/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
1| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| document | object | はい | 作成する PDFMakerAPI Document です。このツールの説明にある DOCUMENT MODEL に従ってください。 |
| document.id | string | いいえ | |
| document.name | string | いいえ | ドキュメント名。 |
| document.description | string | いいえ | |
| document.pageSize | string | いいえ | 「letter」 | 「a4」 | 「legal」 | 「letter-landscape」 | 「a4-landscape」 | 「square」 | 「auto」(デフォルトは「a4」。「auto」は内容に合わせて高さを拡張します。証明書や賞状に適しています)。 |
| document.pageBackgroundColor | string | いいえ | 16 進数のカラーコード。例:#ffffff。 |
| document.margin | string | いいえ | 「none」 | 「sm」 | 「md」 | 「lg」(デフォルトは「lg」)。 |
| document.gap | string | いいえ | 「none」 | 「sm」 | 「md」 | 「lg」(デフォルトは「lg」)。 |
| document.variables | array | いいえ | 宣言する変数。コンテンツで使用するすべての {{name}} をここで宣言する必要があります。 |
| document.children | array | いいえ | ドキュメント本文 — ノード(container/text/table/spacer/divider)の順序付き配列です。上記の DOCUMENT MODEL を参照してください。 |
詳細
PDFMakerAPI MCP サーバー
PDFMakerAPI 用の MCP サーバーです。PDFMakerAPI エディターで開く共有可能なリンクに、平易な英語の文書説明を変換する create_document ツールを 1 つだけ公開します。プレビューして、各フィールドを編集し、PDF をダウンロードできます。
Claude Desktop、Claude.ai、Cursor、Windsurf、Cline、Zed、VS Code、ChatGPT や、その他すべての MCP クライアントで動作します。https://api.pdfmakerapi.com の公開 API を利用する薄いクライアントのため、専用のアカウントや認証情報は必要ありません。
PDFMakerAPI とは?
PDFMakerAPI は、PDF テンプレートビルダー兼 PDF 生成 API です。文書をハードコードしたり、コンテンツが変わると崩れる HTML-to-PDF コンバーターに苦労したりする代わりに、ビジュアルなノーコードエディターで再利用可能なテンプレートを一度デザインできます。テキスト、テーブル、画像、動的フィールドを好きな場所に配置し、データを入力して、完成した編集可能な PDF を生成します。
1 件の文書から数千件まで生成できます。テンプレートに自分で入力したり、誰でもブラウザーで入力可能な PDF フォームを完成させられるリンクを共有したり、REST API に JSON を送信したり、Zapier、Make、n8n などのノーコードツールから生成を実行したり、Claude や ChatGPT のような AI エージェントから直接文書を作成したりできます。プロンプトから始めたい場合は、必要なものを説明すれば Quill が作成します。
チームは、請求書、領収書、証明書、レポート、契約書など、データが変わるたびに手作業で作り直していたあらゆる文書に PDFMakerAPI を利用しています。毎月 100 件の PDF を無料で作成できます。
クイックインストール
ワンクリック:
または同じ設定を手動で追加(すべてのデスクトップクライアントで動作します):
{
"mcpServers": {
"pdfmakerapi": {
"command": "npx",
"args": ["-y", "@pdfmakerapi/mcp"]
}
}
}
クライアント別のセットアップ
Claude Desktop
Settings → Developer → Edit Config(claude_desktop_config.json)を開き、上記の mcpServers ブロックを追加して、Claude を再起動します。
Cursor
Add to Cursor ボタンを使うか、ブロックを ~/.cursor/mcp.json(グローバル)または .cursor/mcp.json(プロジェクトごと)に追加します。
Windsurf
ブロックを ~/.codeium/windsurf/mcp_config.json に追加します(または Settings → Cascade → MCP から追加します)。
Cline
Cline → MCP Servers → Configure を開き、mcpServers ブロックを追加します。
VS Code
Install in VS Code ボタンを使うか、.vscode/mcp.json に追加します(注:VS Code では servers キーを使用します)。
{
"servers": {
"pdfmakerapi": { "command": "npx", "args": ["-y", "@pdfmakerapi/mcp"] }
}
}
Zed
settings.json に追加します:
{
"context_servers": {
"pdfmakerapi": { "command": { "path": "npx", "args": ["-y", "@pdfmakerapi/mcp"] } }
}
}
クライアントがリモート MCP サーバーに対応している場合は、ホストされたエンドポイントを指定するだけです。npx も Node も不要です。
https://api.pdfmakerapi.com/mcp
- Claude.ai(ウェブ): Settings → Connectors → Add custom connector → URL を貼り付けます。
- ChatGPT(Plus/Pro/Enterprise): Settings → Connectors → URL を追加します。
- Cursor など:
command/argsの代わりに{ "url": "https://api.pdfmakerapi.com/mcp" }を追加します。
使い方
アシスタントにドキュメントを依頼します。
「Acme のプロフェッショナルな請求書を、明細項目 3 件で作成してください。」 「コース修了証を作成してください。」 「すっきりとした 1 ページの履歴書を作成してください。」
create_document を呼び出し、https://app.pdfmakerapi.com/d/<id> のようなリンクを返します。リンクを開くと、プレビューの表示、各フィールドの編集、PDF のダウンロードができます。
設定
| 環境変数 | デフォルト値 | 用途 |
|---|---|---|
PDFMAKERAPI_BASE_URL | https://api.pdfmakerapi.com | 別の API を指定します(例:ローカル開発の場合は http://localhost:3001)。 |
開発
git clone https://github.com/GerardoBarrera/pdfmakerapi-mcp.git
cd pdfmakerapi-mcp
npm install
npm run build # compile to dist/
npm run dev # run from source (tsx)
トラブルシューティング
- クライアントにサーバーが表示されない — MCP 設定を編集した後にクライアントを再起動し、JSON が有効であること(末尾に余分なカンマがないこと)を確認してください。リモートクライアントの場合は、URL が正確に
https://api.pdfmakerapi.com/mcpであることを確認してください。 npxの起動に失敗する — Node.js 18 以降がインストールされていること(node -v)を確認してから、npx -y @pdfmakerapi/mcp@latestを再実行してください。- リモートエンドポイントへの接続エラー/タイムアウト — ネットワーク/プロキシで
api.pdfmakerapi.comへの HTTPS 接続が許可されていること、および Streamable HTTP トランスポートを使用していることを確認してください。 - 「ドキュメントが大きすぎます」 — ドキュメントの JSON サイズは約 1 MB までです。大きな表を縮小するか、複数のドキュメントに分割してください。
- 返されたリンクを開けない — ドキュメント ID で終わるリンク全体をコピーしてください。404 エラーになる場合は、ドキュメントを再生成してください。
- 解決しない場合 — GitHub のイシューを作成するか、[email protected] にメールでお問い合わせください。
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。