Skip to main content
Cada projeto que crias no Macaly pode ter o seu próprio servidor MCP. Isso permite que outros assistentes de IA usem a tua app. Quem estiver a trabalhar com o Claude ou o ChatGPT pode dizer «adiciona uma marcação para sexta às 10» ou «quantas encomendas entraram esta semana», e o assistente executa a ação através da tua app. És tu que decides que partes da app ficam expostas. A configuração é feita no separador MCP do teu chat, onde estão também os dados de ligação.
Disponível em todos os planos

​
Criar o servidor

Abre o separador MCP e clica em Criar MCP para esta app. O agente vê o que a tua app faz e propõe um conjunto de ferramentas, por exemplo uma para listar itens, outra para os criar e outra para os editar. Se quiseres outras, diz ao agente no chat. Depois ele integra essas ferramentas no backend da tua app. Também podes pedir diretamente no chat: «Transforma a minha app num servidor MCP para o Claude poder gerir o inventário.» Mais tarde, Adicionar ou alterar ferramentas no separador MCP leva-te de volta ao agente para ajustares o que está exposto. Assim que o servidor existe, o separador mostra o seu URL do servidor e a forma de autenticação:
  • Requer início de sessão: os assistentes entram pelo início de sessão da própria app, por isso cada pessoa só chega aos seus dados. É o método exigido pelo Claude e pelo ChatGPT.
  • Token de acesso: uma única chave secreta. Útil para scripts e para o Claude Code, mas as apps do Claude e do ChatGPT não a conseguem usar. Se o teu servidor só aceitar um token, clica em Adicionar início de sessão e o agente acrescenta um login à tua app.
Os assistentes iniciam sessão através da tua app publicada, por isso tens de publicar o projeto primeiro. Se o chat usar a base de dados Testing, o Claude e o ChatGPT iniciam sessão na mesma na base de dados Live. Quando a versão de teste estiver pronta, muda para Live no separador Base de dados. Vê Bases de dados Live e Testing.

​
Ligar um assistente

A secção Ligar tem instruções passo a passo para cada cliente. Só precisas de ligar uma vez.
  1. No Claude, abre Settings → Connectors e clica em Add custom connector.
  2. Dá-lhe um nome e cola o URL do teu servidor no campo Remote MCP server URL.
  3. Clica em Connect. O Claude abre a página de início de sessão da tua app. Inicia sessão e autoriza o acesso.
Os conectores personalizados requerem um plano pago do Claude ou do ChatGPT e são adicionados na app web ou de desktop, não na app do telemóvel.

​
O que podem fazer os assistentes ligados

A lista Ferramentas, no fundo do separador, mostra todas as ferramentas que o teu servidor oferece, cada uma com uma descrição curta. As ferramentas marcadas como Só leitura apenas conseguem consultar dados. As marcadas como Pode apagar dados conseguem removê-los, por isso tem cuidado ao definires as respetivas permissões. Se o separador indicar que o servidor não responde, pode ainda estar a ser implementado. Tenta de novo daqui a pouco ou clica em Pedir ao Macaly para corrigir e o agente vai ver o que se passa.

​
Exemplos de utilização

  • Uma app de marcações em que os clientes pedem ao assistente para encontrar um horário livre e reservá-lo.
  • Um CRM interno em que a equipa comercial pergunta ao ChatGPT o histórico de um cliente antes de uma chamada.
  • Uma app de inventário em que o Claude verifica o stock e regista entregas.
O servidor corre no domínio de API da tua app, por isso o endereço mantém-se igual mesmo que renomeies ou mudes o site.