DocMake について
DocMake の MCP サーバーは、ワークスペースのテンプレートから DOCX と PDF を生成します。テンプレートへの入力、項目の確認、DOCX からのテンプレート作成を行う AI アシスタント向けです。
主な機能
- 01ワークスペースのテンプレート一覧と確認
- 02テンプレートを PDF または DOCX に変換
- 03schema JSON からテンプレートを作成
- 04ローカルの DOCX をテンプレートとして取り込み
- 05テンプレートを MCP リソースとして公開
活用シーン
- 01テンプレートから請求書を生成
- 02契約テンプレートの必須項目を確認
- 03既存の DOCX を再利用可能なテンプレートに変換
MCP 対応
MCP クライアントに 6 種類のツール、テンプレートリソース、文書生成プロンプトを提供します。ローカルの stdio 接続と、ホスト型の Streamable HTTP エンドポイントに対応します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @docmake/mcpDOCMAKE_API_KEYシークレットDocMake API key, created at app.docmake.io under Settings > API KeysDOCMAKE_OUTPUT_DIRDirectory rendered documents are saved to. Defaults to ~/Downloads/DocMakeDOCMAKE_API_BASEAPI base URL, for self-hosted setups. Defaults to https://app.docmake.io/api/v1ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
6掲載時のツール一覧 · 3 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| page | integer | いいえ | ページ番号。1 から始まります。 |
| search | string | いいえ | 名前でテンプレートを絞り込みます(部分一致)。 |
| per_page | integer | いいえ | ページあたりの結果数(最大 100、デフォルトは 20)。 |
詳細
@docmake/mcp
DocMake の公式 Model Context Protocol サーバーです。AI ネイティブなドキュメント生成プラットフォームである DocMake を利用できます。Claude などの AI アシスタントが DocMake のテンプレートから DOCX や PDF のドキュメントを生成できます。つなぎ込みコードは不要で、会話するだけです。
「Acme Corp の請求書を作成してください。コンサルティングを 10 時間、料金は 1 時間あたり 100 EUR、支払期限は 14 日後です。」
アシスタントが請求書テンプレートを選び、データを入力し、DocMake API 経由で PDF を生成して、ファイルパスを渡します。
プロンプトの例
- 「Acme Corp の請求書を作成してください。コンサルティングを 10 時間、料金は 1 時間あたり 100 EUR、支払期限は 14 日後です。」
- 「私の雇用契約書テンプレートにはどのフィールドが必要ですか? その後、Maria Ionescu 用に入力して、開始日を 10 月 1 日に設定し、DOCX として保存してください。」
- 「~/Documents/quarterly-report.docx を DocMake テンプレートとしてインポートし、見つかった変数を表示してください。」
セットアップ
DocMake API キーが必要です。app.docmake.io の「Settings」>「API Keys」で作成してください(無料プランで利用できます)。
Claude Desktop
claude_desktop_config.json に追加します(「Settings」>「Developer」>「Edit Config」)。
{
"mcpServers": {
"docmake": {
"command": "npx",
"args": ["-y", "@docmake/mcp@latest"],
"env": {
"DOCMAKE_API_KEY": "dm_your_key_here"
}
}
}
}
Claude Code
claude mcp add docmake --env DOCMAKE_API_KEY=dm_your_key_here -- npx -y @docmake/mcp@latest
Cursor / その他の MCP クライアント
stdio MCP サーバーに対応しているクライアントであれば、環境変数に DOCMAKE_API_KEY を設定し、同じコマンド npx -y @docmake/mcp@latest を実行して利用できます。
リモートサーバー(インストール不要)
DocMake は同じ 6 つのツールをストリーミング可能な HTTP 経由でもホストしています。そのため、リモート MCP に対応したクライアントにはインストールが不要です。
{
"mcpServers": {
"docmake": {
"url": "https://app.docmake.io/mcp/v1",
"headers": { "Authorization": "Bearer dm_your_key_here" }
}
}
}
このパッケージとは 2 つの違いがあります。render_document はファイルをお使いのマシンに書き込む代わりに、有効期間の短いダウンロードリンクを返します。また、サーバーはリモートで実行され、ディスクを読み取れないため、import_docx ではパスではなく、ドキュメントを base64 で渡します。厳格なレンダリングを含め、それ以外の動作は同じです。
設定
| 変数 | 必須 | デフォルト | 用途 |
|---|---|---|---|
DOCMAKE_API_KEY | はい | app.docmake.io の「Settings」>「API Keys」で取得する API キー | |
DOCMAKE_OUTPUT_DIR | いいえ | ~/Downloads/DocMake | 生成したドキュメントの保存先 |
DOCMAKE_API_BASE | いいえ | https://app.docmake.io/api/v1 | API のベース URL。セルフホスト環境では上書きします |
ツール
| ツール | 説明 |
|---|---|
list_templates | ワークスペース内のテンプレートを検索やページネーション付きで一覧表示します |
get_template | テンプレートのフィールドツリーを取得します。レンダリングデータにマッピングできる、テンプレートが必要とするすべての変数が含まれます |
render_document | テンプレートを PDF または DOCX にレンダリングし、ファイルをローカルに保存します |
create_template | ドキュメントスキーマ JSON から新しいテンプレートを作成します |
import_docx | ローカルの .docx ファイルを新しいテンプレートとしてインポートします(リモートサーバーでは base64 を使用) |
get_usage | 現在の請求期間のプラン、レンダリング枠、レート制限を取得します |
サーバーはテンプレートを MCP リソースとしても公開し、ガイド付きレンダリングのワークフロー用に generate-document プロンプトを提供します。
レンダリングの仕組み
render_document はデフォルトで厳格です。テンプレート変数に data の値が設定されていない場合、レンダリングは失敗し、不足しているキーの一覧が返されます。そのため、アシスタントは不完全なドキュメントを生成するのではなく、必要な値を尋ねることができます。各変数の代替テキストを使ってレンダリングするには、strict: false を指定します。
テンプレートエディターでは、変数にデフォルト値を設定できます。デフォルト値が設定された変数は、不足している値として扱われません。data から省略すると、厳格モードでもデフォルト値がレンダリングされます。get_template では、各フィールドの default(および、プレビュー専用のサンプルであり、レンダリングには使用されない example)を確認できます。
レンダリングされたファイルは DOCMAKE_OUTPUT_DIR に保存され、既存のファイルが上書きされることはありません。
プライバシーポリシー
ポリシー全文:https://docmake.io/privacy
このサーバーが収集するもの。 独自に収集するものはありません。テレメトリも分析機能もなく、import_docx に明示的に渡した .docx 以外のチャット履歴、メモリー、ファイルを読み取ることはありません。
送信する情報と送信先。 すべてのツール呼び出しは、API キーで認証され、HTTPS 経由で DocMake API の https://app.docmake.io/api/v1 に送信されます。リクエストに含まれるのは、呼び出しに必要な情報のみです。テンプレート ID、レンダリングを依頼したデータ、またはインポートを依頼した .docx です。DocMake はそのデータを処理して、ドキュメントをレンダリングします。
保存と保持。 テンプレートとアカウントデータは DocMake ワークスペースに保存され、削除するかアカウントを閉鎖するまで保持されます。レンダリングされたドキュメントは、お使いのマシンの DOCMAKE_OUTPUT_DIR(デフォルトでは ~/Downloads/DocMake)に保存され、ほかの場所にアップロードされることはありません。API キーはお使いのマシンに保持されます。デスクトップ拡張機能ではオペレーティングシステムのキーチェーンに保存され、手動で設定した場合は MCP クライアントの設定ファイルに保存されます。
第三者との共有。 レンダリングデータを販売することはありません。また、ポリシー全文に記載されている、サービスの運用に DocMake が必要とするサブプロセッサーを除き、第三者と共有することもありません。
お問い合わせ。 プライバシーに関するご質問、データのエクスポート、削除については、[email protected] までお問い合わせください。
リンク
- DocMake:テンプレートギャラリーと製品情報
- API ドキュメント
- ダッシュボード
- サポート:[email protected]
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。