Automação DocuSign via Rube MCP

Automatize fluxos de trabalho de assinatura eletrônica DocuSign através do kit de ferramentas DocuSign da Composio via Rube MCP.

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão DocuSign ativa via RUBE_MANAGE_CONNECTIONS com o kit de ferramentas docusign
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obter Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na sua configuração de cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o kit de ferramentas docusign
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar o OAuth do DocuSign
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Navegar e Selecionar Modelos

Quando usar: O usuário deseja encontrar modelos de documentos disponíveis para envio

Sequência de ferramentas:

1. DOCUSIGN_LIST_ALL_TEMPLATES - Listar todos os modelos disponíveis [Obrigatório]
2. DOCUSIGN_GET_TEMPLATE - Obter informações detalhadas do modelo [Opcional]

Parâmetros chave:

• Para listagem: Parâmetros opcionais de pesquisa/filtro
• Para detalhes: templateId (dos resultados da lista)
• A resposta inclui templateId, name, description do modelo, funções e campos

Armadilhas:

• IDs de modelo são GUIDs (ex: '12345678-abcd-1234-efgh-123456789012')
• Modelos definem funções de destinatário com campos de assinatura; entenda as funções antes de criar envelopes
• Grandes bibliotecas de modelos exigem paginação; verifique por tokens de continuação
• O acesso ao modelo depende das permissões da conta

2. Criar e Enviar Envelopes a partir de Modelos

Quando usar: O usuário deseja enviar documentos para assinatura usando um modelo pré-construído

Sequência de ferramentas:

1. DOCUSIGN_LIST_ALL_TEMPLATES - Encontrar o modelo a ser usado [Pré-requisito]
2. DOCUSIGN_GET_TEMPLATE - Revisar funções e campos do modelo [Opcional]
3. DOCUSIGN_CREATE_ENVELOPE_FROM_TEMPLATE - Criar o envelope [Obrigatório]
4. DOCUSIGN_SEND_ENVELOPE - Enviar o envelope para assinatura [Obrigatório]

Parâmetros chave:

• Para CREATE_ENVELOPE_FROM_TEMPLATE:
  • templateId: Modelo a ser usado
  • templateRoles: Matriz de atribuições de função com roleName, name, email
  • status: 'created' (rascunho) ou 'sent' (enviar imediatamente)
  • emailSubject: Linha de assunto personalizada para o e-mail de assinatura
  • emailBlurb: Mensagem personalizada no e-mail de assinatura
• Para SEND_ENVELOPE:
  • envelopeId: ID do envelope da resposta de criação

Armadilhas:

• templateRoles deve corresponder exatamente aos nomes das funções definidos no modelo (sensível a maiúsculas e minúsculas)
• Definir status como 'sent' durante a criação envia imediatamente; use 'created' para rascunhos
• Se o status for 'sent' na criação, não é necessário chamar SEND_ENVELOPE separadamente
• Cada função requer no mínimo roleName, name e email
• emailSubject substitui o assunto padrão do e-mail do modelo

3. Monitorar Status do Envelope

Quando usar: O usuário deseja verificar o status de envelopes enviados ou rastrear o progresso da assinatura

Sequência de ferramentas:

1. DOCUSIGN_GET_ENVELOPE - Obter detalhes e status do envelope [Obrigatório]

Parâmetros chave:

• envelopeId: Identificador do envelope (GUID)
• A resposta inclui status, recipients, sentDateTime, completedDateTime

Armadilhas:

• Status do envelope: 'created', 'sent', 'delivered', 'signed', 'completed', 'declined', 'voided'
• 'delivered' significa que o e-mail foi aberto, não que o documento foi assinado
• 'completed' significa que todos os destinatários assinaram
• A matriz de destinatários mostra o status de assinatura individual por destinatário
• IDs de envelope são GUIDs; sempre resolva a partir dos resultados de criação ou pesquisa

4. Adicionar Modelos a Envelopes Existentes

Quando usar: O usuário deseja adicionar documentos ou modelos adicionais a um envelope existente

Sequência de ferramentas:

1. DOCUSIGN_GET_ENVELOPE - Verificar se o envelope existe e está em estado de rascunho [Pré-requisito]
2. DOCUSIGN_ADD_TEMPLATES_TO_DOCUMENT_IN_ENVELOPE - Adicionar modelo ao envelope [Obrigatório]

Parâmetros chave:

• envelopeId: ID do envelope de destino
• documentId: ID do documento dentro do envelope
• templateId: Modelo a ser adicionado

Armadilhas:

• O envelope deve estar no status 'created' (rascunho) para adicionar modelos
• Não é possível adicionar modelos a envelopes já enviados
• IDs de documento são sequenciais dentro de um envelope (começando em '1')
• Adicionar um modelo mescla seus campos e funções ao envelope existente

5. Gerenciar Ciclo de Vida do Envelope

Quando usar: O usuário deseja enviar, anular ou gerenciar envelopes rascunhos

…