--- title: "MCP de Parser de Contratos para a IA que já usa" description: "Liga o Claude, ChatGPT, Codex ou outro cliente MCP aos trabalhos de extração, créditos, preflight, uploads seguros e resultados estruturados da Contracko." canonical: "https://contracko.com/pt/mcp/parsing" --- # MCP de Parser de Contratos para a IA que já usa Source: https://contracko.com/pt/mcp/parsing # MCP de Parser de Contratos para a IA que já usa Verifique créditos, valide um lote, crie carregamentos seguros, inicie jobs de parsing e recupere resultados estruturados através de uma ligação MCP com governação. [Iniciar período de experiência gratuito de 7 dias](https://app.contracko.com/register?appLanguage=pt) Marcar demonstração Não é necessário cartão de crédito Ver vídeo Configure o Contracko MCP para o seu agente ## Um fluxo de parser que a IA consegue seguir Cada passo é explícito, auditável e sustentado pelos mesmos controlos da plataforma de parsing. ### Conhecer o custo antes de enfileirar Verifique créditos disponíveis e pré-valide o lote proposto antes de criar trabalho pago. > “Consulte os nossos créditos de parser e faça pré-análise de um lote de 12 extrações antes de enfileirar qualquer elemento.” ### Carregar através de handoff seguro Crie URLs de carregamento de curta duração para os ficheiros que o seu cliente consegue transferir, sem colocar bytes de ficheiros nos argumentos de ferramentas MCP. > “Crie URLs de carregamento para estes três contratos e diga quais os ficheiros que ainda precisam de transferência.” ### Acompanhar jobs até resultados estruturados Crie um job de parsing, confira o estado e recupere a extração concluída a partir da conversa. > “Inicie o lote aprovado e depois liste os jobs e resuma os ficheiros concluídos versus falhados.” ## Upload e parsing são passos separados Esta separação mantém ficheiros grandes fora dos argumentos do chat e evita prometer suporte que o cliente não possui. 1. 01 Pré-análise do lote Valide contagem de ficheiros e créditos necessários antes de qualquer job de parser ser admitido. 2. 02 Transferir os ficheiros suportados O Claude, o ChatGPT ou o Codex carrega os bytes para o URL temporário do Contracko. Se não conseguir, faça o upload na app Contracko e continue lá. 3. 03 Enfileirar e recuperar Crie o job apenas após o upload, depois monitorize o estado e recupere o resultado estruturado quando estiver pronto. ## Liga o Contracko MCP ao Claude, ChatGPT, Codex ou à tua CLI Escolhe o teu assistente para passos de configuração ajustados ao seu suporte MCP atual, desde um conector em dois cliques até um único comando no terminal. Endpoint MCP do Contracko https://app.contracko.com/mcp Prompt de instalação Configure o Contracko MCP para o seu agente Claude ChatGPT / Codex Cursor CLI, VS Code e agentes de código Microsoft 365 Copilot ### Claude Adicione o Contracko com um clique a partir do diretório de conectores do Claude. Funciona na web, no ambiente de trabalho, no telemóvel e no Cowork, em todos os planos do Claude, incluindo o Free. Em Team e Enterprise, um Owner ativa-o primeiro. A partir do Pro, também pode instalar o plugin Contracko (Customize, Plugins) para as quatro skills de contratos e depois ligar-se a partir do separador Connectors do plugin. 1. Escolha Connect to Claude, inicie sessão no Contracko e escolha o seu workspace. O Claude Code com a mesma conta Claude também passa a ter o conector. 2. Já tinha adicionado o Contracko como conector personalizado? Remova esse, ou verá cada ferramenta duas vezes. [Ligar ao Claude](https://claude.ai/directory/connectors/contracko) ### ChatGPT / Codex O ChatGPT liga-se a servidores MCP na forma de apps. Em Business e Enterprise cria uma em developer mode, e um administrador pode publicá-la para todo o workspace. O developer mode do Pro é apenas de leitura. 1. Abra Settings → Security and login e ative o Developer mode. 2. Adicione uma aplicação com o endpoint da Contracko e inicie sessão com OAuth. Opcionalmente, um administrador pode publicá-la para todo o workspace em Workspace settings → Apps. [Abrir plugins do ChatGPT](https://chatgpt.com/plugins) [Ler orientação de configuração do ChatGPT](https://help.openai.com/en/articles/12584461-developer-mode-apps-and-full-mcp-connectors-in-chatgpt-beta/) ### Cursor O Cursor instala um servidor MCP personalizado diretamente a partir de uma ligação, por isso não há nenhum ficheiro de configuração para editar. Clica no botão, confirma o servidor no Cursor e inicia sessão com a tua conta Contracko. 1. Clica em Adicionar ao Cursor. O Cursor abre-se e pede-te para confirmares o servidor contracko e o respetivo endpoint. 2. Inicia sessão com OAuth e escolhe um espaço de trabalho. As ferramentas do Contracko passam a aparecer na lista MCP do Cursor. O primeiro comando abaixo é o prompt de configuração; o segundo adiciona a biblioteca de skills. [Adicionar ao Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=contracko&config=eyJ1cmwiOiJodHRwczovL2FwcC5jb250cmFja28uY29tL21jcCJ9) [Documentação MCP Cursor](https://cursor.com/docs/mcp/install-links) - Prompt de configuração Fetch and follow the setup instructions for Contracko MCP at https://contracko.com/mcp/install/prompt.md - Skills, cada ferramenta npx skills add https://contracko.com - **Q:** Claude Code **A:** Codex CLI codex mcp add contracko --url https://app.contracko.com/mcp ### Microsoft 365 Copilot Ativado por admin O Microsoft 365 Copilot só chega a ferramentas externas através de conectores federados: em leitura, publicados pelo fornecedor e ativados pelo seu administrador Microsoft 365. Os fluxos de escrita do Contracko não se instalam diretamente no Copilot Chat. 1. Peça ao seu administrador Microsoft 365 para ativar o conector Contracko apenas de leitura assim que estiver listado na Connectors Gallery. 2. Depois ligue-o você mesmo em Copilot Chat → Settings → Sources e inicie sessão no Contracko. Discutir implementação do Copilot ## Tu manténs o controlo, seja qual for o assistente. O Claude, o ChatGPT ou o teu próprio agente de código só vê o que a tua conta consegue alcançar, e nada é escrito, alterado ou eliminado sem a tua aprovação. Isso é mais seguro do que uma chave API permanente, e permite-te manter o assistente que já conhece o teu trabalho. ### És tu quem manda O assistente atua como tu, dentro do espaço de trabalho que escolheste, e nunca tem conta própria. Tudo o que tu não consegues abrir no Contracko, Claude ou ChatGPT, ele também não consegue abrir. ### Leitura e escrita são separadas Aprova o acesso de leitura ou de escrita no momento da ligação, e as ações com permissão de escrita passam pelo passo de aprovação do seu cliente antes de serem executadas. ### Todas as ações ficam visíveis Os registos criados e atualizados passam pela validação normal e ficam no histórico de atividade, identificados como provenientes do MCP. ## Perguntas sobre Parser MCP Créditos, uploads, admissão de jobs e compatibilidade de clientes explicados com clareza. - **Q:** O que é um servidor MCP, e porque deverias usá-lo? **A:** O MCP, o Model Context Protocol, é uma norma aberta que permite a assistentes de IA como o Claude e o ChatGPT ligarem-se a ferramentas e dados externos. Um servidor MCP expõe aquilo que um produto sabe fazer, e o da Contracko expõe os teus contratos, prazos e revisões. A ideia é que deixes de andar a trocar de ferramenta: pede uma verificação de renovação ou uma análise de risco no assistente que já tens aberto, e a resposta vem dos teus contratos reais em vez de algo que colaste. - **Q:** Que assistentes de IA posso ligar? **A:** Claude na web, no ambiente de trabalho, no telemóvel e no Cowork, a partir do diretório de conectores do Claude, e Claude Code, através do plugin Contracko. ChatGPT, através das suas próprias definições de conector. Cursor, com um clique. Codex, Codex CLI, Warp, Kilo Code, Qwen Code, Antigravity, VS Code e GitHub Copilot no VS Code, através da sua configuração MCP. Microsoft 365 Copilot, quando um administrador ativa o conector só de leitura. Também o Gemini CLI, embora a aplicação Gemini ainda não suporte servidores MCP personalizados. Qualquer cliente que fale MCP sobre HTTP com OAuth funciona, o [prompt de configuração](https://contracko.com/pt/mcp/install/prompt.md) guia cada um deles, e a [documentação de configuração](https://contracko.com/pt/docs/mcp-server) cobre o resto, incluindo Grok, OpenClaw e Hermes. - **Q:** O servidor MCP está incluído no meu plano? **A:** Sim. Todos os planos Contracko incluem-no, sem custo adicional e sem complemento para comprar. Ligas-te com a tua própria conta, por isso o que podes fazer através de um assistente é exatamente o que já podes fazer na aplicação Contracko. - **Q:** Verificar ou pré-analisar um lote utiliza créditos de parser? **A:** Não. A verificação de créditos e pré-análise validam o trabalho antes da admissão da fila. Os créditos são comprometidos quando um job de parsing elegível é admitido com sucesso. - **Q:** Posso arrastar ficheiros para qualquer chat e pedir ao MCP para analisar-os? **A:** Só quando esse cliente consegue transferir os bytes para o URL de upload seguro devolvido pelo Contracko. O MCP em si não transporta os bytes dos documentos. Use a app Contracko quando o cliente não conseguir concluir o upload. - **Q:** O que acontece se o registo de atividade falhar após um job ser enfileirado? **A:** Um job de parsing admitido com sucesso permanece enfileirado. O registo de atividade da fila é gravado no Contracko na melhor tentativa, para que uma falha no registo não provoque repetição e crie trabalho duplicado. - **Q:** Existe uma biblioteca de skills para o meu agente? **A:** Sim. A [biblioteca aberta de skills do Contracko](https://github.com/contracko/contracko-skills) ensina o Claude Code, o Codex, o Cursor e outros agentes a ligarem-se, importar uma pilha de contratos, rever renovações e risco, e criar e arquivar novos acordos. Ligue primeiro o servidor MCP com o prompt de configuração nesta página. Os agentes de código podem depois instalar as skills com npx skills add https://contracko.com ou como plugin do Claude Code. - **Q:** Em que é que isto difere da API da Contracko? **A:** A [API de gestão de contratos](https://contracko.com/pt/funcionalidades/api-gestao-contratos) e a [API de Parsing](https://contracko.com/pt/developers/api/parsing/reference) destinam-se a software que um programador cria e executa. O servidor MCP destina-se a um assistente com quem uma pessoa fala, por isso não há nada para escrever nem para alojar. De qualquer forma passas pelas mesmas permissões do workspace e deixas o mesmo rasto de auditoria, por isso a diferença está em quem conduz, não no que é permitido. - **Q:** Os meus contratos são usados para treinar modelos de IA? **A:** Não pelo Contracko. Ao abrigo das condições de API comerciais de cada fornecedor de IA, o conteúdo dos clientes está excluído do treino de modelos, e temos vários acordos de Zero Data Retention com fornecedores de IA. O seu cliente de IA é um fornecedor separado com definições próprias: desative aí o treino de modelos (o Claude, o ChatGPT e o Gemini têm cada um uma opção) antes de ligar contratos reais. Os detalhes estão na nossa [página de segurança](https://contracko.com/pt/funcionalidades/seguranca). ## Produtos MCP [MCP de Gestão de Contratos Gestão de contratos com IA no teu assistente: extrai cláusulas, sinaliza riscos e responsabilidades, revê, compara e acompanha datas de renovação. Seguro por predefinição.](https://contracko.com/pt/mcp/contract-management) ## Introduza a extração contratual no seu fluxo de IA Ligue o MCP de Parser, valide primeiro o lote e mantenha explícita a admissão paga da fila. [Iniciar período de experiência gratuito de 7 dias](https://app.contracko.com/register?appLanguage=pt) [Ver preços da plataforma de parsing](https://contracko.com/pt/parsing-platform#parsing-pricing) Agente de IA a ler isto? A página inteira também está disponível em [Markdown](https://contracko.com/pt/mcp/parsing.md)