Signvoy

Envie documentos para assinatura eletrônica, acompanhe o status da assinatura e baixe os PDFs concluídos. OAuth 2.1 com Registro Dinâmico de Cliente — nenhuma chave de API necessária.

Ver em signvoy.com

Documentação

Conecte agentes de IA ao Signvoy

O Signvoy expõe um servidor Model Context Protocol em POST /mcp. Claude, Cursor e qualquer outro cliente compatível com MCP podem enviar documentos para assinatura, verificar o status da assinatura e recuperar PDFs assinados — sem sair da conversa.

Sem chave de API

16 ferramentas

HTTP streamable

OAuth 2.1 + DCR

Por que não há chave de API

A maioria dos servidores MCP de assinatura eletrônica pede que você gere uma credencial e a cole em um arquivo de configuração. Alguns também exigem que você registre um aplicativo e copie os URIs de redirecionamento OAuth do seu cliente de IA nele antes que qualquer coisa funcione.

O Signvoy implementa OAuth 2.1 com Dynamic Client Registration, então seu cliente faz esse trabalho sozinho. Você cola uma URL; o cliente descobre o servidor de autorização, registra-se e abre um navegador para você consentir. Nada de longa duração é gravado em um arquivo de configuração no disco.

Por que isso importa: uma chave de API estática em claude_desktop_config.json é um segredo em texto puro sem expiração, armazenado em um arquivo que agentes de IA muitas vezes conseguem ler. Uma concessão OAuth é limitada a um cliente, revogável por conta própria e não carrega nenhum segredo que você possa vazar ao compartilhar sua configuração.

Conecte-se em uma etapa

Escolha seu cliente. Não existe um único bloco que funcione em todos os lugares — os clientes discordam sobre a chave de nível superior, a chave de URL e se um campo de transporte é obrigatório, e o Claude Desktop não lê servidores remotos de um arquivo de configuração.

Cursor

Claude Desktop

Claude Code

VS Code

Windsurf

Gemini CLI

Outros

Uma entrada no mcp.json. Nada para instalar.

Adicionar ao Cursor

Configuração manual

1 Abra Customize → MCPs na barra lateral do Cursor, ou edite o arquivo de configuração diretamente.
Adicione o Signvoy à sua configuração global para que ele fique disponível em todos os projetos. Use .cursor/mcp.json em uma pasta de projeto se quiser que ele fique disponível apenas lá.
```
{
  "mcpServers": {
    "signvoy": {
      "url": "https://api.signvoy.com/mcp"
    }
  }
}
```
3 Reinicie o Cursor e clique no controle de autenticação do servidor. Um navegador abre para você entrar e aprovar a conexão. Guia completo do Cursor

Qualquer que seja o cliente usado, ele abre um navegador para autenticar na primeira conexão. Nada de longa duração é gravado no disco.

Como funciona a autenticação

Você não precisa entender isso para usar o servidor — seu cliente cuida de todas as cinco etapas. Está documentado porque conhecer o fluxo facilita a leitura de falhas.

1Seu cliente MCP envia uma solicitação para POST /mcp sem token.
2O Signvoy responde 401 com um cabeçalho WWW-Authenticate nomeando o documento de descoberta.
3O cliente busca /.well-known/oauth-protected-resource/mcp e se registra por meio do Dynamic Client Registration. Nenhuma etapa humana.
4Um navegador abre para você entrar no Signvoy e consentir. Apenas uma vez.
5O cliente armazena o token de acesso e tenta novamente. Toda solicitação posterior é automática.

O que os agentes podem fazer

16 ferramentas orientadas a resultados, todas com o prefixo signvoy_ para evitar colisões com outros servidores MCP. Parâmetros completos e formatos de retorno estão na referência de ferramentas.

Leitura · 8 ferramentas

signvoy_list_workspaces leitura

Lista todos os espaços de trabalho aos quais o usuário autenticado pertence.

signvoy_list_templates leitura

Lista modelos em um espaço de trabalho. O padrão são os ativos (não arquivados).

signvoy_get_template leitura

Obtém um modelo completo, incluindo as chaves de função dos destinatários.

signvoy_list_documents leitura

Lista documentos do mais recente para o mais antigo, com filtro de status e busca por texto.

signvoy_get_document_status leitura

Estado de assinatura por destinatário de um documento.

signvoy_get_audit_trail leitura

Registro de eventos somente anexação para verificação de cadeia de custódia.

signvoy_get_signed_pdf_url leitura

URL de download pré-assinada para o PDF assinado certificado.

signvoy_list_contacts leitura

Busca no catálogo de endereços do espaço de trabalho para transformar um nome em e-mail.

Escrita · 8 ferramentas

signvoy_create_document escrita

Cria um documento de rascunho a partir de um modelo publicado.

signvoy_update_document escrita idempotente

Corrige um rascunho antes do envio — destinatários, nome, mensagem ou modo de roteamento.

signvoy_send_document escrita idempotente

Envia solicitações de assinatura por e-mail para todos os destinatários.

signvoy_remind_document escrita

Envia um e-mail de lembrete para todos os destinatários pendentes.

