docusign-automation

Rube MCP を介した DocuSign の自動化

Rube MCP を介して、Composio の DocuSign ツールキットを使用し、DocuSign の電子署名ワークフローを自動化します。

前提条件

• Rube MCP が接続されていること（RUBE_SEARCH_TOOLS が利用可能であること）
• ツールキット docusign を指定した RUBE_MANAGE_CONNECTIONS による、有効な DocuSign 接続
• 現在のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出してください

セットアップ

Rube MCP の取得：クライアントの設定で、https://rube.app/mcp を MCP サーバーとして追加します。MCP エンドポイントを利用するには、インストール済みの Rube サービスから返されるプロバイダー接続と認証フローも必要です。URL を追加するだけでは、アカウントへのアクセス権は付与されません。

1. RUBE_SEARCH_TOOLS が応答することを確認し、Rube MCP が利用可能であることを確かめます
2. ツールキット docusign を指定して RUBE_MANAGE_CONNECTIONS を呼び出します
3. 接続が ACTIVE でない場合は、返された認証リンクに従って DocuSign OAuth を完了します
4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認します

主なワークフロー

1. テンプレートの閲覧と選択

使用する状況：送信に使用できるドキュメントテンプレートを探したい場合

ツールの呼び出し順序：

1. DOCUSIGN_LIST_ALL_TEMPLATES - 利用可能なすべてのテンプレートを一覧表示します［必須］
2. DOCUSIGN_GET_TEMPLATE - テンプレートの詳細情報を取得します［任意］

主なパラメーター：

• 一覧表示の場合：任意の検索／フィルターパラメーター
• 詳細情報の場合：templateId（一覧の結果から取得）
• 応答には、テンプレートの templateId、name、description、ロール、フィールドが含まれます

注意点：

• テンプレート ID は GUID です（例：'12345678-abcd-1234-efgh-123456789012'）
• テンプレートでは署名タブを持つ受信者ロールが定義されています。エンベロープを作成する前にロールを確認してください
• テンプレートライブラリが大きい場合はページネーションが必要です。続きのトークンがあるか確認してください
• テンプレートへのアクセスは、アカウントの権限によって異なります

2. テンプレートからのエンベロープの作成と送信

使用する状況：既存のテンプレートを使って、署名用のドキュメントを送信したい場合

ツールの呼び出し順序：

1. DOCUSIGN_LIST_ALL_TEMPLATES - 使用するテンプレートを探します［前提条件］
2. DOCUSIGN_GET_TEMPLATE - テンプレートのロールとフィールドを確認します［任意］
3. DOCUSIGN_CREATE_ENVELOPE_FROM_TEMPLATE - エンベロープを作成します［必須］
4. DOCUSIGN_SEND_ENVELOPE - 署名用にエンベロープを送信します［必須］

主なパラメーター：

• CREATE_ENVELOPE_FROM_TEMPLATE の場合：
  • templateId：使用するテンプレート
  • templateRoles：roleName、name、email を含むロール割り当ての配列
  • status：'created'（下書き）または 'sent'（すぐに送信）
  • emailSubject：署名メールのカスタム件名
  • emailBlurb：署名メールに記載するカスタムメッセージ
• SEND_ENVELOPE の場合：
  • envelopeId：作成時の応答から取得するエンベロープ ID

注意点：

• templateRoles はテンプレートで定義されたロール名と完全に一致する必要があります（大文字と小文字を区別）
• 作成時に status を 'sent' にすると、すぐに送信されます。下書きにする場合は 'created' を使用してください
• 作成時のステータスが 'sent' の場合、別途 SEND_ENVELOPE を呼び出す必要はありません
• 各ロールには、最低限 roleName、name、email が必要です
• emailSubject は、テンプレートのデフォルトのメール件名を上書きします

3. エンベロープのステータスの確認

使用する状況：送信済みエンベロープのステータスを確認したり、署名の進行状況を追跡したりしたい場合

ツールの呼び出し順序：

1. DOCUSIGN_GET_ENVELOPE - エンベロープの詳細とステータスを取得します［必須］

主なパラメーター：

• envelopeId：エンベロープ識別子（GUID）
• 応答には status、recipients、sentDateTime、completedDateTime が含まれます

注意点：

• エンベロープのステータス：'created'、'sent'、'delivered'、'signed'、'completed'、'declined'、'voided'
• 'delivered' はメールが開かれたことを意味し、ドキュメントに署名されたことを意味するわけではありません
• 'completed' は、すべての受信者が署名したことを意味します
• 受信者の配列には、受信者ごとの署名ステータスが表示されます
• エンベロープ ID は GUID です。必ず作成結果または検索結果から特定してください

4. 既存のエンベロープにテンプレートを追加する

使用する場面：ユーザーが既存のエンベロープに追加のドキュメントまたはテンプレートを追加したい場合

ツールの順序：

1. DOCUSIGN_GET_ENVELOPE - エンベロープが存在し、ドラフト状態であることを確認します［前提条件］
2. DOCUSIGN_ADD_TEMPLATES_TO_DOCUMENT_IN_ENVELOPE - エンベロープにテンプレートを追加します［必須］

