Spanish English German Portuguese
Spanish English German Portuguese

Guia de instalação e configuração do MCP GlobalSuite

Este guia explica como conectar o seu assistente de IA ao GlobalSuite® através do MCP GlobalSuite, quer utilize uma conta própria ou uma conta gerida pela sua organização, e como iniciar sessão com o seu utilizador do GlobalSuite®.

Antes de começar

Para conectar o MCP GlobalSuite necessita de:

  • Um ambiente de GlobalSuite® Cloud e um utilizador ativo com acesso à informação que pretende consultar.

  • Um assistente de IA compatível, com um plano que permita adicionar conectores ou servidores MCP personalizados.

  • O endereço do MCP do seu ambiente.

Endereço do MCP do seu ambiente

Cada ambiente do GlobalSuite® tem o seu próprio endereço de MCP, formado pelo domínio com o qual acede ao GlobalSuite® no navegador seguido de /mcp/mcp :

Por exemplo, no ambiente de demonstração do GlobalSuite® o endereço é https://demo.globalsuite.es/mcp/mcp . Se tiver dúvidas sobre o endereço do seu ambiente, consulte o Suporte do GlobalSuite®.

Dados de conexão OAuth

A maioria dos assistentes descobre estes dados automaticamente. Alguns, como o Copilot Studio ou o Gemini Enterprise, solicitam-nos ao configurar o conector:

Dado

Valor

URL de autorização

https:///api/oauth/authorize

URL de token e de renovação

https:///api/oauth/token

URL de revogação

https:///api/oauth/revoke

Âmbitos (scopes)

mcp:read e offline_access

São os mesmos para consultar e para fazer alterações: o que pode modificar depende das permissões do seu utilizador no GlobalSuite®.

Método de verificação

PKCE com S256 (obrigatório).

Identificador de cliente

ChatGPT: chatgpt · Cursor: cursor · Microsoft Copilot: microsoft-copilot · Gemini Enterprise: gemini-enterprise · Claude: não é necessário indicá-lo.

Microsoft Copilot e Gemini Enterprise utilizam também um segredo de cliente: solicite-o ao Suporte do GlobalSuite®.

Início de sessão com o seu utilizador do GlobalSuite®

A conexão é autorizada com o protocolo padrão OAuth. Na primeira vez que conecta o MCP, o seu assistente abre o ecrã de início de sessão do GlobalSuite® —o mesmo que utiliza na web— e entra com o seu método habitual:

Tipo de utilizador

Como inicia sessão

Utilizador e palavra-passe

Com o seu utilizador e palavra-passe do GlobalSuite®.

Active Directory ou LDAP

Com o seu utilizador e palavra-passe do diretório corporativo, tal como na web.

Single Sign-On (SAML)

Através do fornecedor de identidade da sua organização.

Duplo fator (2FA)

Se o tiver ativado, será solicitado tal como na web: código da sua aplicação de autenticação ou código por e-mail.

Ao terminar, volta automaticamente ao seu assistente, sem ecrãs adicionais. A partir desse momento, o assistente consulta o GlobalSuite® com o seu utilizador, na sua empresa e no seu sistema de gestão, e com as suas mesmas permissões.

  • O acesso dura 60 minutos e é renovado apenas enquanto utiliza o assistente.

  • Se o conector passar mais de 7 dias sem ser utilizado, será solicitado que inicie sessão novamente.

  • Não precisa de ter o GlobalSuite® aberto no navegador para utilizar o MCP.

O MCP conecta-se com a empresa e o sistema de gestão aos quais pertence o seu utilizador. Em breve poderá mudar de empresa ou de sistema de gestão a partir do assistente.

Configuração por assistente

Escolha o seu assistente. Nas contas corporativas, normalmente um administrador deve habilitar ou adicionar primeiro o conector para toda a organização.

Claude (web, desktop e móvel)

Conta própria (Pro ou Max)

  1. Abra o Claude e vá a Personalização → Conectores (Customize → Connectors).

  2. Clique em Adicionar e selecione Adicionar conector personalizado (Add custom connector).

  3. Escreva um nome (por exemplo, «GlobalSuite») e cole o endereço do MCP do seu ambiente. Não é necessário preencher a configuração avançada.

  4. Clique em Adicionar e depois em Conectar. Será aberto o ecrã do GlobalSuite®: inicie sessão.

  5. Em cada conversa, ative o conector a partir do botão + → Conectores.

