LayerOne (DocX + Sign)

LayerOne MCP — DocX + Sign

MCP（Model Context Protocol） サーバーです。LayerOne の DocX および Sign の API を、AI エージェント（Claude Desktop、ChatGPT、Cursor、Windsurf など）から直接利用できます。

接続すると、AI アシスタントが自然言語で次の操作を行えるようになります。

• DocX — ドキュメント（PDF／DOCX）や電子請求書 Factur-X（2026 年の制度改革に対応）の生成、Word テンプレートのアップロード／更新／ダウンロード、バージョン履歴の管理、利用枠の確認。
• Sign — 電子署名 eIDAS / PAdES 用の PDF の送信、ステータスの追跡、SMS（OTP）による署名者の本人確認、署名済みドキュメントのダウンロード、証明書の取得、署名の暗号学的な完全性の検証。

---

インストール

サーバーは npx で起動するため、手動でインストールする必要はありません。以下のブロックをクライアントの MCP 設定に追加し、2 つの API キーを入力してください。

Claude Desktop

ファイル claude_desktop_config.json：

{
  "mcpServers": {
    "layerone": {
      "command": "npx",
      "args": ["-y", "layerone-mcp"],
      "env": {
        "DOCX_API_KEY": "votre_cle_docx",
        "SIGN_API_KEY": "votre_cle_sign"
      }
    }
  }
}

Cursor

ファイル ~/.cursor/mcp.json（またはプロジェクトの MCP 設定）— 同じ形式です。

{
  "mcpServers": {
    "layerone": {
      "command": "npx",
      "args": ["-y", "layerone-mcp"],
      "env": {
        "DOCX_API_KEY": "votre_cle_docx",
        "SIGN_API_KEY": "votre_cle_sign"
      }
    }
  }
}

ChatGPT / その他の MCP 対応クライアント

ほとんどの MCP クライアントで同じ構造（command = npx、args = ["-y", "layerone-mcp"]、env = 2 つのキー）を使用できます。設定ファイルの正確な保存場所については、お使いのクライアントの MCP ドキュメントを参照してください。

---

API キーの取得

https://dev.layerone.fr で無料アカウントを作成し、「API キー」 タブでキーを生成してください。

• DocX キー → 環境変数 DOCX_API_KEY；
• Sign キー → 環境変数 SIGN_API_KEY。

無料アカウントでは、DocX ドキュメントを月 20 件、Sign 署名を月 10 件利用できます。

キーがコードに直接書き込まれることはありません。MCP クライアントから渡される環境変数からのみ読み込まれます。

---

公開されるツール

DocX（https://docx.layerone.fr）

ツール	説明	エンドポイント
docx_render_facturx	Factur-X 請求書（PDF/A-3）を生成	POST /render-facturx
docx_render_document	PDF または DOCX ドキュメントを生成	POST /render-document
docx_list_templates	テンプレートを一覧表示／絞り込み	GET /client/templates
docx_upload_template	Word テンプレートをアップロード	POST /client/templates
docx_update_template	テンプレートを更新（旧版をアーカイブ）	PUT /client/templates/{id}
docx_download_template	テンプレートをダウンロード	GET /client/templates/{id}
docx_delete_template	テンプレートを削除	DELETE /client/templates/{id}
docx_list_template_versions	アーカイブ済みバージョンを一覧表示	GET /client/templates/{id}/versions
docx_download_template_version	アーカイブ済みバージョンをダウンロード	GET /client/templates/{id}/versions/{version_id}
docx_restore_template_version	アーカイブ済みバージョンを復元	POST /client/templates/{id}/restore/{version_id}
docx_get_usage_stats	利用枠と使用状況を確認	GET /usage-stats

Sign (https://sign.layerone.fr)

ツール	説明	エンドポイント
sign_send_for_signature	署名用に PDF を送信する	POST /v1/documents/send
sign_detect_fields	署名フィールド（[[...]]）を検出する	POST /v1/documents/detect-fields
sign_get_document_status	署名のステータスを確認する	GET /v1/documents/{id}
sign_download_signed_document	署名済み PDF をダウンロードする	GET /v1/documents/{id}/download
sign_send_otp	SMS で OTP コードを送信する	POST /v1/otp/request
sign_verify_otp	OTP コードを検証する	POST /v1/otp/verify
sign_validate_signature	署名の完全性を検証する	GET /v1/documents/{id}/validate
sign_get_audit_certificate	証明書を取得する	GET /v1/documents/{id}/audit
sign_cancel_document	署名リクエストをキャンセルする	DELETE /v1/documents/{id}

ファイル：テンプレートと PDF は、ツールに base64 エンコードされた状態で渡します (template_base64, pdf_base64)。ダウンロードの場合、会話が 容量上限に達しないよう、サーバーは完全なバイナリではなく 要約（サイズ＋切り詰められた base64 のプレビュー）を返します。

---

ローカル開発

cd integrations/mcp
npm install
npm run build          # compile src/ → dist/
DOCX_API_KEY=... SIGN_API_KEY=... node dist/index.js

サーバーは MCP プロトコルに従って stdio（標準入力／標準出力）で通信します。

---

公開

• npm：.github/workflows/publish.yml による provenance 付きの自動公開です（GitHub リリースによって起動します）。
• MCP Registry：マニフェスト server.json の name フィールド io.github.GOLayerone/layerone（package.json の mcpName と同一）により、 ツール mcp-publisher を介して公式レジストリに公開できます。

---

ライセンス

MIT — © LayerOne。