Skip to content

Iniciar sessão

Iniciar avaliação gratuita

Servidor MCP

The full contract lifecycle, run from Claude over MCP

O servidor MCP da Contracko liga o seu espaço de trabalho de contratos ao assistente de IA que já utiliza. Pergunte ao Claude, ao ChatGPT, ao Gemini ou ao Copilot sobre os seus contratos e eles leem os registos reais: partes, datas, valores e os próprios documentos. Dê-lhes acesso de escrita e eles conseguem importar contratos, definir lembretes e arquivar novos acordos por si.

Mantém-se sempre no controlo. Leitura e escrita são permissões separadas, escolhe quais conceder, e pode desligar a ligação a qualquer momento.

Ligar em dois passos

Adicione as skills para que o assistente saiba como ajudar com contratos. As skills são quatro guias curtos publicados em contracko/contracko-skills.
Adicione a ligação para que possa aceder ao seu espaço de trabalho. Cole este endereço quando lhe for pedido:

https://app.contracko.com/mcp

Abre-se uma janela do browser. Inicie sessão na Contracko, ou comece um período de teste gratuito nesse ecrã se ainda não tiver conta.

Adicionar as skills não liga o seu espaço de trabalho por si só. Se a Contracko já aparecer na lista de conectores do seu assistente, salte o passo 2 em vez de a adicionar duas vezes. Usa o Claude ou o Claude Code? Siga antes os passos do Claude em Ligar o seu assistente: a Contracko está no diretório de conectores do Claude.

Ao iniciar sessão, marque Read para que o assistente possa responder a perguntas. Marque Write apenas se ele dever adicionar ou alterar contratos. Deixe Write desmarcado a menos que o queira.

Escolher acesso de leitura ou escrita

Permissão	O que permite	Quando conceder
Read	Encontrar contratos, ler datas, valores e partes extraídos, pesquisar dentro dos documentos, ver a análise da IA e comentários	Sempre. É suficiente para fazer perguntas sobre o seu espaço de trabalho.
Write	Importar contratos, atualizar campos, adicionar documentos e comentários, criar tipos de contrato e contrapartes, criar, mudar o nome e mover pastas, arquivar contratos nas pastas que consegue ver, definir e alterar lembretes	Apenas quando quiser que o assistente faça alterações. Comece sem esta permissão.

Com Read, o assistente também lhe pode mostrar quem consegue aceder a um contrato ou a uma pasta. Também pode limitar as pesquisas de contratos a uma pasta que consegue ver. As alterações de acesso e a eliminação de pastas são feitas apenas na aplicação Contracko. Peça ao assistente que confirme as alterações propostas antes de as efetuar. Atua em seu nome e só consegue aceder a contratos e pastas a que também tem acesso dentro das permissões do seu espaço de trabalho. Consulte permissões de contratos para saber como o acesso é decidido.

Isto é diferente da Clara AI, que funciona dentro da Contracko. Use a Clara na aplicação e ligue-se via MCP quando quiser trabalhar a partir do Claude, do ChatGPT ou de outro assistente que já tenha aberto.

Encontre os contratos de que precisa

Peça um fornecedor, tipo de contrato, estado, intervalo de datas de término ou intervalo de datas de aviso prévio. O seu assistente pode restringir a lista de contratos antes de ler os resultados. Por exemplo: «Que contratos da Acme terminam ou precisam de aviso prévio no próximo trimestre?» Se vários fornecedores tiverem o mesmo nome, confirme qual pretende.

O seu assistente deve verificar cada página de contratos correspondentes antes de indicar que o resultado está completo. As pesquisas por data excluem contratos sem uma data correspondente, por isso peça as datas em falta separadamente. Uma data de término, por si só, não significa que um contrato seja renovado automaticamente. Perguntas sobre valores, moedas, campos em falta ou cláusulas podem exigir verificações adicionais.

Use a sua ligação existente

OAuth é a forma predefinida de ligar a Contracko ao seu assistente. Não precisa de uma nova ligação, de uma chave de API de substituição nem de permissões adicionais para usar uma pesquisa melhor nos tools que já tem. Se o assistente ainda mostrar opções antigas, atualize os tools ou volte a ligar o conector existente.

Se OAuth não estiver disponível, pode usar uma chave de API MCP dedicada. Envie-a com cada pedido no cabeçalho Authorization: Bearer <a-sua-chave-de-API-MCP>. Guarde a chave em segurança e não a partilhe.

As ações disponíveis dependem da sua ligação e das permissões do espaço de trabalho. Mantenha Read para perguntas. Conceda Write apenas se quiser que o assistente faça alterações. Se faltar uma ação, verifique o espaço de trabalho selecionado e as permissões da ligação ou contacte o apoio.

Verifique alterações incertas antes de tentar novamente

Se o seu assistente não conseguir confirmar se uma alteração foi bem-sucedida, verifique o contrato na Contracko antes de tentar novamente. Um erro nem sempre significa que nada mudou.

Agentes e programadores podem encontrar os argumentos dos tools e orientações para processar respostas nas instruções de configuração para agentes.

Ligar o seu assistente

