Guia do cliente MCP da Assinafy

Português · Read in English

Conecte a Assinafy ao seu assistente para preparar e enviar documentos, acompanhar assinaturas, enviar lembretes e baixar cópias assinadas.

Use https://mcp.assinafy.com.br/mcp como URL do servidor. Entre na Assinafy, escolha um workspace e aprove as permissões solicitadas. Você não precisa criar um aplicativo OAuth nem informar client ID, client secret, chave de API ou cabeçalho de workspace.

É possível conectar e consultar o catálogo antes de entrar. A autorização é solicitada quando uma ferramenta precisa acessar seu workspace.

Codex

codex mcp add assinafy --url https://mcp.assinafy.com.br/mcp
codex mcp login assinafy

Conclua a entrada no navegador, escolha o workspace e aprove as permissões. Veja a documentação MCP do Codex.

Claude Code

claude mcp add --transport http assinafy https://mcp.assinafy.com.br/mcp
claude mcp login assinafy

Você também pode abrir /mcp no Claude Code para autenticar na Assinafy. Conclua a entrada no navegador e escolha seu workspace. Veja a documentação MCP do Claude Code.

Conectores remotos do Claude

Nas configurações de conectores do Claude, adicione um conector remoto personalizado chamado Assinafy com a URL https://mcp.assinafy.com.br/mcp, conecte e conclua o consentimento. Deixe as credenciais OAuth opcionais em branco quando houver CIMD. A disponibilidade de conectores personalizados depende do plano e das configurações da organização. O registro por linha de comando é do Claude Code; um conector hospedado precisa da URL HTTPS pública.

Veja a autenticação de conectores do Claude.

ChatGPT

Configure uma conexão MCP remota com OAuth e a URL da Assinafy. Escolha CIMD se houver uma opção de registro, deixe as credenciais opcionais em branco e conclua a entrada na Assinafy e a seleção de workspace. Veja a autenticação do ChatGPT.

VS Code / GitHub Copilot Chat

Adicione esta entrada à configuração MCP do VS Code:

{
  "servers": {
    "assinafy": {
      "type": "http",
      "url": "https://mcp.assinafy.com.br/mcp"
    }
  }
}

Inicie o servidor e conclua a autorização no navegador. O VS Code escolhe CIMD quando anunciado e sabe pedir escopos adicionais quando uma ferramenta precisa. Veja o suporte a autenticação do VS Code e a configuração MCP.

Workspaces e permissões

Uma conexão autoriza um workspace. As ferramentas com escopo de conta descobrem essa conta automaticamente. O argumento account_id pode repeti-la, mas não seleciona outra. Conecte cada workspace adicional separadamente. Nunca coloque chaves de API, tokens OAuth ou qualquer outra credencial em prompts, argumentos de ferramenta ou _meta; requisições que os carregam são recusadas.

Você configura a URL do MCP. Os metadados anunciam account:read documents:read documents:write templates:read templates:write para todo o catálogo. O login pede o conjunto completo por padrão, cobrindo todas as ferramentas com um consentimento. Você pode escolher menos escopos no cliente ou na tela de consentimento e usar as ações permitidas por eles. A API exige templates:write para gerar um documento de template salvo, e documents:write para validar valores de campos. Peça offline_access quando o cliente usar refresh tokens para acesso em segundo plano.

Uma permissão ausente retorna HTTP 403 insufficient_scope, com os escopos a aprovar, antes de iniciar o fluxo. Autorize as permissões solicitadas somadas às já concedidas e tente novamente. Outras falhas podem interromper uma operação depois de iniciada; inspecione qualquer document_id preservado antes de repetir a operação.

Para o Codex, autorize explicitamente o fluxo completo de documentos e templates:

codex mcp login assinafy --scopes account:read,documents:read,documents:write,templates:read,templates:write,offline_access

Para uma conexão de documentos intencionalmente somente leitura, escolha:

codex mcp login assinafy --scopes account:read,documents:read,offline_access

Seu cliente guarda e renova os tokens. Se uma concessão expirar ou for revogada, deixe o cliente renová-la ou reconecte pela Assinafy. Com offline_access, cada renovação devolve um novo refresh token com mais 30 dias de validade; a conexão só expira após 30 dias sem renovação, e então é preciso reconectar. Nunca cole tokens na conversa ou nos argumentos das ferramentas.

O que você pode pedir

Converse com o assistente em linguagem natural. Ele escolhe a ferramenta certa, localiza nomes por você e só confirma o que for ambíguo. Nomes, e-mails e datas abaixo são exemplos.

Acompanhar documentos

Enviar para assinatura

Para enviar um arquivo, anexe-o ou indique onde ele está. O assistente lê o arquivo e envia o conteúdo; o servidor nunca abre caminhos do seu computador.

Usar modelos

Gerenciar contatos

Acompanhar pendências

Baixar, verificar e limpar

O assistente não assina, não aceita termos nem informa códigos de verificação por outra pessoa, e não cria nem edita modelos. Isso continua na Assinafy.

Comportamento na conversa

Comece pelo objetivo do usuário. Resolva nomes e reutilize os IDs já devolvidos; não peça que a pessoa conheça identificadores da API. Faça uma pergunta curta quando houver ambiguidade de destinatário, papel ou documento. Um pedido explícito para enviar, lembrar ou excluir já autoriza aquela ação; não repita a confirmação.

O modelo escolhe a ferramenta e a ação. A resposta deve explicar o resultado em linguagem comum, sem expor IDs ou base64 desnecessários. Leituras e preparação não enviam convites. Consulte todas as ferramentas e entradas.

Fluxo do documento

O servidor oferece 11 ferramentas para 24 operações de documentos. Seu assistente escolhe as ferramentas e ações do catálogo; você descreve o que quer fazer. Consulte a referência de ferramentas para entradas e exemplos.