Documentero

@documentero/mcp

Documentero の公式 MCP サーバーです。テンプレートの一覧表示、フィールドスキーマの確認、AI エージェント（Cursor、Claude Desktop など）からの Word／PDF／Excel ドキュメントの生成に対応しています。

• npm： @documentero/mcp
• ソース： github.com/documentero/documentero-mcp
• ウェブサイト： documentero.com
• ドキュメント： docs.documentero.com

ツール

ツール	説明
list_templates	kind（word|excel）、defaultFormat、allowedFormats を含むテンプレート
get_template_fields	JSON Schema（主要な値ルールを拡充）＋フィールド定義＋許可される形式
generate_document	指定したテンプレートとフィールドから Word／PDF または Excel ドキュメントを生成します。デフォルトでは署名付き URL（約1時間）を返します。embed: true の場合は base64 を返します。format は省略可能です（テンプレートのデフォルト形式）。

セットアップ

1. Documentero → アカウント設定から API キーをコピーします。
2. クライアント設定に MCP サーバーを追加します。

Cursor / Claude Desktop（npx）

{
  "mcpServers": {
    "documentero": {
      "command": "npx",
      "args": ["-y", "@documentero/mcp"],
      "env": {
        "DOCUMENTERO_API_KEY": "your-api-key"
      }
    }
  }
}

ローカル開発

git clone https://github.com/documentero/documentero-mcp.git
cd documentero-mcp
npm install
npm run build

{
  "mcpServers": {
    "documentero": {
      "command": "node",
      "args": ["/absolute/path/to/documentero-mcp/dist/index.js"],
      "env": {
        "DOCUMENTERO_API_KEY": "your-api-key",
        "DOCUMENTERO_BASE_URL": "https://app.documentero.com/api"
      }
    }
  }
}

開発環境には https://documentero-dev.web.app/api を使用してください。

環境変数

変数	必須	デフォルト	説明
DOCUMENTERO_API_KEY	はい	—	会社の API キー（アカウント設定）
DOCUMENTERO_BASE_URL	いいえ	https://app.documentero.com/api	クラウド API のベース URL

エージェントの一般的なフロー

1. list_templates → templateId を選択します（kind／allowedFormats に従ってください）
2. get_template_fields → jsonSchema に基づいて data を構成します（HTML／Markdown／画像／リンク／QR のルールなど、追加のコンテキストには fieldDefinitions を使用してください）
3. generate_document → ダウンロード URL（または埋め込み base64）

スモークテスト

npm run build
DOCUMENTERO_API_KEY=your-key npm run smoke

注意事項

• 公開 Cloud API（/api/templates、/api/meta、/api/generate）のシンクライアントです。クォータとレート制限は通常どおり Documentero によって適用されます。
• API キーをツールの引数に含めないでください。MCP の環境変数のみに設定してください。
• Word テンプレートの出力形式は docx／pdf に対応しています。Excel テンプレートの出力形式は xlsx のみです。
• リモート Streamable HTTP ホスティング（https://mcp.documentero.com/mcp）は予定されています。このリリースは stdio のみです。

ライセンス

MIT © Documentero