IA e MCP

O que é o MCP e porque é que o seu assistente de IA consegue registar horas?

Atualizado 4 min de leitura

Resposta breve

O MCP (Model Context Protocol) é um standard aberto que permite a um assistente de IA como o Claude, ChatGPT ou Cursor interagir com outro software: consultar dados e executar ações. Um programa disponibiliza um servidor MCP com algumas ferramentas bem definidas; o assistente é o cliente que utiliza essas ferramentas, depois de iniciar sessão e dar o seu consentimento.

O problema que o MCP resolve

Um modelo de linguagem escreve e raciocina bem, mas não conhece os seus dados. Não consegue procurar um cliente, marcar uma reunião ou registar horas. Para isso, precisa de comunicar com outro software.

Antes do MCP, cada aplicação de IA tinha de criar a sua própria integração para cada programa. O MCP transforma isso num único acordo: um programa cria um servidor MCP uma vez, e qualquer assistente que fale MCP pode utilizá-lo.

Pense numa tomada elétrica: o aparelho e a rede não precisam de se conhecer, desde que usem a mesma ficha.

Como funciona o MCP

Existem dois lados. O servidor está no programa que detém os dados, por exemplo um registo de horas. O cliente está no assistente de IA: Claude Desktop, Claude Code, ChatGPT, Cursor, Codex ou VS Code.

O servidor descreve as ferramentas que disponibiliza, cada uma com um nome, uma explicação simples e os campos que espera receber. O assistente lê essas descrições e escolhe a ferramenta adequada ao seu pedido.

  1. Adiciona um servidor MCP no seu assistente com um endereço, por exemplo https://app.half5.com/mcp.
  2. O assistente abre o ecrã de início de sessão desse programa. Inicia sessão e dá o seu consentimento (OAuth). A sua palavra-passe nunca chega ao assistente.
  3. Faz um pedido em linguagem simples, como ‘registar duas horas para a correção do login’.
  4. O assistente utiliza a ferramenta correspondente e mostra-lhe o resultado.

Ferramentas, não acesso total

Um servidor MCP não dá ao assistente acesso livre à base de dados. Só disponibiliza as ferramentas que o fabricante definiu, com os direitos da conta com que iniciou sessão. Se a sua conta não pode ver as horas dos colegas, o assistente também não pode.

Pode remover o acesso como faria com qualquer aplicação ligada: no próprio programa ou eliminando o servidor do seu assistente.

  • Local ou remoto. Um servidor MCP pode funcionar no seu próprio computador ou na cloud. Um servidor cloud não requer instalação: basta colar o endereço e iniciar sessão.
  • Standard aberto. A Anthropic publicou o MCP como especificação aberta em novembro de 2024; OpenAI, Cursor e Microsoft também o suportam.
  • Consentimento por ligação. Num servidor remoto, inicia sessão via OAuth, tal como em ‘Iniciar sessão com Google’.

Onde é útil

O MCP é mais útil para tarefas que já faz num assistente. Um programador que corrige um erro com o Claude Code pode pedir ao mesmo assistente para registar o tempo no final. Um consultor a escrever um relatório no ChatGPT pode perguntar o que já foi registado esta semana.

É menos indicado para tarefas em que pretende validar cada campo antes de gravar. Por isso, escolha software que mantenha tudo o que um agente faz como pendente ou sujeito a aprovação. Como funciona para registo de horas está em Registar horas com Claude, ChatGPT ou Cursor.

Como a Half5 faz

A Half5 disponibiliza o seu próprio servidor MCP em https://app.half5.com/mcp. Adicione esse endereço no seu assistente, inicie sessão com a sua conta Half5 e dê o seu consentimento. Não é necessário instalar nada.

O servidor oferece seis ferramentas: log_work, log_work_batch (vários registos de uma vez), search_customers_projects, list_entries, update_entry e delete_entry (apenas para os seus próprios registos ainda não aprovados). Um agente ligado só vê as suas próprias horas, mesmo que a sua conta seja de gestor ou administrador; faturas, colegas e definições ficam inacessíveis. Os registos criados por um agente ficam como ‘Por aprovar’ e, de resto, são registos normais: aparecem no seu resumo e seguem o fluxo de aprovação e faturação como os restantes. Como o log_work escolhe o cliente certo está em Como funciona o log_work.

Perguntas frequentes

O MCP é o mesmo que uma API?

Quase. Um servidor MCP normalmente usa uma API tradicional por trás, mas descreve as suas ferramentas para que um modelo de linguagem as possa escolher e utilizar autonomamente. Não precisa de programar para que um assistente o utilize.

Que assistentes de IA suportam MCP?

Entre outros, Claude (Claude.ai, Claude Desktop e Claude Code), ChatGPT através de conectores, Cursor, OpenAI Codex e VS Code. O local onde adiciona o servidor depende de cada aplicação.

Um assistente pode alterar dados sozinho através do MCP?

Apenas através das ferramentas disponibilizadas pelo servidor e apenas com os direitos da sua conta. Um bom software mantém as alterações do agente pendentes para revisão, para que possa aprová-las ou o seu gestor.

Preciso de instalar alguma coisa?

Não, se usar um servidor MCP remoto: basta adicionar o endereço e iniciar sessão. Só os servidores MCP locais, que funcionam no seu computador, requerem instalação.

Fontes

Alguém vai de bicicleta para casa ao longo do canal depois do trabalho

Hoje, às 16:30, feche o portátil a tempo.

Experimente o Half5 gratuitamente durante 14 dias, sozinho ou com toda a equipa. Não é necessário cartão de crédito.