Ligar Claude ChatGPT Copilot e outras ferramentas MCP ao Smart OSH

SmartOSH expõe um servidor MCP remoto ao qual podes ligar o Claude, ChatGPT ou outra ferramenta compatível com MCP para consultar a tua informação de forma assistida por IA.

Conhecimentos prévios

Este guia assume que já conheces o funcionamento do teu cliente MCP (Claude, ChatGPT, Copilot, etc.) e que estás familiarizado com o conceito de MCP. O SmartOSH não oferece suporte sobre o uso destas ferramentas além da ajuda necessária para realizar a ligação.

O que é MCP

MCP (Model Context Protocol) é um padrão aberto que permite aos assistentes de IA, como Claude ou ChatGPT, ligar-se de forma segura a aplicações e dados externos. Em vez de copiar e colar informação manualmente, o assistente liga-se ao servidor MCP e pode aceder aos dados que a aplicação disponibiliza.

O SmartOSH dispõe de um servidor MCP próprio, pelo que podes adicioná-lo como conector personalizado no Claude, ChatGPT (ou outra ferramenta compatível) e trabalhar com a tua informação diretamente a partir do assistente.

A função MCP é opcional

A ligação MCP é uma função opcional e, por segurança, está desativada por defeito (opt-in explícito). Se a função não estiver ativada, o conector não poderá ligar-se.

A ativação não é feita a partir das definições: é o consultor ou a equipa de suporte que a habilita a pedido do cliente. Por segurança, a equipa do SmartOSH verifica o pedido antes de ativar o serviço.

Uma vez ativado o serviço, as ferramentas (tools) concretas —como o envio de emails— e os domínios autorizados para esse envio configuram-se nas definições, da mesma forma que as restantes funcionalidades de IA do SmartOSH.

O que oferece o MCP do SmartOSH

O servidor MCP do SmartOSH vai além de expor dados: incorpora várias ferramentas (tools), prompts predefinidos e conhecimento específico de PRL para que o assistente de IA trabalhe de forma mais útil e orientada. Entre outras capacidades, oferece:

• Recuperação de informação: consulta de acidentes, relatórios e documentos, entre outros dados.
• Envio de emails diretamente a partir do SmartOSH (sujeito aos domínios autorizados configurados).
• Prompts predefinidos para tarefas habituais, que facilitam obter resultados consistentes sem ter de redigir instruções do zero.
• Metodologia específica de investigação de acidentes e outro conhecimento especializado em PRL incorporado no próprio serviço.

Nota

O conjunto de ferramentas disponíveis pode ser ampliado com o tempo e depende das funções ativadas para a tua organização.

URLs do servidor MCP do SmartOSH

Utiliza a URL correspondente ao ambiente com o qual queres trabalhar:

• Produção:

https://backend.my.smartosh.com/mcp

• Pré-produção:

https://backend.pre-my.smartosh.com/mcp

Cuidado

Estas são as URLs genéricas. Normalmente, cada cliente tem a sua própria URL personalizada com o formato:

https://MINHAEMPRESA.backend.my.smartosh.com/mcp

Onde MINHAEMPRESA é o subdomínio personalizado da tua organização. Se não conheces esse subdomínio, é isso que deves solicitar ao teu consultor ou ao suporte antes de configurar o conector.

Como ligar o Claude (conector personalizado)

Para adicionar um conector personalizado no Claude precisas de um servidor MCP remoto ao qual te ligar; neste caso, uma das URLs do SmartOSH indicadas acima. Os passos variam conforme o teu plano do Claude.

Planos individuais (Free, Pro ou Max)

1. Vai a Customize > Connectors (Personalizar > Conectores) nas definições, ou clica no botão «+» junto a Connectors.
2. Clica em Add custom connector (Adicionar conector personalizado) para criar um novo.
3. Escreve um nome para o identificar (por exemplo, SmartOSH).
4. Adiciona a URL do servidor MCP remoto do SmartOSH (a que o teu consultor ou suporte te indicou).
5. (Opcional) Clica em Advanced settings para especificar um OAuth Client ID e um OAuth Client Secret do teu servidor.
6. Clica em Add e segue o processo de ligação (autenticação), igual aos conectores do diretório.

Planos Team ou Enterprise

Nestes planos, antes que os membros possam configurar conectores personalizados, um Owner ou Primary Owner deve primeiro adicionar o conector à organização:

1. O Owner ou Primary Owner vai a Organization settings > Connectors, clica em Add e adiciona a URL do servidor MCP remoto do SmartOSH.
2. Cada utilizador encontra depois o conector na lista (aparecerá com uma etiqueta «Custom») e clica em Connect para se autenticar e começar a usar.

Disponibilidade por plano

Os conectores personalizados via MCP remoto estão disponíveis no Claude, Cowork e Claude Desktop para os planos Free, Pro, Max, Team e Enterprise. Os utilizadores Free estão limitados a um único conector personalizado, enquanto Pro, Max, Team e Enterprise suportam vários.

Como ligar o ChatGPT (conector personalizado)

No ChatGPT, os conectores MCP personalizados gerem-se através do Developer mode (modo desenvolvedor).

Ativar o Developer mode

1. Abre o ChatGPT na web e inicia sessão com uma conta de um plano compatível.
2. Vai a Settings > Connectors (Definições > Conectores) —consoante a tua versão pode aparecer como Apps.
3. Entra em Advanced settings (Definições avançadas); pode ser necessário descer para encontrar.
4. Ativa o interruptor de Developer mode.

