> ## 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 o seu app

> Deixe o Claude, o ChatGPT e outros assistentes de IA usarem os dados do seu app

Todo projeto que você cria no Macaly pode ter o seu próprio servidor [MCP](https://modelcontextprotocol.io). Isso permite que outros assistentes de IA usem o seu app. Quem trabalha com o Claude ou o ChatGPT pode então dizer "adicione uma reserva para sexta às 10h" ou "quantos pedidos chegaram esta semana", e o assistente executa a ação por meio do seu app.

Quais partes do app você expõe é decisão sua. Configure isso na aba **MCP** do seu [chat](/docs/pt-BR/chat/overview), que também reúne os dados de conexão.

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

## Criando o servidor

Abra a aba **MCP** e clique em **Criar MCP para este app**. O agente analisa o que o seu app faz e propõe um conjunto de ferramentas, por exemplo uma para listar itens, outra para criá-los e outra para editá-los. Se você quiser ferramentas diferentes, diga ao agente no chat. Ele então constrói essas ferramentas no backend do seu app.

Você também pode simplesmente pedir no chat: "Transforme o meu app em um servidor MCP para que o Claude possa gerenciar o estoque." Mais tarde, **Adicionar ou alterar ferramentas**, na aba MCP, leva você de volta ao agente para ajustar o que está exposto.

Depois que o servidor existe, a aba mostra a **URL do servidor** e como ele autentica:

* **Requer login**: os assistentes entram pelo login do seu próprio app, então cada pessoa acessa apenas os próprios dados. Esse é o método que o Claude e o ChatGPT exigem.
* **Token de acesso**: uma única chave secreta. Útil para scripts e para o Claude Code, mas os apps do Claude e do ChatGPT não conseguem usá-lo. Se o seu servidor aceitar apenas um token, clique em **Adicionar login** e o agente adiciona um login ao seu app.

<Note>
  Os assistentes entram pelo seu app publicado, então você precisa publicar o projeto primeiro. Se o chat usa o banco de dados de teste, o Claude e o ChatGPT ainda assim entram no banco de dados de produção. Quando a versão de teste estiver pronta, mude para Produção na aba Banco de dados. Veja [Bancos de dados de produção e de teste](/docs/pt-BR/features/databases#bancos-de-dados-de-produção-e-de-teste).
</Note>

## Conectando um assistente

A seção **Conectar** traz instruções passo a passo para cada cliente. Você só precisa conectar uma vez.

<Tabs>
  <Tab title="Claude">
    1. No Claude, abra **Settings → Connectors** e clique em **Add custom connector**.
    2. Dê um nome ao conector e cole a URL do seu servidor no campo **Remote MCP server URL**.
    3. Clique em **Connect**. O Claude abre a página de login do seu app. Entre e aprove o acesso.
  </Tab>

  <Tab title="ChatGPT">
    1. No ChatGPT, abra **Settings → Apps & Connectors → Advanced settings** e ative o **Developer mode**.
    2. De volta em **Apps & Connectors**, clique em **Create**, dê um nome ao conector e cole a URL do seu servidor. Mantenha **OAuth** como autenticação.
    3. Entre com a conta do seu app e aprove o acesso. Em um chat, escolha o seu app no menu **+**.
  </Tab>

  <Tab title="Claude Code">
    Copie o comando exibido na aba MCP e execute-o no seu terminal. Ele contém o seu token de acesso, então não o compartilhe com ninguém. Depois, digite `/mcp` no Claude Code e conclua o login no navegador.
  </Tab>
</Tabs>

Os conectores personalizados exigem um plano pago do Claude ou do ChatGPT e são adicionados pelo app web ou de desktop, não pelo app do celular.

## O que os assistentes conectados podem fazer

A lista de **Ferramentas**, no fim da aba, mostra todas as ferramentas que o seu servidor oferece, com uma breve descrição de cada uma. As ferramentas com o selo **Somente leitura** só podem ver dados. As ferramentas com o selo **Pode excluir dados** podem removê-los, então tenha cuidado ao definir as permissões delas.

Se a aba informar que o servidor não está respondendo, ele ainda pode estar sendo implantado. Tente de novo daqui a pouco ou clique em **Pedir ao Macaly para corrigir**, e o agente investiga.

## Exemplos de uso

* Um app de reservas em que os clientes pedem ao assistente que encontre um horário livre e faça a reserva.
* Um CRM interno em que a equipe de vendas pede ao ChatGPT o histórico de um cliente antes de uma ligação.
* Um app de estoque em que o Claude confere os níveis de estoque e registra as entregas.

O servidor roda no [domínio de API](/docs/pt-BR/features/domains#domínio-de-api-para-o-backend-do-seu-app) do seu app, então o endereço dele continua o mesmo mesmo que você renomeie ou mova o site.


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