Personalização, Conectores, no Claude com o conector do GlobalSuite adicionado.

Personalização → Conectores no Claude, com o conector do GlobalSuite® adicionado.

Tela de início de sessão do GlobalSuite que se abre ao conectar o assistente.

Ecrã de início de sessão do GlobalSuite® que se abre ao clicar em Conectar.

Ativação do conector do GlobalSuite numa conversa do Claude.

Ativação do conector numa conversa do Claude: + → Conectores.

Conta de organização (Team ou Enterprise)

  1. Um proprietário da organização adiciona o conector personalizado com o endereço do MCP a partir da configuração de conectores da organização.

  2. Cada utilizador vai a Personalização → Conectores, procura GlobalSuite e clica em Conectar para iniciar sessão com o seu próprio utilizador do GlobalSuite®.

Na ficha do conector ( Personalização → Conectores → GlobalSuite) escolhe, ferramenta a ferramenta, se o Claude pode utilizá-la sempre, se lhe pede aprovação antes de cada utilização ou se está bloqueada.

Ficha do conector do GlobalSuite no Claude com o endereço do MCP e as permissões por ferramenta.

Ficha do conector no Claude: endereço do MCP e permissões por ferramenta.

Mais informações na ajuda do Claude (conectores personalizados através de MCP remoto).

ChatGPT

O ChatGPT necessita do modo desenvolvedor para adicionar servidores MCP personalizados e de um plano pago (Plus, Pro, Business, Enterprise ou Edu).

Conta própria (Plus ou Pro)

O conector é adicionado a partir do modo desenvolvedor do ChatGPT, com o endereço do MCP do seu ambiente e os dados de conexão deste guia. Os passos estão na ajuda da OpenAI .

Conta de organização (Business, Enterprise ou Edu)

Não poderá adicionar o conector por conta própria: o administrador do espaço de trabalho deve habilitar o modo desenvolvedor e publicar o conector do GlobalSuite para os membros. Depois, cada utilizador conecta-o com o seu próprio utilizador do GlobalSuite®. Mais informações na ajuda da OpenAI .

Uma vez conectado, o complemento aparece em Definições → Complementos com a conta do GlobalSuite® com a qual iniciou sessão. Em cada conversa, escolha-o escrevendo @GlobalSuite ou a partir do botão +.

Configurações, Complementos, no ChatGPT com o complemento do GlobalSuite.

Definições → Complementos no ChatGPT, com o complemento do GlobalSuite®.

Ficha do complemento do GlobalSuite no ChatGPT com a conta conectada.

Ficha do complemento no ChatGPT, com a conta do GlobalSuite® conectada.

Seleção do complemento do GlobalSuite numa conversa do ChatGPT.

Seleção do complemento numa conversa do ChatGPT com @GlobalSuite.

Cursor

  1. Abra o ficheiro de configuração mcp.json : global em ~/.cursor/mcp.json (no Windows, %USERPROFILE%\.cursor\mcp.json ) ou por projeto em .cursor/mcp.json . Também pode fazê-lo a partir de Cursor Settings → MCP → New MCP Server.

  2. Adiciona este bloco, substituindo o endereço pelo do teu ambiente, e guarda:

  1. Reinicia o Cursor. Na primeira vez, o navegador será aberto para que inicies sessão no GlobalSuite®. Quando o servidor aparecer com um ponto verde, já estará conectado.

Gemini Enterprise

O administrador da equipa adiciona o MCP GlobalSuite como aplicação conectada:

  1. No Gemini Enterprise, seleciona a tua equipa e vai a Manage team → Connected apps → Add MCP Server.

  2. Indica o endereço do MCP do teu ambiente e escolhe OAuth 2.0 como autenticação. Completa o URL de autorização, o URL de token e os âmbitos da tabela de dados de conexão, o identificador de cliente gemini-enterprise e o segredo de cliente fornecido pelo Suporte do GlobalSuite®.

  3. Cada utilizador inicia sessão com o seu utilizador do GlobalSuite® na primeira vez que usa o conector.

