Ligar assistentes de IA (MCP)

A CUTL pode trabalhar dentro do seu assistente de IA. Em vez de navegar pela aplicação web, diz ao Claude, ao ChatGPT, ao Gemini ou ao Cursor o que pretende em linguagem simples ("Crie um projeto para a Van Dijk a partir destes três DXF, S235 de 3 mm, 50 de cada, e diga-me o total") e o assistente faz isso por si na CUTL: cria o projeto, adiciona os desenhos, lê o orçamento, envia-o por e-mail, lança a produção, executa o nesting, lê relatórios, abre modelos STEP, orçamenta montagens e configura a sua oficina.

O que é o MCP

O MCP (Model Context Protocol) é a norma aberta que os assistentes de IA usam para chamar ferramentas externas. A CUTL tem um servidor MCP: um conjunto de ferramentas que o seu assistente pode chamar em seu nome, com os direitos da sua função na sua equipa.

Tudo o que o assistente faz acontece como se fosse o próprio utilizador e aparece de imediato na CUTL como projetos, peças, orçamentos e tarefas de produção normais. O que cada ferramenta faz está descrito em O que os assistentes de IA podem fazer.

Conjuntos de ferramentas e os seus endereços

As ferramentas da CUTL estão agrupadas em conjuntos de ferramentas. Cada conjunto tem o seu próprio endereço de servidor e é adicionado ao assistente como um conector separado. Adicione apenas os que usa: um assistente escolhe as ferramentas com menos fiabilidade a partir de uma lista muito longa, e um orçamentista normalmente só precisa do Principal.

Token ou início de sessão

Há duas formas de ligar um assistente. Em ambas, ele age como o próprio utilizador: pode ler e alterar exatamente o que a sua função na CUTL lhe permite ler e alterar, e nada mais.

O separador Integrações

Tudo o que diz respeito aos assistentes está na página Configurações, separador Integrações. De cima para baixo, mostra:

1. Conectar um assistente de IA: os URLs dos servidores, cada um com um botão Copiar; Conjunto de ferramentas para os exemplos, um seletor que decide que endereço usam os textos de configuração (Principal vem escolhido de início); um separador por assistente com o seu texto de configuração e Copiar; o aviso sobre tokens; uma linha sobre dados e privacidade; e os Limites de moedas do assistente.
2. A lista de tokens, com Gerar token. Contém todos os tokens da equipa com o seu rótulo, quem o criou, quando expira, quando foi usado pela última vez e o seu estado (Ativo, Expirado, Revogado), e um botão Revogar.
3. Assistentes ligados: os assistentes que ligou através de início de sessão, cada um com Desligar.
4. Clientes registados: apenas para administradores da equipa.

Se um bloco não puder ser carregado, é simplesmente omitido e o resto do separador continua a funcionar.

Criar um token

O token só é inserido no texto de configuração nesta página, até sair dela ou a recarregar. Se o perder, revogue-o e crie um novo.

Uma equipa pode ter no máximo 5 tokens ativos. Um sexto é recusado com "Revogue primeiro um token não utilizado: máximo de 5 ativos." Qualquer membro pode criar um token e revogar qualquer token da equipa. Um token age sempre como a pessoa que o criou e deixa de funcionar se essa pessoa sair da equipa.

Ligar cada assistente

O separador de cada assistente em Configurações > Integrações tem o seu próprio texto de configuração com um botão Copiar. Os menus dentro dos assistentes mudam com frequência: consulte a documentação atual do fornecedor se um nome não corresponder.

Claude Code (token)

Crie um token no separador Claude Code, copie o comando e execute-o no seu terminal. Adiciona um servidor chamado cutl:

claude mcp add --transport http cutl https://api.cutl.online/mcp --header "Authorization: Bearer <token>"

Para outro conjunto de ferramentas, altere Conjunto de ferramentas para os exemplos, copie de novo o comando e mude o nome cutl (por exemplo para cutl-step), porque dois servidores não podem ter o mesmo nome. O mesmo token funciona com todos os conjuntos.

O Claude Code também pode iniciar sessão em alternativa: execute o comando sem a parte --header e siga o pedido de início de sessão do Claude Code. A CUTL mostra então a página de consentimento.

Cursor (token)

Crie um token no separador Cursor e coloque o bloco em ~/.cursor/mcp.json (todos os projetos) ou em .cursor/mcp.json de um projeto. Se o ficheiro já tiver uma secção "mcpServers", adicione apenas a entrada "cutl" dentro dela. Depois reinicie o Cursor ou recarregue os seus servidores MCP.