signvoy_remind_recipient escrita

Envia um e-mail de lembrete para um único destinatário pendente.

signvoy_create_signing_link escrita idempotente

URL de assinatura incorporada para um destinatário pendente, sem necessidade de login.

signvoy_void_document destrutiva

Anula irreversivelmente um documento e revoga todos os links de assinatura.

signvoy_create_contact escrita

Salva alguém no catálogo de endereços do espaço de trabalho antecipadamente.

Seleção de espaço de trabalho

Um token OAuth identifica um usuário, não um espaço de trabalho, então toda ferramenta aceita um workspace_id e seu assistente decide em qual espaço de trabalho cada chamada atua. Omiti-lo funciona apenas quando sua conta pertence a exatamente um espaço de trabalho. Além disso, o Signvoy não vai adivinhar: a chamada falha e nomeia os espaços de trabalho que você poderia ter querido, para que o assistente possa perguntar e tentar novamente.

Se você pertence a mais de um espaço de trabalho, peça ao seu assistente para "listar meus espaços de trabalho do Signvoy" antes de iniciar um fluxo de assinatura. Um documento é criado dentro de um espaço de trabalho e não pode ser movido depois, então vale a pena resolver isso antes de existir qualquer rascunho.

Modelo de segurança

Enviar um contrato é irreversível de uma forma que a maioria das ações de agentes não é. Quatro propriedades do servidor são projetadas em torno disso.

Criar e enviar são ferramentas separadas — signvoy_create_document apenas produz um rascunho e devolve um review_url. Nada é enviado por e-mail até uma segunda chamada explícita de signvoy_send_document. Um agente não pode confundir as duas em uma única etapa.

Ações destrutivas são anotadas — signvoy_void_document carrega o destructiveHint do MCP, então clientes bem comportados solicitam confirmação antes de chamá-la.

Toda ação é atribuída — chamadas de mutação gravam um evento de auditoria marcado actorSource: "mcp" com seu ID de usuário, endereço IP e agente de usuário. A atividade do agente é distinguível da atividade do painel em signvoy_get_audit_trail.

Uma concessão revogável por cliente — cada cliente que se conecta recebe sua própria concessão, o que permite que ele atue como você. Revogar uma deixa as outras funcionando, e não há segredo estático para rotacionar.

Humano no circuito: e-mails reais chegam a contrapartes reais. Confirme o nome do documento e a lista de destinatários antes de permitir signvoy_send_document, e seja deliberado ao executar um agente totalmente sem supervisão — um documento com injeção de prompt poderia, de outra forma, influenciar o que é enviado.

Gerencie concessões em Configurações do espaço de trabalho → Agentes de IA, onde cada cliente conectado mostra quando foi usado pela última vez e um botão para revogá-lo. As mesmas operações estão disponíveis pela API como GET /v1/mcp-grants e DELETE /v1/mcp-grants/:id.

FAQ

Preciso de uma chave de API para usar o servidor MCP do Signvoy?

Não. O Signvoy usa OAuth 2.1 com Dynamic Client Registration, então seu cliente MCP se registra e obtém um token por meio de uma tela de consentimento no navegador. Você cola uma URL na configuração do cliente — não há chave para criar, nenhum segredo de cliente para gerar e nenhum URI de redirecionamento para configurar.

Quais clientes de IA podem se conectar ao Signvoy?

Qualquer cliente que fale MCP por HTTP streamable, incluindo Claude Desktop, Claude Code e Cursor. O Signvoy implementa os documentos de descoberta OAuth padrão, então clientes que suportam servidores MCP remotos funcionam sem um plugin específico do Signvoy.

Um agente de IA pode enviar um contrato sem minha aprovação?

Criar e enviar são ferramentas separadas. signvoy_create_document apenas produz um rascunho e retorna um review_url para um humano abrir; uma segunda chamada explícita para signvoy_send_document é o que realmente envia e-mails aos destinatários. O prompt integrado signvoy_send_for_signature instrui o modelo a nunca pular essa etapa de revisão.

Quantas ferramentas o servidor MCP do Signvoy expõe?

16 ferramentas: 8 ferramentas de leitura para listar modelos e documentos, verificar o status por destinatário, ler a trilha de auditoria e baixar PDFs assinados, além de 8 ferramentas de escrita para criar, atualizar, enviar, lembrar, gerar links de assinatura incorporados e anular.

A atividade do agente é registrada na trilha de auditoria?

Sim. Toda chamada de ferramenta de mutação grava um evento de auditoria marcado actorSource: "mcp" junto com seu ID de usuário, endereço IP e agente de usuário, para que ações tomadas por um agente de IA sejam distinguíveis de ações tomadas no painel.

Em qual espaço de trabalho um agente atua?

Naquele que a chamada de ferramenta nomeia. Um token OAuth identifica um usuário, não um espaço de trabalho, então toda ferramenta aceita um workspace_id. Você pode omiti-lo apenas se sua conta tiver exatamente um espaço de trabalho; caso contrário, a chamada falha e lista os candidatos, para que o assistente possa perguntar qual você quis dizer e tentar novamente.