> ## Documentation Index
> Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Um servidor MCP para a tua app

> Deixa o Claude, o ChatGPT e outros assistentes de IA usarem os dados da tua app

Cada projeto que crias no Macaly pode ter o seu próprio servidor [MCP](https://modelcontextprotocol.io). 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](/docs/pt/chat/overview), onde estão também os dados de ligação.

<Callout icon="user">
  Disponível em todos os planos
</Callout>

## 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.

<Note>
  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](/docs/pt/features/databases#bases-de-dados-live-e-testing).
</Note>

## Ligar um assistente

A secção **Ligar** tem instruções passo a passo para cada cliente. Só precisas de ligar uma vez.

<Tabs>
  <Tab title="Claude">
    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.
  </Tab>

  <Tab title="ChatGPT">
    1. No ChatGPT, abre **Settings → Apps & Connectors → Advanced settings** e ativa o **Developer mode**.
    2. De volta a **Apps & Connectors**, clica em **Create**, dá-lhe um nome e cola o URL do teu servidor. Mantém **OAuth** como autenticação.
    3. Inicia sessão com a conta da tua app e autoriza o acesso. Num chat, escolhe a tua app no menu **+**.
  </Tab>

  <Tab title="Claude Code">
    Copia o comando mostrado no separador MCP e executa-o no terminal. Contém o teu token de acesso, por isso não o partilhes com ninguém. Depois escreve `/mcp` no Claude Code e termina o início de sessão no navegador.
  </Tab>
</Tabs>

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](/docs/pt/features/domains#domínio-de-api-para-o-backend-da-tua-app) da tua app, por isso o endereço mantém-se igual mesmo que renomeies ou mudes o site.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.