{
  "mcpServers": {
    "cutl": {
      "url": "https://api.cutl.online/mcp",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

Gemini CLI (token)

Crie um token no separador Gemini CLI e adicione a entrada "cutl" em "mcpServers" no settings.json do Gemini CLI. É o mesmo bloco que para o Cursor, com "httpUrl" em vez de "url". Depois reinicie o Gemini CLI.

{
  "mcpServers": {
    "cutl": {
      "httpUrl": "https://api.cutl.online/mcp",
      "headers": { "Authorization": "Bearer <token>" }
    }
  }
}

Claude.ai e Claude Desktop (início de sessão)

Copie o endereço do separador Claude.ai / Desktop. No Claude, vá a Settings, Connectors, Add custom connector e cole-o. O Claude abre a CUTL: inicie sessão se lhe for pedido, verifique a página de consentimento e prima Ligar. Não é preciso token. Numa organização Claude Team ou Enterprise, é um proprietário que adiciona o conector, e os membros ligam-se depois. Para outro conjunto de ferramentas, adicione outro conector com o endereço desse conjunto.

ChatGPT (início de sessão)

Apenas ChatGPT Business, Enterprise ou Edu, e apenas na aplicação web. Copie o endereço do separador ChatGPT, ative o modo de programador no ChatGPT, adicione um conector com o endereço e inicie sessão na CUTL. Não é preciso token. O ChatGPT também pode passar diretamente à CUTL os ficheiros que anexar na conversa.

Gemini Enterprise (início de sessão com um cliente registado)

1. Um administrador da equipa CUTL regista um cliente (ver Clientes registados) com o endereço de redirecionamento indicado pelo administrador do Gemini Enterprise, e entrega-lhe o ID do cliente e o Segredo do cliente.
2. O administrador do Gemini Enterprise adiciona o endereço da CUTL como conector, com OAuth, esse ID e segredo de cliente, e ativa o PKCE.
3. Um utilizador do conector é enviado para a página de consentimento da CUTL, que mostra Registado pela sua equipa, e prime Ligar.

A página de consentimento

Quando um assistente se liga através de início de sessão, a CUTL mostra a página Ligar um assistente (depois do início de sessão normal da CUTL, se ainda não tiver sessão iniciada). Esta mostra:

• que assistente se quer ligar;
• Depois de decidir, será enviado para: o endereço onde o assistente o vai receber de volta, por exemplo claude.ai. Verifique se é o endereço do seu assistente; se não for, prima Negar;
• Identificado por: Uma identidade de cliente publicada (o assistente publicou a sua identidade no seu próprio endereço web, como faz o Claude), Autorregisto (não verificado) (a CUTL não pode garantir quem o gere) ou Registado pela sua equipa;
• Equipa e Sessão iniciada como: a equipa e a pessoa em nome de quem o assistente vai agir, e o Conjunto de ferramentas;
• Poderá: "Usar o CUTL em seu nome, com os seus direitos" e "Manter-se ligado até o desligar";
• que o fornecedor do assistente verá o que o assistente ler da CUTL, como nomes de projetos, orçamentos e dados de clientes;
• uma contagem decrescente: o pedido expira em 10 minutos.

Prima Ligar para permitir ou Negar para recusar; em ambos os casos é enviado de volta para o assistente. Um pedido aberto depois de 10 minutos, pela segunda vez ou por outra pessoa indica "Este pedido expirou ou já foi usado: inicie a ligação novamente a partir do seu assistente."

O assistente renova o seu acesso sozinho e mantém-se ligado enquanto usar a CUTL pelo menos a cada 30 dias. Para o terminar de imediato, prima Desligar em Assistentes ligados. Remover o conector dentro do assistente não termina a ligação do lado da CUTL: desligue-o também na CUTL. Cada pessoa vê apenas as suas próprias ligações.

Clientes registados (administradores da equipa)

Para assistentes que não se conseguem registar sozinhos, como o Gemini Enterprise, um administrador da equipa regista um cliente em Clientes registados, Registar um cliente:

Depois de Registar, a janela Cliente registado mostra o ID do cliente e o Segredo do cliente. O segredo é mostrado apenas uma vez e não pode ser recuperado depois: copie ambos e prima Já copiei. Eliminar remove um cliente, e os assistentes que o usam deixam de funcionar. Um segredo perdido obriga a eliminar o cliente e a registar um novo.

Limites de moedas do assistente

Algumas ferramentas gastam moedas, exatamente como a mesma ação na CUTL: adicionar um desenho a um projeto (um cálculo de peça por peça), copiar um projeto (um cálculo por peça) e calcular o preço das peças de uma montagem (um cálculo de peça por peça iniciada). Todas as outras ferramentas são gratuitas. O assistente pode indicar-lhe os preços e o seu saldo. Consulte Moedas e faturação.

Para além do seu saldo, os Limites de moedas do assistente da equipa limitam o que todos os assistentes da equipa podem gastar em conjunto, seja qual for a pessoa ou o token que gastou. Não limitam o que as pessoas gastam na aplicação web.

Por baixo dos campos vê o que foi usado na última hora e hoje. Só um administrador da equipa pode alterar os limites, com Guardar e Repor os valores predefinidos; os restantes veem-nos só para leitura. Cada limite tem de ser maior que 0, o limite por chamada não pode exceder o limite por hora, e o limite por hora não pode exceder o diário. Um campo vazio significa "usar a predefinição", e as predefinições são preenchidas antes destas verificações: com o limite por chamada predefinido de 2000, um limite por hora de 1000 é recusado até baixar também o limite por chamada.

Quando uma chamada ultrapassaria um limite, o assistente diz-lhe qual, quanto resta e quando volta a haver margem, por exemplo "Esta chamada custaria 2500 moedas; o limite por chamada para assistentes é 2000. Divida o trabalho em chamadas mais pequenas ou aumente o limite na página de ligação." A "página de ligação" nestas mensagens é o separador Integrações.

Perguntar primeiro o preço

As três ferramentas faturadas podem fazer uma simulação: verificam tudo (ficheiros, materiais, o estado do projeto) e dizem quanto custaria, sem fazer nem cobrar nada. Pergunte ao assistente "Quanto custaria isso? Ainda não o faça" e depois "OK, faça-o". Uma simulação não verifica os limites de moedas; a chamada real verifica. Repetir o mesmo carregamento nunca cobra duas vezes.

Enviar ficheiros para a CUTL: o link de carregamento

Os assistentes num navegador ou num telemóvel nem sempre conseguem entregar um ficheiro, por isso a CUTL dá a todos os assistentes um link de carregamento.

Um ficheiro com outro tamanho é recusado: "Este não é o ficheiro que o assistente anunciou (eram esperados 49 352 bytes). Peça-lhe um novo link." Um nome diferente com o tamanho certo só dá um aviso e o ficheiro é carregado na mesma. Um link expirado indica "Este link expirou: peça um novo ao assistente." A parte secreta do link é removida da barra de endereço assim que a página abre, pelo que recarregar a página indica que o link está incompleto ou danificado: abra novamente o link original a partir da conversa.

Os assistentes no seu computador (Claude Code, Cursor, Gemini CLI) podem carregar o ficheiro sozinhos. Para um projeto, um assistente pode também dar à CUTL um link https público para um desenho, e o ChatGPT pode passar um ficheiro que anexou na conversa. Os ficheiros para as ferramentas STEP e de montagens chegam apenas através de um link de carregamento.

Ações que confirma

As ações que chegam a pessoas fora da conversa ficam retidas pelo servidor da CUTL até as confirmar, decida o assistente o que decidir.

Na conversa, o assistente mostra-lhe primeiro uma pré-visualização do que vai fazer e só age quando concordar.

Na página de confirmação, o assistente dá-lhe um link. Abra-o com sessão iniciada na CUTL como a mesma pessoa em nome de quem o assistente age, verifique a pré-visualização (um endereço novo aparece destacado) e prima Confirmar ou Recusar. Depois volte ao assistente e diga-lhe para continuar: a própria página não executa nada. Uma confirmação expira 10 minutos depois de o assistente a pedir. Em seguida, a página mostra uma destas mensagens:

• "Feito: volte ao seu assistente e diga-lhe para continuar."
• "Recusado. Nada foi feito; pode voltar ao seu assistente."
• "Feito: o assistente já executou isto."
• "Esta confirmação expirou. Peça ao seu assistente para recomeçar."
• "Esta confirmação não existe ou pertence a outra pessoa." (um link errado, ou de outra pessoa)

Limites e erros

O assistente não pode premir botões onde a CUTL quer uma pessoa: confirmar um lançamento, verificar as leituras de um enriquecimento, escolher desenhos num PDF com vários desenhos ou responder a uma pergunta de PDF para STEP. Diz-lhe para fazer esse passo na CUTL e continua depois.

O servidor de demonstração

Para experimentar a CUTL a partir de um assistente sem conta, ligue o servidor de demonstração sem autenticação:

claude mcp add --transport http cutl-demo https://mcp-demo.cutl.online/mcp/demo

Noutros assistentes, adicione https://mcp-demo.cutl.online/mcp/demo como servidor sem token e sem início de sessão. É uma oficina de chapa fictícia com seis ferramentas só de leitura: procurar projetos, estado da produção, explicar o preço de uma peça, relatórios, consultar materiais e clientes, e resultados de nesting. Ali não é possível criar, alterar, carregar, enviar nem cobrar nada. Experimente "O que está em produção hoje?" ou "Porque é que a peça X custa tanto?". Demasiadas chamadas recebem "Demasiados pedidos à demonstração da CUTL; tente novamente em breve".

Privacidade

• Tudo o que uma ferramenta devolve (nomes de projetos e peças, nomes e moradas de clientes, preços, comentários, relatórios) é lido pelo assistente, que corre no seu fornecedor (Anthropic, OpenAI, Google, etc.) segundo os termos desse fornecedor. Ligue apenas assistentes em que confie para esses dados, e apenas os conjuntos de ferramentas de que precisa.
• Os ficheiros que larga na página de carregamento seguem diretamente para o armazenamento da CUTL, sem passar pelo assistente.
• A CUTL não vê a sua conversa, apenas as chamadas de ferramentas e os respetivos dados de entrada. Cada chamada de ferramenta fica registada na CUTL.
• O texto escrito por pessoas (nomes, comentários, textos dos desenhos) é entregue ao assistente como dados dos quais não pode receber instruções, e as regras de confirmação acima são aplicadas pela CUTL, decida o assistente o que decidir.
• Os relatórios de erros enviados através do assistente incluem os seus IDs de utilizador e de equipa, não o seu endereço de e-mail.