Criar o conector

1. Em Settings > Connectors (ou Apps), clica em Create (Criar) junto a Advanced settings. O botão só aparece se o Developer mode estiver ativado.
2. Escreve um nome para identificar (por exemplo, SmartOSH).
3. (Opcional) Adiciona uma descrição, por exemplo «Acesso aos dados do SmartOSH».
4. Em MCP Server URL, cola a URL do servidor MCP remoto do SmartOSH.
5. Em Authentication seleciona o método correspondente (normalmente OAuth) e completa o processo de autenticação.
6. Guarda o conector. Aparecerá na tua lista de conectores (em Drafts enquanto se configura).

Usá-lo numa conversa

1. Abre uma conversa nova e clica no ícone «+» do compositor.
2. Seleciona Developer mode e ativa o conector SmartOSH como fonte.

Disponibilidade por plano no ChatGPT

O suporte completo a conectores MCP no ChatGPT está disponível nos planos Plus, Pro, Business, Enterprise e Education (não no plano Free) a partir do ChatGPT web. Nos planos Plus e Pro as ferramentas costumam estar limitadas a só leitura, enquanto nos Business e Enterprise/Education são permitidas ações de escrita, normalmente com autorização de um administrador.

Como ligar o Microsoft Copilot

No ecossistema Microsoft, os servidores MCP ligam-se através do Copilot Studio, onde se adicionam como ferramenta a um agente.

1. Entra no Copilot Studio e abre (ou cria) o agente ao qual queres adicionar a ligação.
2. Vai ao separador Tools (Ferramentas) e clica em Add a tool > New tool > Model Context Protocol.
3. Preenche os campos do assistente:
   • Server name (nome do servidor): por exemplo, SmartOSH.
   • Server description (descrição): uma breve explicação do propósito, pois o orquestrador usa-a para decidir quando chamar o servidor.
   • Server URL: a URL do servidor MCP remoto do SmartOSH.
4. Configura a autenticação correspondente (habitualmente OAuth 2.0) e completa o assistente. O Copilot Studio deteta automaticamente as ferramentas disponíveis do servidor.

Nota

O acesso a servidores MCP no Copilot Studio rege-se pelas políticas de dados do Power Platform da tua organização.

Como ligar o Gemini

No Gemini o método habitual para conectores MCP remotos é a Gemini CLI (orientada a perfis técnicos). Com a CLI instalada, adiciona o servidor com:

gemini mcp add --transport http SmartOSH <URL-do-servidor-MCP>

Se o servidor requer autenticação por cabeçalho, podes adicioná-la com -H:

gemini mcp add --transport http --header "Authorization: Bearer <token>" SmartOSH <URL-do-servidor-MCP>

Isto guarda a configuração em ~/.gemini/settings.json (âmbito de utilizador) ou em .gemini/settings.json (âmbito de projeto). Dentro da Gemini CLI podes executar /mcp para ver o servidor configurado e as suas ferramentas.

Nota

Em ambientes corporativos do Google Cloud, os conectores MCP também podem ser geridos a partir da Gemini Enterprise Agent Platform, indicando o nome do servidor, a URL, o transporte HTTP e os dados de autenticação (credenciais do Google Cloud ou OAuth Client ID/Secret).

Outros clientes compatíveis com MCP

O servidor MCP do SmartOSH segue o padrão MCP, pelo que pode ligar-se a partir de qualquer cliente compatível (por exemplo, editores e ferramentas de desenvolvimento como Cursor, VS Code ou Cline, entre outros). Embora a interface varie conforme a ferramenta, em geral só precisas destes dados:

• A URL do servidor MCP remoto do SmartOSH (produção ou pré-produção).
• O método de autenticação (por exemplo, OAuth, com o seu Client ID e Client Secret se aplicável).

Dica

Se a tua ferramenta não aparece nesta página, consulta a sua documentação sobre como adicionar um servidor MCP remoto e utiliza a URL e os dados de autenticação fornecidos pelo teu consultor ou pelo suporte.

Responsabilidade e proteção de dados

Através do serviço MCP, o SmartOSH limita-se a expor dados e ferramentas. O processamento da informação pela IA é realizado pelo motor ou ferramenta externa que decides ligar (Claude, ChatGPT, Copilot, Gemini ou outra), fora do controlo do SmartOSH.

Durante o uso do MCP, o SmartOSH não utiliza os seus próprios motores de IA. Portanto, o consumo de tokens (e qualquer custo associado) é da responsabilidade do cliente e da ferramenta de IA que estiver a usar.

Assim, os seguintes aspetos são responsabilidade do cliente e da ferramenta de IA utilizada:

• Os aspectos legais do uso da IA.
• A zona geográfica onde a IA é executada e os dados são processados.
• As implicações de proteção de dados e o cumprimento dos regulamentos aplicáveis sobre IA.

Dados pessoais nos campos de texto

O SmartOSH faz o seu melhor esforço para pseudonimizar os dados relativos aos nomes dos colaboradores. No entanto, as descrições e textos livres introduzidos pelos utilizadores nos campos de descrição podem conter dados pessoais.

O controlo normativo sobre onde e como estes dados são processados fica sob a responsabilidade do cliente que ativa o serviço MCP. Antes de o habilitar, certifica-te de que a ferramenta de IA escolhida e a sua região de processamento cumprem as tuas obrigações legais e de proteção de dados.