Use seus contratos de dentro do seu assistente

Você não precisa vir até aqui para resolver contrato. Conecte o Combinado ao assistente que você já usa e peça em português: "resume o contrato da ACME", "o que mudou da v1 pra v2?", "pede alteração na cláusula de multa", "manda assinar". Sem reenviar arquivo, sem copiar e colar texto de contrato na conversa.

Antes de tudo: a sua chave

Uma só chave serve para tudo nesta página. Ela sai em Minha conta → Assistentes de IA, começa com cnsc_uk_, aparece uma única vez e pode ser trocada quando quiser: gerar uma nova revoga a anterior na hora. Onde estiver escrito cnsc_uk_SUA_CHAVE, é ela.

Quem é intermediador (a plataforma que opera contratos entre terceiros) usa a chave do tenant, cnsc_sk_, que traz os escopos de envio às partes e dos níveis 2 e 3. O conector aceita as duas, e cada uma só alcança o que o escopo dela permite.

O que o assistente consegue fazer

São 52 ferramentas. O que muda algo fora da conversa (enviar convite, arquivar, compartilhar), com a chave pessoal, é preparado pelo assistente e confirmado por você na plataforma. Com a chave de empresa ou de intermediador, o envio sai na hora: quem usa essa chave é o sistema da empresa.

Ler e acompanhar

Lista, resumo, cláusulas, o que mudou entre versões, perguntas sobre o contrato, prazos de renovação, aviso e reajuste, a agenda da carteira, o uso do plano e a auditoria da empresa.

list_contracts, get_contract, get_clauses, compare_versions, ask_contract, list_versions, get_signature_status, get_contract_terms, get_agenda, get_usage, get_account_capabilities, get_audit_log, list_abusive_clause_types

Criar e analisar

Contrato novo, respostas às perguntas da criação, análise de contrato recebido, risco de novo e anexos.

create_contract, answer_questions, analyze_contract, refresh_risk, add_attachment

Negociar e assinar

Com a chave pessoal, o assistente prepara e você confere e confirma na plataforma. Com a chave de empresa, o envio sai na hora: um PDF pronto para assinar, sem alteração, ou o mesmo PDF para até 50 pessoas.

request_changes, request_signature, send_document_for_signature, send_document_batch, get_document_batch, cancel_document_batch, list_document_templates, create_document_template, archive_document_template, cancel_signature_request, resend_signature_invite, propose_archive, propose_share, propose_actuation_change

Em lote e propostas comerciais

Gerar vários contratos a partir de um modelo e cuidar das propostas antes do contrato.

prepare_contract_batch, generate_contract_batch, list_contract_batches, list_commercial_proposals, save_commercial_proposal, convert_commercial_proposal

Para intermediadores (chave do tenant, cnsc_sk_)

Modelos de contrato com cláusulas e variáveis, enviar às partes, estimar o crédito, metadata, o histórico do contrato e, nos níveis 2 e 3, corrigir parte, reenviar convite, confirmar marco, cancelar, falar na mesa e decidir exceção.

get_contract_history, list_contract_templates, get_contract_template, create_contract_template, create_template_version, send_contract, estimate_contract, update_contract_metadata, correct_party, resend_party_invite, confirm_milestone, cancel_contract, post_to_negotiation_table, decide_exception

Claude (claude.ai e aplicativo)

1

Adicione o conector

Configurações → Conectores → Adicionar conector personalizado → cole:

URL do conector
https://api.contratocombinado.com/mcp/
2

Autorize com a sua chave

O Claude abre uma página nossa. Cole a chave cnsc_uk_… e autorize. É o padrão OAuth, então o Claude se registra sozinho e você revoga quando quiser.

Pronto: seus contratos aparecem na conversa. Nada é enviado ao Claude sem você pedir: o servidor devolve resumos, não documentos inteiros.

Claude Code, Cursor, VS Code e outros clientes MCP

Esses leem um arquivo de configuração. Cole o bloco abaixo no mcp.json (ou equivalente) do seu cliente:

mcp.json
{
  "mcpServers": {
    "combinado": {
      "type": "http",
      "url": "https://api.contratocombinado.com/mcp/",
      "headers": { "Authorization": "Bearer cnsc_uk_SUA_CHAVE" }
    }
  }
}

No Claude Code dá para fazer por linha de comando:

terminal
claude mcp add --transport http combinado https://api.contratocombinado.com/mcp/ \
  --header "Authorization: Bearer cnsc_uk_SUA_CHAVE"

ChatGPT (GPT personalizado com Actions)

O ChatGPT consome OpenAPI. Publicamos um endereço com só as ações que um assistente usa (criar, analisar, ler, perguntar, responder pendências, comparar versões, anexar documento, reavaliar o risco, ver o uso e preparar convite de assinatura, arquivamento, compartilhamento e pedido de ajustes que você confirma na plataforma) em vez da API inteira, que estouraria o limite de operações. Enviar um PDF pronto para assinar fica no conector MCP e na API:

URL do schema (Import from URL)
https://api.contratocombinado.com/v1/openapi-actions.json
1

Crie o GPT

Explorar GPTs → Criar → aba Configurar → Criar nova ação.

2

Importe o schema

Use Importar de URL com o endereço acima. As ações aparecem com nomes em português.

3

Autenticação

Escolha API Key → tipo Bearer → cole a sua chave cnsc_uk_….

Se a sua conta do ChatGPT já tiver conectores MCP remotos, pode usar a URL do Claude acima. É o mesmo servidor.

Gemini

No Gemini CLI, o mesmo bloco mcp.json da seção de clientes MCP funciona (a chave vai no cabeçalho Authorization). Para function calling no AI Studio ou Vertex, aponte para o mesmo schema enxuto:

OpenAPI para function calling
https://api.contratocombinado.com/v1/openapi-actions.json

Qualquer outra ferramenta

Se o seu assistente não fala MCP nem importa OpenAPI, ele quase certamente faz uma chamada HTTP. A API usa a mesma chave e as mesmas permissões do conector. Uma diferença: com a chave pessoal, GET /v1/contracts lista só os contratos criados por essa chave, e o conector soma a lista da sua conta na plataforma.

terminal
curl -s https://api.contratocombinado.com/v1/contracts \
  -H "Authorization: Bearer cnsc_uk_SUA_CHAVE"

Há também um cartão legível por máquina em https://api.contratocombinado.com/.well-known/mcp.json, com endereço, transporte, autenticação e onde achar cada schema. A referência completa está em Desenvolvedores.

O que o assistente NÃO recebe

  • Contrato de outra conta: a chave só enxerga o que é seu.
  • CPF e CNPJ completos nos resumos: vêm mascarados; o texto integral, só quando você pede.
  • A análise privada do outro lado de uma negociação: ela nunca sai da mesa.
  • Comando vindo de dentro de um contrato: documento é dado, nunca instrução.

Guardamos só métricas de uso das ferramentas (qual, quando, quanto demorou e se deu erro), nunca o conteúdo da conversa. Para o intermediador, essas chamadas aparecem no painel de saúde da API, junto com as chamadas REST.