Escolha o produto que utiliza. Todos os percursos terminam da mesma forma: inicie sessão na janela do browser que se abre.

Claude

Para o Claude na web, no computador, no telemóvel e no Cowork.

Abra a Contracko no diretório de conectores do Claude.
Escolha Connect to Claude.
Inicie sessão na Contracko na janela que se abre.

Funciona em todos os planos do Claude, incluindo o Free. No Team e no Enterprise, um Owner tem de o ativar primeiro. Um conector adicionado na web ou no computador também funciona na app móvel do Claude.

A partir do Pro, pode também instalar o plugin Contracko (Customize → Plugins) para as quatro skills de contratos e depois ligar-se a partir do separador Connectors do plugin.

Adicionou a Contracko antes como conector personalizado? Remova-o, ou verá cada ferramenta duas vezes.

ChatGPT

Vá a Settings → Plugins → Import marketplace e introduza contracko/contracko-skills.
Ative o Developer mode.
Vá a Settings → Apps → Create e cole https://app.contracko.com/mcp.
Inicie sessão na janela que se abre.

Grok

Abra grok.com/connectors.
Adicione https://app.contracko.com/mcp.
Inicie sessão na janela que se abre.

Claude Code

Tem sessão iniciada com a sua conta Claude? Um conector adicionado no Claude já está disponível aqui, por isso não há nada a adicionar.

Para as skills, instale o plugin. Ele também regista a ligação:

/plugin marketplace add https://github.com/contracko/contracko-skills.git
/plugin install contracko@contracko

Use o endereço completo do GitHub, não um nome curto owner/repo. Depois escreva /mcp na sessão e inicie sessão.

Usa uma chave de API sem o plugin? Execute isto apenas se claude mcp list não mostrar nenhuma entrada da Contracko:

claude mcp add --transport http contracko https://app.contracko.com/mcp

Depois escreva /mcp e inicie sessão.

Codex

npx skills@latest add contracko/contracko-skills
codex mcp add contracko --url https://app.contracko.com/mcp
codex mcp login contracko

Cursor

npx skills@latest add contracko/contracko-skills

Depois adicione isto a .cursor/mcp.json no seu projeto, criando o ficheiro se ainda não existir:

{ "mcpServers": { "contracko": { "url": "https://app.contracko.com/mcp" } } }

Reinicie o Cursor se ele não detetar a ligação.

GitHub Copilot no VS Code

npx skills@latest add contracko/contracko-skills

Depois adicione isto a .vscode/mcp.json:

{ "servers": { "contracko": { "type": "http", "url": "https://app.contracko.com/mcp" } } }

Gemini CLI

npx skills@latest add contracko/contracko-skills

Depois adicione isto a ~/.gemini/settings.json:

{ "mcpServers": { "contracko": { "httpUrl": "https://app.contracko.com/mcp" } } }

OpenClaw

npx skills@latest add contracko/contracko-skills
openclaw mcp set contracko '{"url":"https://app.contracko.com/mcp","transport":"streamable-http"}'
openclaw mcp configure contracko --auth oauth
openclaw mcp login contracko

Hermes

npx skills@latest add contracko/contracko-skills

Depois adicione isto a ~/.hermes/config.yaml:

mcp_servers:
  contracko:
    url: "https://app.contracko.com/mcp"
    auth: oauth

Execute hermes mcp login contracko e inicie sessão.

Qualquer outro assistente

Cole isto no assistente e deixe-o seguir as instruções:

Fetch and execute https://contracko.com/mcp/install/prompt.md

Se preferir adicionar a ligação manualmente, o endereço continua a ser https://app.contracko.com/mcp.

Experimente perguntar

Depois de ligado, fale com o assistente como falaria com um colega.

Experimente perguntar	O que faz
Estamos a fazer o onboarding deste cliente. Importa todos os PDFs desta pasta para a Contracko.	Encontra os ficheiros, confirma o conjunto consigo, importa-os e deixa a Contracko extrair datas, partes e tipos.
Não quero renovações silenciosas. O que precisa de aviso prévio, termina ou renova automaticamente no próximo trimestre? Cria lembretes para tudo isso.	Lista as datas que importam e depois cria lembretes para ser avisado a tempo.
Compara o MSA da Acme com o da Beta. Quem tem o melhor limite de responsabilidade, condições de rescisão e de tratamento de dados?	Coloca os dois registos lado a lado, com as cláusulas citadas.
Audita os nossos contratos de fornecedores à procura de responsabilidade ilimitada, indemnizações unilaterais e prazos de aviso em falta.	Percorre a carteira e cita a frase por trás de cada resultado.
A nossa organização está uma confusão. Ajuda-me a acordar uma estrutura de pastas para MSA, NDA, SOW e DPA, cria-a depois e arquiva nela os nossos contratos.	Confirma a estrutura consigo, depois cria as pastas e arquiva os contratos a que tem acesso. Também estrutura os tipos, campos e contrapartes que utiliza.
No que devíamos focar-nos este mês? O que é urgente e o que nos está a escapar?	Ordena o espaço de trabalho por urgência e lacunas.
Guia-me na criação de um novo NDA, envia-o para assinatura e arquiva o PDF assinado quando voltar.	Executa o questionário e depois arquiva a cópia assinada.

