Lumin

Lumin PDF MCP サーバー

Lumin PDF MCP サーバーを使用すると、MCP 対応の AI アシスタント（Claude Desktop や Cursor など）とLumin の API サービスをシームレスに連携できます。これにより、AI アシスタントは自然言語のコマンドを通じて、ドキュメントの管理、署名リクエストの送信、ワークスペースの詳細情報の取得、PDF の生成などを直接実行できます。

---

🚀 機能

この MCP サーバーでは、以下の Lumin API ツールを利用できます。

• get_lumin_user_information – 現在の Lumin ユーザーに関する情報を取得します。
• get_signature_request_on_lumin_by_id – ID を指定して署名リクエストの詳細を取得します。
• cancel_signature_request_on_lumin_by_id – 保留中の署名リクエストをキャンセルします。
• send_signature_request_on_lumin – 添付ドキュメント付きの署名リクエストを作成して送信します。
• upload_file_to_lumin – ファイルを Lumin にアップロードします。
• get_workspace_list_of_user_on_lumin – ユーザーに関連付けられたすべてのワークスペースを取得します。
• lumin_markdown2pdf – Lumin を使用して Markdown コンテンツを PDF に変換します。

---

📦 インストール

Cursor ユーザーの場合

Cursorを使用している場合は、提供された連携リンクを開くだけで、Cursor が自動的にインストールを行います。

---

Claude Desktop ユーザーの場合

claude_desktop_config.json ファイルに次の設定を追加してください。

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

Windows： %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "lumin": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.luminpdf.com/mcp"]
    }
  }
}

その他の MCP クライアントへの対応は、近日中に追加される予定です。

---

🛠 トラブルシューティング

Cursor の認証に関する問題

インストールに失敗する場合や、Cursor で認証できない場合は、キャッシュされた認証情報を削除してみてください。

/Users/<your-username>/.mcp-auth/

その後、Cursor を再起動して連携を再インストールしてください。

---

📘 自然言語コマンドの例

（詳しいワークフローの例については、以下をご覧ください。）

MCP 対応の AI アシスタントに指示できる内容の例を紹介します。

ユーザー情報の取得

Get my user information from Lumin.

署名リクエストのキャンセル

Cancel my signature request with ID: my-signature-request-id

署名リクエストの送信

Send a signature request with these details:
- Title: Contract Agreement
- Signers: [email protected] (John Doe), [email protected] (Mary Smith)
- Expiry: 7 days from now
- File URL: https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf

(注：公開 URL を使ったドキュメントへの対応は、今後のバージョンで強化される予定です。)

---

---

🔄 包括的なワークフローの例

AI アシスタントがすべての Lumin MCP ツールを組み合わせる方法を示す、エンドツーエンドのワークフロー例を紹介します。

🔐 ワークフロー 1：ドキュメントをアップロードして署名リクエストを送信する

1. Get my user information from Lumin.
2. Retrieve my list of workspaces on Lumin.
3. Upload the file named "service-agreement.pdf" to my primary workspace.
4. Send a signature request using the uploaded file with:
   - Title: Service Agreement
   - Signer: [email protected] (Primary Signer)
   - Message: Please review and sign.
   - Expiry: 5 days from now

📄 ワークフロー 2：ステータスを確認して PDF の要約を生成する

1. Get details of my signature request with ID: req_12345.
2. Convert the following Markdown into a PDF using Lumin:
   """
   # Signature Request Summary
   - Request ID: req_12345
   - Status: <insert-status-from-response>
   - Generated: Today
   """
3. Save or download the generated summary PDF.

🚫 ワークフロー 3：署名リクエストをキャンセルして確認する

1. Cancel my signature request with ID: req_12345.
2. Retrieve the request again to confirm it is now cancelled.

🗂 ワークフロー 4：ワークスペースの管理とドキュメントの変換

1. Retrieve all workspaces associated with my Lumin account.
2. Upload a file named "proposal.md" to my "Client Projects" workspace.
3. Convert the uploaded Markdown file into a PDF using Lumin.
4. Send that generated PDF as part of a signature request.

🔁 ワークフロー 5：完全自動化チェーン

1. Upload the document "nda.pdf" to Lumin.
2. Create a signature request using the uploaded document.
3. Periodically check the status of the request until it is completed.
4. Once completed, generate a PDF summary of the signing details using Markdown.
5. Upload the summary PDF into my workspace for archival.

---

📚 API ドキュメント

詳しいリファレンスドキュメントについては、以下をご覧ください。 👉 https://developers.luminpdf.com/api/