O que é MCP e o que muda quando um agente de IA envia o contrato para assinatura
O que é MCP? Veja o que um servidor MCP acrescenta a uma API REST e como conectar o da Chaindoc sem que o agente de IA assine no seu lugar. Guia prático.

Assine um documento e verifique o registro você mesmo.
Começar agoraO que é MCP, em um parágrafo
O que é MCP? É o padrão que deixa um programa pequeno, o servidor MCP, descrever os endpoints de uma API como ferramentas que um modelo de IA encontra e chama sozinho. A API, por si, é um conjunto de endpoints sobre os quais um desenvolvedor escreve código. A diferença entre MCP e API cabe numa linha: a API é para o seu código, o servidor MCP é para um agente. Na assinatura eletrônica, isso decide quem escolhe o próximo passo. Com a API REST da Chaindoc, o seu código decide quando um contrato sai. Com o servidor MCP, quem decide é o agente, dentro dos limites da chave dele. A assinatura nunca passa para o agente.
O que é um servidor MCP, e por que «MCP ou API» é uma falsa escolha
O que é um servidor MCP? É o lado servidor do Model Context Protocol (MCP), um padrão aberto que a Anthropic publicou em 25 de novembro de 2024 para conectar aplicações de IA a ferramentas e dados externos. Em dezembro de 2025 o protocolo passou para a Agentic AI Foundation, dentro da Linux Foundation, então não pertence mais a um único fornecedor de modelos. A especificação atual tem a data 2026-07-28.
O MCP tem três papéis. O host é a aplicação de IA com a qual você conversa, o cliente é o conector dentro dela, e o servidor expõe o que um sistema externo sabe fazer, de três formas:
- Tools (ferramentas): funções que o modelo pode chamar, como «criar uma solicitação de assinatura».
- Resources (recursos): dados que o modelo ou o usuário podem ler, como o status de um contrato.
- Prompts, tarefas com nome que um usuário pode iniciar.
As mensagens são JSON-RPC 2.0. Um servidor roda como processo local que o cliente inicia (transporte stdio) ou atrás de um endpoint HTTP (Streamable HTTP).
Um servidor MCP é um servidor de verdade? Às vezes. Um servidor stdio é um processo no seu computador, que liga e desliga junto com o seu cliente de IA. Um servidor HTTP é um serviço que alguém precisa hospedar.
Por que «MCP ou API» é uma falsa escolha? Porque quase todo MCP server útil envolve uma API que já existe. O da Chaindoc liga suas ferramentas aos mesmos endpoints REST que o seu backend chamaria. Você não escolhe entre os dois. Você escolhe quem dirige: o seu código ou um modelo.
MCP vs API: cinco diferenças quando um agente faz as chamadas
Os endpoints por baixo são idênticos. A diferença entre MCP e API é tudo o que cerca a chamada, e cinco partes dela aparecem assim que quem chama é um agente.
- 1.Descoberta. O seu código conhece a API porque um desenvolvedor leu a documentação. Um cliente MCP pede ao servidor a lista de ferramentas (
tools/list) em tempo de execução e repassa nomes, descrições e esquemas de entrada ao modelo. Se você conhece o function calling, é a mesma ideia num formato comum: um servidor funciona em qualquer cliente MCP. - 2.Quem escolhe a chamada. Numa integração por API, a sequência está escrita no código e roda igual toda vez. Com MCP, o modelo escolhe a ferramenta e preenche os argumentos a partir da sua frase, então o mesmo pedido pode seguir dois caminhos diferentes em dois dias.
- 3.Os erros voltam para o modelo. A especificação separa erros de protocolo de erros de execução de uma ferramenta, e os segundos são feitos para chegar ao modelo, que pode corrigir um argumento e tentar de novo. Um backend registraria o erro e pararia.
- 4.As credenciais ficam num arquivo de configuração. Um servidor stdio lê a chave de uma variável de ambiente que o seu cliente de IA repassa. Quem pode editar esse arquivo decide o que o agente pode fazer.
- 5.A aprovação é tarefa do cliente. A página de ferramentas da especificação MCP recomenda (SHOULD) que uma pessoa possa intervir nas chamadas de ferramentas e recusá-las, e que os clientes peçam confirmação nas operações sensíveis. Uma chamada vinda do seu backend não tem essa etapa, a não ser que você a construa.
Falando com franqueza: o ponto dois é o que importa em contratos. Um script que envia um NDA envia exatamente o NDA para o qual foi escrito. Um agente envia o que entendeu que você queria. Para um documento que alguém vai assinar, essa distância precisa de uma trava.

