> ## Documentation Index > Fetch the complete documentation index at: https://docs.alterhq.com/llms.txt > Use this file to discover all available pages before exploring further. # Ligar um agente de IA com Remote MCP > Use o Alter como servidor MCP remoto para reuniões, actions guardadas e conversas no seu Mac O MCP Gateway permite a um agente de IA compatível chamar as ferramentas do Alter através de um URL HTTPS privado. Use-o para pesquisar reuniões, ler transcrições, executar actions guardadas permitidas e iniciar ou continuar conversas do Alter. O Alter executa as ferramentas no seu Mac. Um relay do Alter liga o agente de IA à app em execução. Não precisa de expor uma porta no Mac nem de executar um comando MCP local separado. > [!TIP] > > Usa o ChatGPT para desktop? Siga [Usar o Alter no ChatGPT](/pt/apps-tools/gateways-chatgpt.md) para a instalação do plugin. Este guia explica a ligação Remote MCP usada por agentes compatíveis. ## Antes de começar * Inicie sessão no Alter no Mac. * Use um agente de IA que suporte a adição de um **URL de servidor MCP HTTPS remoto**. Um cliente que aceite apenas um comando local não pode usar este URL diretamente. * Mantenha o Mac ligado à Internet e o Alter em execução enquanto utiliza a ligação. > [!NOTE] > > O ChatGPT é a primeira integração testada. A compatibilidade de outros clientes com o endpoint Remote MCP do Alter ainda não foi verificada de ponta a ponta. O suporte a ferramentas e a subscrições de eventos pode variar dentro do mesmo cliente. ## Ativar o MCP Gateway **1. Abrir Gateways no Alter** Prima **⌘,** para abrir **Settings** e selecione **Gateways** em **Integrations**. Escolha **Add gateway → MCP Gateway** ou abra um MCP Gateway existente. **2. Escolher o acesso e guardar** Ative **Enabled**. Em **Allowed access**, ative as capacidades que pretende que o agente use. Para um teste de reuniões só de leitura, ative **Read meeting transcripts**. Escolha **Save and restart** e aguarde até a ligação estar pronta. ![Definições do MCP Gateway do Alter com Enabled ativado e controlos da ligação](https://mintcdn.com/alter-95c0cbf0/Hy1s62bRsMvpVH6C/images/gateways/chatgpt/alter-mcp-connection.png?fit=max\&auto=format\&n=Hy1s62bRsMvpVH6C\&q=85\&s=4b8b77cf9de2094d96a8b0b3cdfad0f9) Ative o MCP Gateway e guarde a ligação antes de a adicionar ao agente de IA. **3. Copiar o URL de ligação** Escolha **Copy connection URL** na secção **Connection**. Este é o seu endpoint Remote MCP privado. Mantenha privado o URL completo, incluindo a chave no final. ## Adicionar o Alter ao agente de IA Abra as definições MCP ou de integrações do agente e adicione um servidor remoto com estes valores: | Campo | Valor | | - | - | | Nome | **Alter** | | URL do servidor | Cole o URL completo de **Copy connection URL**. | | Autenticação | **No authentication** ou a opção equivalente no cliente. O acesso já está incluído no URL privado. | Guarde a ligação e atualize ou descubra as ferramentas. Os rótulos exatos dependem do cliente. Não precisa de uma chave API adicional nem de iniciar sessão por OAuth para esta ligação. Comece com um pedido só de leitura: > Lista as minhas reuniões recentes no Alter. O agente pode pedir que aprove uma chamada de ferramenta. Se não aparecerem reuniões, confirme que tem reuniões guardadas no Alter e que o acesso às transcrições está ativado. ## Escolher o acesso permitido ![Secção Allowed access do MCP Gateway do Alter com controlos para reuniões, actions, chat e histórico](https://mintcdn.com/alter-95c0cbf0/Hy1s62bRsMvpVH6C/images/gateways/chatgpt/alter-mcp-access.png?fit=max\&auto=format\&n=Hy1s62bRsMvpVH6C\&q=85\&s=ed9df89e68ddf7d65d5debac27cbffec) Ative apenas as capacidades que pretende que o agente ligado possa usar. | Definição | Ferramentas e comportamento disponíveis | | - | - | | **Read meeting transcripts** | `list_meetings`, `search_meetings` e `get_meeting_transcript` listam e pesquisam reuniões guardadas e, em seguida, leem uma transcrição selecionada. | | **Run saved actions** | `list_actions` e `run_action` descobrem e executam actions guardadas permitidas para este gateway. | | **Chat with Alter** | `create_conversation` e `send_message` iniciam e continuam conversas usando actions permitidas. | | **Read conversation history** | `list_conversations`, `search_conversations` e `get_conversation` encontram e leem conversas cujas actions são permitidas para este gateway. | | **Notify when transcripts are ready** | Permite eventos de transcrição pronta para clientes suportados com uma subscrição de eventos ativa. Consulte [Suporte a eventos](#suporte-a-eventos) para as restrições atuais. | As capacidades desativadas são removidas das ferramentas disponíveis e não podem ser usadas através de chamadas diretas. Depois de mudar o acesso, escolha **Save and restart** e atualize as ferramentas do agente. Reiniciar o gateway cancela tarefas ativas do gateway. ### Action predefinida e actions guardadas Em **Behavior**, escolha a **Default action** para novos chats. **Ask Anything** costuma ser a predefinição. Para outra action guardada, abra **Action Editor → Gateways** e ative **MCP Gateway** ou **All**. A lista **Available actions** do gateway mostra as actions permitidas. O agente também precisa de acesso **Run saved actions** para as descobrir e executar. As novas conversas **Ask Anything** usam o workspace predefinido do Alter. As outras actions usam o workspace configurado para elas. Ao continuar uma conversa, são mantidos o workspace e as permissões de action dessa conversa. ## Experimente estes pedidos | Objetivo | Exemplo de pedido | | - | - | | Encontrar uma reunião por tema | «Pesquisa nas minhas reuniões do Alter por preços e resume as discussões correspondentes.» | | Ver reuniões recentes | «Lista as minhas reuniões recentes no Alter e lê a transcrição mais recente.» | | Descobrir actions guardadas | «Que Alter Actions podes executar através desta ligação?» | | Iniciar um chat do Alter | «Pede ao Alter para inspecionar os ficheiros mais recentes no workspace atual sem os alterar.» | | Pesquisar conversas anteriores | «Encontra as minhas conversas anteriores do Alter sobre integração de novos utilizadores.» | A pesquisa de reuniões compara termos com o conteúdo indexado das reuniões. A pesquisa de conversas compara títulos e mensagens indexados. Peça ao agente para ler uma transcrição ou conversa correspondente quando precisar de mais detalhes. ### Perguntas e permissões Os chats e as actions podem devolver um ID de tarefa enquanto o Alter trabalha. O agente usa `get_task` para obter o resultado e pode usar `cancel_task` para parar uma tarefa em curso. Uma tarefa do Alter pode parar para fazer uma pergunta ou pedir acesso a ficheiros. O agente deve mostrar a pergunta e as opções, aguardar a resposta e enviá-la ao Alter antes de continuar. As opções de permissão podem incluir **Allow once**, **Always allow** ou recusar o acesso. A ligação não aprova estes pedidos automaticamente. Se o agente continuar à espera sem mostrar uma pergunta, peça-lhe que verifique a pergunta pendente da tarefa e use a ferramenta `answer_questions` depois de responder. ## Suporte a eventos O acesso remoto a ferramentas não cria automaticamente uma subscrição de eventos. O suporte a eventos também depende do agente de IA e do modo selecionado. Atualmente, o Alter só aceita destinos webhook de transcrição pronta em domínios ChatGPT/OpenAI. Outros agentes MCP podem usar ferramentas compatíveis, mas não são suportados destinos de eventos arbitrários de terceiros. Siga [Notificações de reuniões no ChatGPT](/pt/apps-tools/gateways-chatgpt.md) para configurar a subscrição suportada. ## Privacidade e disponibilidade O URL de ligação concede o acesso ativado para este gateway. Trate-o como uma palavra-passe e guarde-o apenas em clientes de confiança. As ferramentas são executadas no Alter no Mac. Os pedidos e resultados passam pelo relay do Alter, incluindo o texto da transcrição quando o agente o pede. As reuniões e conversas guardadas permanecem no Alter; o agente ligado recebe os dados devolvidos pelas chamadas de ferramenta permitidas. Mantenha o Alter em execução e o Mac ligado à Internet. Desativar o gateway interrompe o acesso e cancela as tarefas ativas. Apagar e recriar o gateway gera um URL de ligação novo; substitua o URL antigo em cada cliente ligado. ## Resolução de problemas | Sintoma | O que verificar | | - | - | | O cliente só oferece um campo de comando ou executável | Escolha um cliente ou tipo de ligação que suporte URLs MCP HTTPS remotos. | | O servidor não consegue ligar-se | Confirme que o Alter está em execução e que o MCP Gateway está ativado e ligado. Experimente **Reconnect** na secção **Connection** do Alter e atualize o cliente. Reconectar cancela tarefas ativas do gateway. | | Faltam ferramentas | Ative o controlo **Allowed access** correspondente, guarde e atualize a lista de ferramentas do agente. Para actions, verifique também **Action Editor → Gateways**. | | Uma tarefa está à espera | Verifique se o Alter precisa de uma resposta explícita ou de uma decisão sobre acesso a ficheiros. | | As ferramentas funcionam, mas os eventos não | Verifique o cliente e o modo. Os destinos de eventos estão limitados a domínios ChatGPT/OpenAI e exigem uma subscrição ativa. | | O acesso parou depois de mudar de conta Alter ou recriar o gateway | Copie o URL de ligação atual e substitua-o no agente. | ## Páginas relacionadas * [Usar o Alter no ChatGPT](/pt/apps-tools/gateways-chatgpt.md) * [Visão geral dos Gateways](/pt/apps-tools/gateways.md) * [Alter Actions](/pt/workflows/alter-actions.md) * [Dados locais e privacidade](/pt/references/local-data-and-privacy.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.