Integrações
Assistentes de IA (MCP)
Conecte Claude, ChatGPT, Claude Code ou Codex à ForSign pelo Model Context Protocol e opere assinaturas em linguagem natural.
A ForSign tem um servidor MCP (Model Context Protocol), o padrão aberto que os assistentes de IA usam para falar com sistemas externos. Conectado, o assistente consegue, em nome de quem autorizou:
- buscar operações e dizer quem ainda falta assinar;
- preparar uma operação a partir de um PDF ou de um modelo da empresa e enviá-la depois da sua confirmação;
- lembrar assinantes pendentes e cancelar operações;
- entregar o link do documento assinado, com o hash SHA-256.
Disponibilidade
Em liberação gradual. Se o assistente responder que a integração ainda não está liberada para a sua empresa, fale com o suporte.
Endereço
https://api.forsign.digital/mcpTransporte Streamable HTTP. Há duas formas de autenticar:
| Forma | Quando usar | Quem age |
|---|---|---|
| Login (OAuth 2.1) | Claude, ChatGPT e qualquer cliente que abra o navegador para login | A pessoa que aprovou o acesso; as notificações saem normalmente |
| API key | Claude Code, Codex, automações | A conta da integração (autenticação); operação criada por API key não notifica o criador — use webhooks |
Conectar
Em Configurações → Conectores, adicione um conector personalizado com o endereço acima.
Ao conectar, o Claude abre a tela de login da ForSign. Entre e escolha a empresa.
Confira o que o Claude poderá fazer e clique em Permitir.
Adicione um conector (app) MCP personalizado com o endereço acima.
Faça login na ForSign, escolha a empresa e clique em Permitir.
Com login no navegador:
claude mcp add --transport http forsign https://api.forsign.digital/mcpOu com API key:
claude mcp add --transport http forsign https://api.forsign.digital/mcp \
--header "X-Api-Key: $FORSIGN_API_KEY"Em ~/.codex/config.toml, com a API key numa variável de ambiente:
[mcp_servers.forsign]
url = "https://api.forsign.digital/mcp"
bearer_token_env_var = "FORSIGN_API_KEY"Ferramentas
| Ferramenta | O que faz |
|---|---|
search_operations | Busca operações por texto, status (pending, completed, canceled, expired) e data de criação |
get_operation | Detalha uma operação: documentos, assinantes, quem assinou e quem falta |
list_templates | Lista os modelos da empresa e os assinantes que cada um pede |
search_contacts | Busca na agenda de contatos por nome, e-mail ou telefone |
create_operation | Prepara uma operação a partir de PDFs (até 10, 10 MB cada) e assinantes |
create_operation_from_template | Prepara uma operação a partir de um modelo |
send_operation | Envia um rascunho: cria a operação, consome créditos e notifica os assinantes |
remind_signers | Reenvia a solicitação de assinatura a quem não assinou (no máximo um lembrete a cada 24 h por pessoa) |
cancel_operation | Cancela uma operação não concluída, com motivo |
get_signed_document | Link de download (válido por 2 horas) e SHA-256 dos documentos |
Segurança
- Rascunho antes de enviar.
create_operationecreate_operation_from_templatesó preparam um rascunho: nada é enviado e nenhum crédito é consumido atésend_operation. O assistente mostra o resumo e pede sua confirmação. - Nunca mais acesso que o seu perfil. O aplicativo conectado faz apenas o que o seu perfil de acesso na empresa permite; ao conectar, você ainda pode limitar a leitura. Se o perfil mudar, o acesso do aplicativo acompanha em até 1 hora.
- Desconectar a qualquer momento. Em Configurações → Aplicativos conectados, no app da ForSign. O acesso termina na hora.
- Links de assinatura não saem para o assistente. O link pessoal de cada assinante não é exposto às ferramentas.
- Limite de uso: 60 chamadas por minuto por usuário. Acima disso a resposta é
429comRetry-After.