Saltar para o conteúdo principal
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.
Usa o ChatGPT para desktop? Siga Usar o Alter no ChatGPT 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.
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

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: 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

Ative apenas as capacidades que pretende que o agente ligado possa usar.

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

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

Páginas relacionadas