Não precisa de indicar o nome de uma skill. Perguntar em linguagem natural é suficiente.

O que fazem as skills

Skill	Para que serve
`contracko`	Ligar, e depois organizar tipos de contrato, campos personalizados, contrapartes e pastas
`contracko-import`	Importar PDFs e ficheiros Word a partir do disco, Drive, SharePoint, Box ou de um link
`contracko-review`	Datas de aviso prévio, lembretes, comparações, linguagem de risco e o que ver a seguir
`contracko-create`	Um novo acordo, desde as perguntas até ao arquivo do PDF assinado

Ligar com um token em vez disso

Use o início de sessão no browser (OAuth) para a maioria das ligações. Se o seu cliente ou automação não o puder usar, crie uma chave de API MCP dedicada em Contracko: Settings → Integrations → API keys. Configure o cliente para a enviar como cabeçalho Authorization: Bearer para https://app.contracko.com/mcp. Guarde a chave nas definições secretas do cliente, não em chats ou ficheiros partilhados. Ambos os métodos de ligação respeitam o acesso que concede e as permissões do seu espaço de trabalho.

Gerir ligações na Contracko

Depois de aprovar o acesso, o assistente aparece em MCP Connections em Settings → Integrations. Pode ver quem ligou, que acesso tem e quando foi usado pela última vez.

Pode desligar qualquer ligação da lista. Só quem a ligou pode aprovar acesso OAuth extra. Só os proprietários e os admins podem criar, alterar ou revogar API keys.

Ver uma ligação

Abra Settings e depois Integrations.
Encontre o assistente em MCP Connections.
Abra o menu da linha e escolha Manage connection.

A janela mostra Connected by, Last used e Current access.

Desligar um assistente

Escolha Disconnect no menu da linha, ou abra Manage connection e use o controlo para desligar.
Confirme Disconnect.

Esse assistente perde o acesso a este espaço de trabalho. As outras ligações mantêm-se. Remova também o conector no assistente, senão pede-lhe para iniciar sessão outra vez.

Alterar o acesso ou rodar a autorização

Não pode alterar as permissões OAuth neste ecrã. Para mudar Read ou Write, volte a ligar a partir do assistente e aprove novamente as permissões.

Na Contracko, abra Manage connection e escolha Connection setup se precisar do endereço MCP ou dos passos do cliente.
No assistente, volte a ligar a Contracko e inicie sessão.
No ecrã de aprovação, selecione Read. Selecione Write só se o assistente deve alterar contratos.
Escolha Disconnect na ligação que já não usa, para o mesmo assistente não aparecer duas vezes.

Voltar a ligar é também a forma de rodar a autorização OAuth. Não existe um botão separado para rodar o token.

Rodar ou revogar uma chave de API

As ligações por token gerem-se em API keys na mesma página, não em MCP Connections.

Crie uma nova chave MCP server se ainda precisar de um token. Copie o segredo uma só vez.
Coloque o novo segredo no cabeçalho Authorization: Bearer do cliente.
Abra a chave antiga e escolha Revoke key.

Manage key pode acrescentar acesso sem alterar o segredo. As chaves caducam ao fim de 12 meses.

Resolver problemas comuns

"A sua ligação à Contracko precisa de ser renovada." A ligação expirou. Volte a ligar-se a partir das definições de conectores do seu assistente e inicie sessão novamente.

O assistente diz que não encontra uma ferramenta. Verifique o espaço de trabalho selecionado e as permissões da ligação, depois atualize os tools do assistente. Conceda Write apenas se quiser que faça alterações. Contacte o apoio se a ação continuar em falta.

O assistente não consegue ver um contrato que consegue ver. Verifique que iniciou sessão no espaço de trabalho certo e que o contrato está partilhado consigo na Contracko.

A Contracko aparece duas vezes. Tem duas ligações ao mesmo servidor. No Claude, remova o conector personalizado que adicionou antes e mantenha o do diretório de conectores. No Claude Code, se instalou o plugin e também executou claude mcp add, execute claude mcp remove contracko. Noutros assistentes, remova o conector duplicado. Adicionar as skills e adicionar a ligação são passos separados, e adicionar a ligação duas vezes cria duas entradas.

Antes de partilhar contratos reais

A Contracko não treina modelos com os seus contratos, e a nossa análise funciona sob termos comerciais de API com Zero Data Retention quando disponível.

Ligar um assistente é diferente. Quando o Claude, o ChatGPT ou outro produto chama a Contracko, o texto do seu contrato é enviado para esse produto, e a Contracko não pode controlar o que lhe acontece aí. Desative o treino de modelos nesse produto antes de o usar com contratos reais. Consulte Segurança para saber como tratamos os seus dados do nosso lado.

Obter ajuda

Para questões sobre a própria Contracko, leia a documentação ou contacte-nos.

Para uma questão sobre as skills, uma sugestão ou uma melhoria, abra uma issue no repositório das skills.

Se quiser a versão legível por máquina desta documentação para um agente ou motor de indexação, veja acesso de agente LLM.