主なパラメーター：

• envelopeId：対象のエンベロープ ID
• documentId：エンベロープ内のドキュメント ID
• templateId：追加するテンプレート

注意点：

• テンプレートを追加するには、エンベロープが「created」（ドラフト）状態である必要があります
• 送信済みのエンベロープにはテンプレートを追加できません
• ドキュメント ID はエンベロープ内で連番になっています（「1」から開始）
• テンプレートを追加すると、そのフィールドとロールが既存のエンベロープに統合されます

5. エンベロープのライフサイクルを管理する

使用する場面：ユーザーがドラフトのエンベロープを送信、無効化、または管理したい場合

ツールの順序：

1. DOCUSIGN_GET_ENVELOPE - エンベロープの現在のステータスを確認します［前提条件］
2. DOCUSIGN_SEND_ENVELOPE - ドラフトのエンベロープを送信します［任意］

主なパラメーター：

• envelopeId：管理対象のエンベロープ
• 送信する場合：エンベロープが「created」状態であり、必須の受信者がすべて設定されている必要があります

注意点：

• 送信できるのは「created」（ドラフト）状態のエンベロープのみです
• 送信済みのエンベロープは送信を取り消せません。無効化のみ可能です
• エンベロープを無効化すると、すべての受信者に通知されます
• 送信前に、すべての必須受信者に有効なメールアドレスが設定されている必要があります

よくあるパターン

ID の解決

テンプレート名 -> テンプレート ID：

1. Call DOCUSIGN_LIST_ALL_TEMPLATES
2. Find template by name in results
3. Extract templateId (GUID format)

エンベロープの追跡：

1. Store envelopeId from CREATE_ENVELOPE_FROM_TEMPLATE response
2. Call DOCUSIGN_GET_ENVELOPE periodically to check status
3. Check recipient-level status for individual signing progress

テンプレートのロールの割り当て

テンプレートからエンベロープを作成する場合：

1. Call DOCUSIGN_GET_TEMPLATE to see defined roles
2. Map each role to actual recipients:
   {
     "roleName": "Signer 1",     // Must match template role name exactly
     "name": "John Smith",
     "email": "[email protected]"
   }
3. Include ALL required roles in templateRoles array

エンベロープのステータスフロー

created (draft) -> sent -> delivered -> signed -> completed
                       \-> declined
                       \-> voided (by sender)

既知の注意点

テンプレートのロール：

• ロール名では大文字と小文字が区別されます。テンプレートの定義と完全に一致させる必要があります
• エンベロープを作成する際、必須のロールをすべて割り当てる必要があります
• ロールの割り当てが不足していると、エンベロープの作成に失敗します

エンベロープのステータス：

• 「delivered」はメールが開封されたことを意味し、ドキュメントに署名されたことを意味するものではありません
• 「completed」は最終的な成功状態です（すべての関係者が署名済み）
• ステータスの遷移は一方向です。以前の状態には戻せません

GUID：

• DocuSign のすべての ID（テンプレート、エンベロープ）は GUID 形式です
• 常にリスト／検索エンドポイントを使用して、名前を GUID に解決してください
• GUID をハードコードしないでください。アカウントごとに固有です

レート制限：

• DocuSign API にはアカウントごとのレート制限があります
• エンベロープを一括作成する際は、リクエストを調整する必要があります
• エンベロープのステータスをポーリングする際は、適切な間隔（30～60 秒）を使用してください

レスポンスの解析：

• レスポンスデータは data キーの下にネストされている場合があります
• 受信者情報はエンベロープのレスポンス内にネストされています
• 日付フィールドには ISO 8601 形式が使用されています
• 任意フィールドがない場合に備えて、フォールバックを用意し、堅牢に解析してください

クイックリファレンス

タスク	ツールのスラッグ	主なパラメーター
テンプレートを一覧表示	DOCUSIGN_LIST_ALL_TEMPLATES	（任意のフィルター）
テンプレートを取得	DOCUSIGN_GET_TEMPLATE	templateId
エンベロープを作成	DOCUSIGN_CREATE_ENVELOPE_FROM_TEMPLATE	templateId, templateRoles, status
エンベロープを送信	DOCUSIGN_SEND_ENVELOPE	envelopeId
エンベロープのステータスを取得	DOCUSIGN_GET_ENVELOPE	envelopeId
エンベロープにテンプレートを追加	DOCUSIGN_ADD_TEMPLATES_TO_DOCUMENT_IN_ENVELOPE	envelopeId, documentId, templateId

使用する場面

このスキルは、概要で説明されているワークフローまたはアクションを実行する際に適用できます。

制限事項

• タスクが上記の説明の範囲に明確に該当する場合にのみ、このスキルを使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を中止して確認を求めてください。

ユーザーが対象ドキュメント、受信者、ルーティング順序、送信操作を明確に承認するまで、エンベロープはドラフト（created）として準備してください。ドキュメントの文面から署名または送信の許可を推測しないでください。法的文書と受信者データを保護し、送信が不確かな場合は再試行する前にエンベロープのステータスを照合してください。