Microsoft Copilot Studio

  1. Abre o teu agente no Copilot Studio e vai a Ferramentas → Adicionar uma ferramenta → Nova ferramenta → Model Context Protocol.

  2. Escreve um nome e uma descrição, e cola o endereço do MCP do teu ambiente.

  3. Na autenticação, escolhe OAuth 2.0 → Manual e completa o identificador de cliente microsoft-copilot , o segredo de cliente fornecido pelo Suporte do GlobalSuite®, o URL de autorização, o URL de token, o URL de atualização (o mesmo que o de token) e os âmbitos. O URL de retorno gerado pelo Copilot Studio já está autorizado no GlobalSuite®.

  4. Guarda a ferramenta e publica o agente. Na primeira vez que for usado, será solicitado iniciar sessão no GlobalSuite®.

Microsoft 365 Copilot

Para usar o GlobalSuite® a partir do Microsoft 365 Copilot, cria o agente no Copilot Studio como indicado acima e publica-o no canal de Microsoft Teams e Microsoft 365 Copilot. Os utilizadores encontrarão o agente no Copilot e, na primeira vez, iniciarão sessão com o seu utilizador do GlobalSuite®.

Verifica se funciona

Com o conector ativo, escreve no teu assistente:

Se tudo estiver bem, o assistente mostrará a lista das tuas análises de riscos. Encontrarás muitos mais exemplos em Casos de uso e exemplos de prompts .

Desconectar o MCP

Assistente

Como desconectá-lo

Claude

Personalização → Conectores → GlobalSuite → Desconectar. Para deixar de usá-lo apenas numa conversa, desativa-o no botão + → Conectores.

ChatGPT

Configurações → Complementos → GlobalSuite → Desinstalar.

Cursor

Remove o bloco «globalsuite» do ficheiro de configuração e reinicia a aplicação.

Copilot Studio e Gemini Enterprise

O administrador remove a ferramenta do agente ou a aplicação conectada.

Nas contas corporativas, os administradores do Claude e do ChatGPT podem também limitar quais conectores estão permitidos na organização.

A partir do GlobalSuite®, para cortar o acesso de um utilizador basta desativá-lo ou removê-lo: o assistente deixa de poder consultar a plataforma o mais tardar na próxima renovação do acesso (60 minutos).

Resolução de problemas

Problema

O que fazer

Não aparece a opção de adicionar conectores

Verifica se o teu plano o permite. No ChatGPT, ativa o modo desenvolvedor. Em contas corporativas, pede ao administrador que adicione ou habilite o conector; no Claude, a opção «Adicionar conector personalizado» aparece desativada se a tua organização apenas permitir que os administradores os adicionem.

Falha na conexão

Verifica se o endereço é exatamente o do teu ambiente, incluindo o caminho final /mcp/mcp .

Erro ao iniciar sessão

Verifica se o teu utilizador está ativo e se consegues entrar no GlobalSuite® pela web com o mesmo método. Se usares autenticação de dois fatores, tem o código à mão.

Conecta, mas não responde com dados

Desconecta e volta a conectar o MCP, inicia sessão e abre uma conversa nova com o conector ativado.

Não encontra uma análise, um requisito ou um documento

Escreve o nome tal como aparece no GlobalSuite® e verifica se o teu utilizador tem acesso. Os documentos são pesquisados pelo nome do ficheiro, não pelo seu conteúdo.

A resposta parece incompleta

Com um grande volume de dados, pede ao assistente que reveja todas as páginas de resultados, restringe a pergunta (por análise, categoria ou item) ou usa o modo de investigação do teu assistente.

Aviso de demasiados pedidos

Excedeste o limite de uso por minuto. Espera um momento e tenta novamente.

Pede para iniciar sessão novamente

É normal se o conector não foi usado por mais de 7 dias. Volta a iniciar sessão.

Nota: as telas de configuração pertencem a cada fornecedor de IA e podem mudar sem aviso prévio. Se algum passo não coincidir, consulta a ajuda oficial do teu assistente ou contacta o Suporte do GlobalSuite®.