# Como configurar a conexão MCP?

> Documentação do mobile-calendar (https://www.mobile-calendar.com), um sistema de gestão de alojamentos: calendário de reservas, preços, channel manager (Booking.com, Airbnb), sistema de reservas online e faturas, no navegador e no aplicativo móvel. mobile-calendar é o nome próprio deste software, não um termo genérico para um calendário no telefone.

Integrações API > Servidor MCP > Como configurar a conexão MCP?
URL: https://docs.mobile-calendar.com/pt/guias/integracoes-api/mcp-server/como-configurar-a-conexao-mcp

## Introdução

Para conectar a sua conta mobile-calendar à aplicação Claude ou ao ChatGPT, basta copiar o endereço do servidor no painel, adicioná-lo na aplicação de IA e dar autorização na página mobile-calendar. Só precisa de configurar a conexão uma vez e pode revogar o acesso a qualquer momento. O artigo [O que é o servidor MCP?](https://docs.mobile-calendar.com/pt/guias/integracoes-api/mcp-server/o-que-e-o-servidor-mcp) explica o que é esta funcionalidade e o que a aplicação pode fazer.

> **Disponibilidade da funcionalidade**
>
> O servidor MCP está disponível no plano **Premium**. Também precisa de uma conta na aplicação Claude ou no ChatGPT.

## Instruções

### Copiar o endereço do servidor

- No menu à esquerda, clique na aba **Integrações** -> **API e MCP**.
- Vá para a aba **Servidor MCP**.
- Será apresentado um cartão «Servidor MCP» com o endereço do servidor, os passos para a conexão e as regras de segurança.

![Servidor MCP — endereço do servidor e passos para a conexão](https://docs.mobile-calendar.com/media/31/313dc9c3-0c1b-425d-a8f4-27518bf7d4f0-eee81982.png)

- Na secção «Como conectar?», clique no botão **Copiar endereço**.
- O endereço do campo **Endereço do servidor MCP** será copiado para a área de transferência.

### Adicionar o servidor na aplicação Claude

- Na aplicação Claude, abra as configurações e selecione **Conectores** (**Connectors**).
- Selecione a opção para adicionar um conector personalizado (**Add custom connector**).
- Introduza um nome para o conector, por exemplo, mobile-calendar, e cole o endereço do servidor que copiou.
- Confirme a adição do conector. Se aparecer o botão **Conectar** junto ao conector, clique nele.
- A página de autorização do mobile-calendar será aberta no navegador.

### Adicionar o servidor na aplicação ChatGPT

- No ChatGPT, abra a página **Plugins** (**Plugins**) no navegador.
- Clique no botão **+** e selecione **Adicionar servidor MCP personalizado**.
- Introduza um nome, por exemplo, mobile-calendar, e cole o endereço do servidor que copiou no campo **URL do servidor**.
- Se a aplicação perguntar o modo de autenticação (**Authentication**), selecione **OAuth**.
- Confirme o aviso de risco (**Compreendo e quero continuar**) e clique em **Criar como plugin**.
- Instale o plugin criado para o poder usar numa conversa.
- Durante a conexão, a página de autorização do mobile-calendar será aberta no navegador.

> **Nomes das opções nas aplicações de IA**
>
> O Claude e o ChatGPT são desenvolvidos por outras empresas, por isso, os nomes e a localização das opções podem mudar. Se não encontrar a opção descrita, consulte a ajuda da aplicação em questão.

### Dar autorização

- Inicie sessão no mobile-calendar como faz no painel. A autorização é concedida na página mobile-calendar, e a aplicação de IA não tem acesso à sua senha.
- Na página de autorização, verifique:
  - o nome e o endereço da aplicação que está a pedir acesso à conta,
  - a conta indicada por baixo de «Sessão iniciada como»,
  - a lista «A aplicação poderá:», que indica o âmbito de acesso correspondente às suas permissões.

![Página de autorização — a aplicação Claude pede acesso à conta](https://docs.mobile-calendar.com/media/68/684872cc-4596-47e3-aa1a-18e8a952bf58-ea6bcfe4.png)

- Clique no botão **Permitir** para conectar a aplicação. O botão **Recusar** interrompe a conexão.
- A aplicação aparecerá na lista «Aplicações conectadas».
- Será enviada uma mensagem com o assunto «Nova aplicação de IA conectada à conta» para o endereço de e-mail do proprietário da conta. Se um funcionário tiver conectado a aplicação, também receberá a mensagem.

> **Quando selecionar Recusar**
>
> Só selecione Permitir se estiver a adicionar o endereço do servidor mobile-calendar à aplicação de IA nesse momento. Se a página de autorização tiver sido aberta através de um link numa mensagem, selecione **Recusar**.

A etiqueta amarela «Aplicação não verificada» significa que não foi possível confirmar quem está por detrás da aplicação, mesmo que o nome ou o endereço lhe pareçam familiares. Só conecte essa aplicação se tiver a certeza da sua origem.

![Página de autorização — aplicação não verificada](https://docs.mobile-calendar.com/media/0a/0acdfd71-3ed6-45b2-886c-099e602d41ac-e332b3d5.png)

### Utilizar uma aplicação conectada

- Numa conversa com a aplicação de IA, escreva o que precisa, por exemplo: «Que reservas chegam amanhã?».
- A aplicação irá consultar os dados da sua conta mobile-calendar ou guardar nela a alteração que pediu.

### Desconectar uma aplicação

- Aceda à aba **Integrações** -> **API e MCP** e vá para a aba **Servidor MCP**.
- Na lista «Aplicações conectadas», encontre a aplicação à qual pretende revogar o acesso.

![Lista de aplicações conectadas](https://docs.mobile-calendar.com/media/bc/bc945e07-3949-4c56-8fbc-3c5df400b1f4-dd3bf890.png)

- Clique no botão **Desconectar** junto à aplicação selecionada.
  - Aparecerá uma janela «Desconectar aplicação?» no centro do ecrã.
  - Clique no botão **Desconectar**.

![Desconectar uma aplicação — janela de confirmação](https://docs.mobile-calendar.com/media/8a/8afe59fd-6e31-4c34-89bf-1adf80b8bd3f-22f4a729.png)

- A aplicação perderá imediatamente o acesso à conta. Pode voltar a conectá-la mais tarde.

> **Alterar a senha não desconecta as suas aplicações**
>
> Alterar a sua própria senha não revoga o acesso das aplicações conectadas com o seu login. Para revogar o acesso, clique em **Desconectar** na lista «Aplicações conectadas».

Quando a assinatura expirar, as aplicações conectadas perderão o acesso à conta até a assinatura ser renovada.

## Aplicações dos funcionários

Um funcionário conecta uma aplicação com o seu próprio login, da mesma forma que o proprietário da conta. A aplicação só pode consultar e alterar aquilo a que o funcionário tem acesso no painel, de acordo com as suas [permissões](https://docs.mobile-calendar.com/pt/guias/gestão/funcionários/permissões-de-funcionário) e os quartos que lhe foram atribuídos.

- **Lista de conexões:** o proprietário da conta também vê as aplicações dos funcionários na lista «Aplicações conectadas» e pode desconectá-las. A coluna **Quem conectou** indica a quem pertence a conexão. O funcionário só vê as aplicações conectadas com o seu login.
- **Alteração das permissões:** é aplicada imediatamente, também na aplicação conectada.
- **Perda de acesso:** as aplicações do funcionário serão desconectadas se o proprietário alterar a senha ou o endereço de e-mail do funcionário, terminar a sessão nos dispositivos dele ou remover o funcionário.

## Consultar operações nos registos

- Aceda à aba **Integrações** -> **API e MCP** e vá para a aba **Registos**.
- No campo **Conta**, selecione **Servidor MCP** na lista suspensa.

![Registos — filtro Conta](https://docs.mobile-calendar.com/media/ba/bad5d6e6-8e04-4900-93d9-98a468a3c9f9-7fc947ad.png)

- A lista mostrará apenas as operações realizadas pelas aplicações conectadas.

![Registos — operações da conta Servidor MCP](https://docs.mobile-calendar.com/media/04/04959bbe-e431-48f4-bb32-853216928097-ae17d3e0.png)

A opção **Servidor MCP** aparece na lista depois de conectar a primeira aplicação e inclui todas as aplicações conectadas. No campo **Conta**, também pode selecionar **Mobi** e as suas próprias contas de API. O artigo [Registos](https://docs.mobile-calendar.com/pt/guias/integracoes-api/rest-api/rest-api-logs) descreve os restantes filtros e os detalhes das entradas.

## Problemas mais comuns

### A aplicação de IA pede confirmação antes de fazer uma alteração

O Claude e o ChatGPT podem pedir a sua confirmação antes de guardar uma alteração. Esta é uma medida de segurança da aplicação de IA, não um erro de conexão. Verifique o que a aplicação pretende alterar e confirme ou rejeite a operação.

### A aplicação recusou-se a executar a operação

Uma aplicação de IA externa não executará algumas operações. Por exemplo, não reduzirá um preço para metade ou menos, não fornecerá um código de porta nem enviará uma mensagem a um destinatário que não seja o hóspede da reserva. Execute essa operação no painel ou com o Mobi.

### Não existe uma opção para adicionar um servidor na aplicação de IA

A possibilidade de adicionar um servidor MCP personalizado depende do plano da aplicação Claude ou do ChatGPT e, nos planos empresariais, também das permissões concedidas pelo administrador. Consulte a ajuda da aplicação em questão ou pergunte ao administrador da sua organização.

### A página de autorização está noutro idioma

No canto superior direito da página de autorização, clique na bandeira do idioma e selecione o seu idioma.

### A aplicação não aparece na lista «Aplicações conectadas»

Na lista «Aplicações conectadas», clique em **Atualizar**. Se a aplicação continuar sem aparecer, conecte-a novamente na aplicação de IA.