MCP vs API em uma imagem: a API continua a mesma, e o que muda é quem decide a próxima chamada, o seu código ou o agente que lê a sua instrução.
O que o servidor MCP da Chaindoc acrescenta à API REST
O servidor MCP da Chaindoc é de código aberto. O código está no GitHub sob licença MIT, e o pacote se chama @chaindoc_io/mcp-server no npm, na versão 0.2.0 quando conferimos em 14 de outubro de 2026. A maioria das ferramentas corresponde a um único endpoint REST e devolve o resultado numa forma que o modelo sabe ler.
As ferramentas, por grupo
As tabelas principais do README listam 35 ferramentas em dez grupos:
- Documentos: criar, atualizar, definir permissões de acesso, verificar uma versão, ler o status de verificação.
- Assinaturas: criar uma solicitação, ler o status, listar as suas solicitações e assinar.
- Contratos, o grupo mais longo: criar, listar, ler, enviar, cancelar, rescindir, ler a atividade, anexar uma configuração de pagamento.
- Faturas e transações para a cobrança a partir de um contrato assinado: criar, enviar, cobrar, marcar como paga, listar pagamentos.
- Modelos: transformá-los em documento ou contrato, ou enviá-los direto para assinatura.
- Upload de mídia, sessões de assinatura incorporadas, duas verificações de conta e um verificador de webhook.
A versão 0.2.0 acrescentou busca, versões, lembretes, cancelamentos, download do arquivo assinado com o certificado e o ciclo de vida dos modelos.
Resources e prompts
Resources somente leitura, como chaindoc://contracts/{id}/status, ficam ao lado de prompts nomeados, como prepare_signature_request, que conduzem o modelo por uma tarefa mais longa.
Há duas coisas que ele não faz. Não registra webhooks: eles são definidos por chave de API no painel, e a ferramenta de webhook só confere um evento que você já recebeu. E a Chaindoc não hospeda nenhum endpoint: você o executa por stdio ou hospeda o modo HTTP por conta própria.
A verificação é a parte própria da Chaindoc. O servidor calcula o hash do arquivo no upload; quando uma versão é publicada, esse hash vai para a blockchain, e a prova de cada signatário é registrada quando a assinatura termina. As ferramentas de verificação comparam uma versão com esse registro, então um agente consegue responder «este é o arquivo que foi assinado?» sem que ninguém abra o aplicativo.
Acesso ao MCP server nos planos da Chaindoc
Não existe uma chave de API de MCP separada. O servidor roda com uma chave de API comum da Chaindoc, e as chaves são criadas no plano Business. Contas Team podem pedir acesso à API; Free e Personal não criam chaves, e os webhooks são só do Business.
Dois limites moldam o comportamento de um agente. O servidor se limita sozinho a 10 requisições por minuto por padrão, o limite que o guia da API da Chaindoc define, então um agente que percorre cinquenta documentos é lento de propósito. E o tráfego do agente corre pela sua conta como qualquer chamada de API: as solicitações que ele envia saem da mesma cota mensal de assinaturas. Veja os preços atuais antes de deixar um agente enviar em massa.
MCP server e API na Chaindoc: o que cada plano inclui (conferido em 2026-09-20)
| O que o agente precisa | Free | Personal | Team | Business |
|---|---|---|---|---|
Preço | € 0, permanente, sem cartão | € 9 por mês no pagamento mensal, ou € 86 por ano no pagamento anual | € 19 por mês no pagamento mensal, ou € 182 por ano no pagamento anual | € 29 por mês no pagamento mensal, ou € 278 por ano no pagamento anual |
Chaves de API (o servidor MCP roda com uma delas) | Não | Não | Sob consulta | Sim |
Webhooks para eventos de assinatura | Não | Não | Não | Sim |
Assinaturas por mês | 5 | 15 | Cota do Team, veja a página de preços | 100 |
Ordem de assinatura fixa (rotas de aprovação, definidas no aplicativo) | Não | Não | Não | Sim |
Verificações de identidade KYC opcionais por mês | Nenhuma | 1 | 5 | 10 |
Conectar o servidor MCP da Chaindoc ao seu cliente de IA
Seis passos de uma conta Business até um agente funcionando. A maior parte do tempo vai no passo 2: decidir o que a chave pode fazer.
Conferir o plano
As chaves de API são criadas no plano Business; no Team, peça primeiro o acesso à API. Sem chave, o servidor stdio não tem com o que se autenticar.
Criar uma chave só para este agente
No painel da Chaindoc, abra Settings e depois API Keys. Uma chave
pk_é somente leitura: status, listas, verificação. Uma chavesk_pode criar, enviar e assinar. Comece o agente compk_e passe parask_quando quiser que ele envie. As chaves de staging e de produção não funcionam entre ambientes, então guarde as duas.Adicionar o servidor à configuração do seu cliente
O bloco é o mesmo no Claude Desktop, no Claude Code e no Cursor (que lê
.cursor/mcp.json); só muda o lugar do arquivo.Reiniciar e rodar uma verificação de saúde
Reinicie o cliente e peça que ele execute
chaindoc_account_health_checke leia as informações da chave. Duas respostas significam que a chave e o ambiente estão certos.Decidir onde uma pessoa aprova
Ative a confirmação do seu cliente para toda ferramenta que envia, assina, cancela, rescinde ou cobra. O README não descreve nenhuma etapa de aprovação dentro do servidor da Chaindoc, então a confirmação do cliente é a sua trava. Um erro comum: aprovar os primeiros pedidos e depois desligar a confirmação para a sessão inteira.
Ligar os webhooks fora do agente
Se algo deve acontecer quando um contrato é assinado, defina o webhook na chave, em Settings, API Access, apontando para o seu próprio endpoint. Eventos como
signature.request.completedchegam assinados com HMAC-SHA256 no cabeçalhoX-Chaindoc-Signature. O agente pode conferir essa assinatura, mas não pode se inscrever sozinho.
Prefere hospedar o modo HTTP? Rode-o no Docker ou com `npm run start:http` (porta 8787 por padrão, endpoint `/mcp`) e envie a chave como token Bearer no cabeçalho `Authorization`, em vez de no ambiente.
Enviar e assinar não voltam atrás
Depois que um envio ou uma solicitação de assinatura sai, o convite já foi, e cancelar a solicitação depois não o recolhe. Uma assinatura aplicada com uma chave sk_ é a assinatura da sua conta. Dê uma chave pk_ aos agentes que só informam sobre contratos, teste primeiro os agentes sk_ com um documento de staging e deixe a assinatura com a pessoa cujo nome vai na página.
Um agente de IA pode assinar contratos? Só como suas mãos, não em nome próprio
Resumindo: um agente pode apertar o botão, mas a lei nunca o trata como signatário. Signatário é aquele por quem o agente age, e é aí que acabam quase todas as dúvidas sobre contratos com IA.
Nos EUA: ESIGN e UETA
O ESIGN define a assinatura eletrônica como um som, símbolo ou processo executado ou adotado por uma pessoa com a intenção de assinar (15 U.S.C. § 7006(5)): a intenção é de uma pessoa. Para software, 15 U.S.C. § 7001(h) diz que um contrato não perde o efeito porque um agente eletrônico ajudou a formá-lo, desde que a ação do agente seja juridicamente atribuível à pessoa obrigada. A UETA, adotada por todos os estados menos Nova York, atribui a assinatura a quem praticou o ato (§ 9, por exemplo pelo procedimento de segurança usado: num servidor MCP, a chave de API), permite que um contrato se forme entre agentes sem revisão humana (§ 14) e deixa quem lidou com o seu agente e não pôde corrigir um erro anular o registro errado, se agir rápido (§ 10). Um fluxo sem etapa de revisão é um risco que você mesmo constrói.
No Brasil: MP 2.200-2, Lei 14.063 e Código Civil
A lei brasileira parte da mesma ideia: quem assina é uma pessoa. A Lei 14.063/2020, no art. 4º, divide as assinaturas eletrônicas em simples, avançada e qualificada e diz que cada tipo mede o nível de confiança sobre a identidade e a manifestação de vontade do titular. Um agente de IA não tem titularidade nenhuma, então a assinatura que ele dispara é sempre a de alguém. A MP 2.200-2/2001, no art. 10, § 2º, admite outros meios de comprovação de autoria e integridade, desde que as partes os aceitem como válidos ou que sejam aceitos pela pessoa a quem o documento for oposto. Na prática, vale o que as partes aceitaram, e vale ter isso por escrito.
No Código Civil, o art. 116 diz que a manifestação de vontade pelo representante, nos limites de seus poderes, produz efeitos em relação ao representado, e o art. 663 faz do mandante o único responsável quando o mandatário negocia expressamente em seu nome (o mandato nasce do art. 653). Um agente de IA não tem personalidade jurídica e não pode ser mandatário, mas o resultado prático é parecido: o que ele faz dentro do que você permitiu, você assume. Num servidor MCP, esse limite é o alcance da chave de API. O projeto do marco legal da inteligência artificial (PL 2.338/2023) ainda está em tramitação na Câmara dos Deputados, aguardando parecer do relator na comissão especial, e ainda não é lei.
Em Portugal, o ponto de partida é o eIDAS, que no art. 3, ponto 9, define o signatário como pessoa física, e o Decreto-Lei n.º 12/2021, que o executa na ordem jurídica portuguesa. Para empresas que querem marcar documentos sem uma pessoa atrás de cada um, o instrumento europeu é o selo eletrônico, criado por uma pessoa jurídica (art. 3, ponto 24); nosso guia sobre selos eletrônicos para empresas explica quando ele cabe.
Para um fluxo com MCP, a linha prática é simples. Deixe o agente preparar, enviar, cobrar retorno e verificar. A assinatura fica com a pessoa cuja vontade ela registra. Se um agente específico puder assinar um tipo específico de documento por você, decida isso por escrito e de propósito, nunca como padrão. Tome isto como um quadro de referência, não como parecer jurídico sobre o seu contrato.
Uma chave por agente mantém o registro legível
Tudo o que um agente faz pelo servidor MCP corre como chamada de API sob a conta da chave. Se três agentes dividem uma chave, desligar um obriga a trocar a chave dos três, e nada na chave diz qual agente enviou o quê. Dê a cada agente a sua própria chave, com o nome dele. É também a forma mais simples de mostrar depois que autoridade você deu a cada um.
Onde uma pessoa precisa continuar no circuito
Quatro pontos de um fluxo de assinatura merecem uma pessoa. O meio, chato, não é um deles.
- Antes de enviar qualquer coisa. A confirmação do seu cliente deveria cobrir toda ferramenta que envia, assina, cancela, rescinde ou cobra. Chamadas somente de leitura podem rodar sem perguntar.
- Os signatários e a ordem deles. Uma solicitação criada pelo agente convida todos os signatários de uma vez. Se a ordem importa (primeiro o gestor aprova, depois o cliente assina), isso é uma rota de aprovação que você configura no aplicativo da Chaindoc no plano Business, não algo que o agente improvisa.
- A identidade, quando o risco pede. O KYC dos signatários é opcional, pela verificação de identidade da Chaindoc, com cota mensal por plano. Decida por tipo de contrato, não deixe para o modelo.
- O que o agente lê. Um texto pode trazer instruções que você não escreveu: uma linha num PDF enviado, uma nota num registro do CRM. A especificação MCP trata, pelo mesmo motivo, como não confiáveis as anotações de ferramentas de um servidor em que você não confia.
O que pode rodar sem supervisão? Consultas de status, lembretes para quem já tem o documento, a verificação de um arquivo contra o registro na blockchain. Cada documento guarda a sua própria trilha de auditoria, então até as chamadas sem supervisão deixam um registro que você pode reler.
Rode o agente na mesma API que o seu código usa
A API REST da Chaindoc, os webhooks e o servidor MCP de código aberto funcionam com o mesmo conjunto de chaves. Veja o que a API cobre e como começar.
Ver a página de integração de APIO servidor MCP da DocuSign e no que ele difere do da Chaindoc
A DocuSign anunciou em 4 de setembro de 2026 que o seu servidor MCP ficaria disponível para todos em 30 de setembro, com chamadas a partir do Claude, ChatGPT, Gemini, Copilot, Slack e qualquer cliente MCP. A DocuSign o hospeda, e a conexão passa por um login OAuth e uma tela de consentimento, em vez de uma chave colada num arquivo de configuração. É uma vantagem real para a empresa que não quer chaves de API em notebooks, e a Chaindoc hoje não oferece um endpoint hospedado.
No eixo MCP vs API, os dois se parecem: cada servidor envolve a API do seu fornecedor. No controle, porém, a troca vai no sentido oposto. O servidor da Chaindoc é código sob licença MIT que você pode ler, bifurcar e hospedar dentro da sua própria rede, e as ferramentas dele alcançam o registro de verificação na blockchain, além da assinatura. Se você compara uma conexão MCP da DocuSign com a da Chaindoc para um agente, faça três perguntas práticas: quem guarda a credencial, onde o servidor roda e quais ações o agente pode fazer sem a aprovação de uma pessoa.
MCP ou API: em qual construir o seu fluxo de assinatura
Use a API quando o fluxo é fixo. Um negócio vira «ganho», um contrato sai de um modelo, um webhook atualiza o CRM quando alguém assina. Isso é código, precisa se comportar igual toda vez, e um agente só acrescenta variação. Se você quer automação de documentos com IA dentro de um fluxo fixo, chame um modelo a partir do seu próprio código e deixe a API fazer o envio. Nosso comparativo de APIs de assinatura eletrônica diz o que olhar desse lado.
Use o servidor MCP quando o pedido muda toda vez e há uma pessoa na conversa de qualquer jeito: «envie o contrato de prestação de serviços para as duas pessoas da call de ontem», «quais NDAs do mês passado ainda não foram assinados?», «este PDF é a versão que assinamos?». É chato de programar e fácil de dizer. Um exemplo: uma startup em São Paulo deixa um agente preparar e enviar contratos de prestação de serviços, e quem assina é o sócio, pelo link, com o nome dele.
A maioria das equipes acaba com os dois, em chaves separadas, e essa é a resposta honesta sobre MCP ou API. A API executa o que você já decidiu, e o agente cuida do que você ainda não decidiu. Quem chegou aqui perguntando o que é MCP leva o essencial: é a camada que deixa um agente usar a API que você já tem. Nos dois casos, a assinatura fica com uma pessoa.
Fontes conferidas para este guia
Lidas em 14 de outubro de 2026, conforme a nota de cada fonte; os números dos planos da Chaindoc vêm da API de planos, lida em 20 de setembro de 2026.
- 1.Chaindoc MCP server · GitHub (ChaindocIO)Grupos de ferramentas, chaves pk_ e sk_, transportes stdio e HTTP hospedado por você, configuração do cliente; conferido em 2026-10-14
- 2.@chaindoc_io/mcp-server · npmO pacote publicado: versão 0.2.0, licença MIT; conferido em 2026-10-14
- 3.Chaindoc API reference · Chaindoc LabsURL base, chaves de API Bearer, exigência do plano Business; conferido em 2026-10-14
- 4.Webhooks · Chaindoc LabsNomes dos eventos, cabeçalho de assinatura HMAC-SHA256, configuração por chave de API no painel, plano Business; conferido em 2026-10-14
- 5.Tools, Model Context Protocol specification 2026-07-28 · Model Context ProtocolDescoberta e chamadas de ferramentas, recomendação de supervisão humana, pedidos de confirmação, anotações não confiáveis, os dois tipos de erro; conferido em 2026-10-14
- 6.Introducing the Model Context Protocol · AnthropicMCP publicado como padrão aberto em 25 de novembro de 2024; conferido em 2026-10-14
- 7.Linux Foundation announces the formation of the Agentic AI Foundation · Linux FoundationMCP doado à fundação, 9 de dezembro de 2025; conferido em 2026-10-14
- 8.15 U.S. Code § 7001 · Legal Information Institute, Cornell Law School§ 7001(h): contratos formados com agentes eletrônicos obrigam a pessoa a quem a ação é atribuível; conferido em 2026-10-14
- 9.15 U.S. Code § 7006 · Legal Information Institute, Cornell Law SchoolDefinições de agente eletrônico (3) e de assinatura eletrônica (5); conferido em 2026-10-14
- 10.Electronic Transactions Act (UETA, 1999) · Uniform Law CommissionA lei modelo por trás do direito estadual: § 9 atribuição, § 10 erros com um agente eletrônico, § 14 transações automatizadas
- 11.Regulamento (UE) n.º 910/2014 (eIDAS) · EUR-LexArt. 3, ponto 9, signatário como pessoa física; ponto 24, criador de um selo como pessoa jurídica; conferido em 2026-10-14
- 12.Lei n.º 14.063, de 23 de setembro de 2020 · Presidência da RepúblicaArt. 4º: assinatura eletrônica simples, avançada e qualificada; conferido em 2026-10-14
- 13.Medida Provisória n.º 2.200-2, de 24 de agosto de 2001 · Presidência da RepúblicaArt. 10, § 2º: outros meios de comprovação de autoria e integridade, se admitidos pelas partes; conferido em 2026-10-14
- 14.Código Civil (Lei n.º 10.406/2002), arts. 116, 653 e 663 · Presidência da RepúblicaRepresentação e mandato: efeitos da manifestação de vontade do representante; conferido em 2026-10-14
- 15.PL 2.338/2023 (marco legal da inteligência artificial) · Câmara dos DeputadosSituação da tramitação: aguardando parecer do relator na comissão especial; conferido em 2026-10-14
- 16.Decreto-Lei n.º 12/2021, de 9 de fevereiro · Diário da RepúblicaExecução do Regulamento eIDAS na ordem jurídica portuguesa
- 17.Docusign Agreement Layer for the agentic enterprise coming to every agent · DocusignComunicado de 4 de setembro de 2026: servidor MCP disponível para todos em 30 de setembro e os clientes que cita; conferido em 2026-10-14
Perguntas frequentes
Respostas principais sobre a Chaindoc e fluxos seguros de assinatura de documentos.
Uma API é um conjunto de endpoints que o seu código chama na ordem que um desenvolvedor definiu. Um servidor MCP envolve esses endpoints como ferramentas com nome, descrição e esquema de entrada, para que um modelo de IA as descubra em tempo de execução e decida qual chamar. Os endpoints por baixo costumam ser os mesmos. O servidor MCP da Chaindoc, por exemplo, chama a mesma API REST que o seu backend chamaria.
Não. A maioria dos servidores MCP é um invólucro em volta de uma API que já existe, e essa API continua atendendo quem não é agente. O MCP muda quem chama: um modelo que escolhe ferramentas conforme a sua instrução, em vez de código que executa uma sequência fixa. Fluxos fixos, como um contrato enviado quando um negócio fecha no CRM, ficam no código.
Um agente pode disparar uma assinatura, mas nunca é o signatário perante a lei. Pelo eIDAS, o signatário é uma pessoa física (art. 3, ponto 9). No Brasil, a Lei 14.063/2020 classifica as assinaturas pelo nível de confiança na identidade e na manifestação de vontade do titular, e o art. 116 do Código Civil vincula o representado só dentro dos poderes do representante. O ESIGN exige a intenção de uma pessoa. Para uma marca automática sem pessoa atrás, o instrumento europeu é o selo eletrônico. O padrão seguro: o agente prepara e envia, e a pessoa nomeada assina pelo link.
Tem. A DocuSign anunciou em 4 de setembro de 2026 que o servidor MCP ficaria disponível para todos em 30 de setembro, para Claude, ChatGPT, Gemini, Copilot, Slack e outros clientes MCP. Ela o hospeda, e a conexão passa por login OAuth. O servidor da Chaindoc é de código aberto e roda localmente ou no seu próprio host, com uma chave de API.
Crie uma chave de API na Chaindoc (Settings, depois API Keys; plano Business) e adicione à configuração MCP do seu cliente uma entrada chaindoc que execute npx -y @chaindoc_io/mcp-server com a chave em CHAINDOC_API_KEY. O bloco é idêntico no Claude Desktop, no Claude Code e no Cursor, que o guarda em .cursor/mcp.json. Reinicie o cliente e rode a ferramenta de verificação de saúde para confirmar que a chave funciona.
Mais guias sobre assinatura eletrônica e blockchain
Guias práticos sobre assinaturas eletrônicas, trilhas de auditoria em blockchain e gestão segura de documentos, escolhidos para aprofundar o que acabou de ler.


