Connectar Claude ChatGPT Copilot i altres eines MCP a Smart OSH
SmartOSH exposa un servidor MCP remot que pots connectar a Claude, ChatGPT o una altra eina compatible amb MCP per consultar la teva informació de forma assistida per IA.
Què és MCP
Section titled “Què és MCP”MCP (Model Context Protocol) és un estàndard obert que permet als assistents d’IA, com Claude o ChatGPT, connectar-se de forma segura a aplicacions i dades externes. En lloc de copiar i enganxar informació manualment, l’assistent es connecta al servidor MCP i pot accedir a les dades que l’aplicació posa a la seva disposició.
SmartOSH disposa d’un servidor MCP propi, per la qual cosa pots afegir-lo com a connector personalitzat a Claude, ChatGPT (o una altra eina compatible) i treballar amb la teva informació directament des de l’assistent.
Què ofereix el MCP de SmartOSH
Section titled “Què ofereix el MCP de SmartOSH”El servidor MCP de SmartOSH va més enllà d’exposar dades: incorpora diverses eines (tools), prompts predefinits i coneixement específic de PRL perquè l’assistent d’IA treballi de forma més útil i guiada. Entre altres capacitats, ofereix:
- Recuperació d’informació: consulta d’accidents, informes i documents, entre altres dades.
- Enviament de correus directament des de SmartOSH (subjecte als dominis autoritzats configurats).
- Prompts predefinits per a tasques habituals, que faciliten obtenir resultats consistents sense haver de redactar instruccions des de zero.
- Metodologia específica d’investigació d’accidents i altre coneixement especialitzat en PRL incorporat al propi servei.
URLs del servidor MCP de SmartOSH
Section titled “URLs del servidor MCP de SmartOSH”Utilitza la URL corresponent a l’entorn amb què vulguis treballar:
- Producció:
https://backend.my.smartosh.com/mcp- Preproducció:
https://backend.pre-my.smartosh.com/mcpCom connectar Claude (connector personalitzat)
Section titled “Com connectar Claude (connector personalitzat)”Per afegir un connector personalitzat a Claude necessites un servidor MCP remot al qual connectar-te; en aquest cas, una de les URLs de SmartOSH indicades més amunt. Els passos varien segons el teu pla de Claude.
Plans individuals (Free, Pro o Max)
Section titled “Plans individuals (Free, Pro o Max)”- Ves a Customize > Connectors (Personalitzar > Connectors) als ajustos, o prem el botó «+» al costat de Connectors.
- Prem Add custom connector (Afegir connector personalitzat) per crear-ne un de nou.
- Escriu un nom per identificar-lo (per exemple,
SmartOSH). - Afegeix la URL del servidor MCP remot de SmartOSH (la que t’hagi indicat el teu consultor o suport).
- (Opcional) Prem Advanced settings per especificar un OAuth Client ID i un OAuth Client Secret del teu servidor.
- Prem Add i segueix el procés de connexió (autenticació), igual que amb els connectors del directori.
Plans Team o Enterprise
Section titled “Plans Team o Enterprise”En aquests plans, abans que els membres puguin configurar connectors personalitzats, un Owner o Primary Owner ha d’afegir primer el connector a l’organització:
- L’Owner o Primary Owner va a Organization settings > Connectors, prem Add i afegeix la URL del servidor MCP remot de SmartOSH.
- Cada usuari troba després el connector a la llista (apareixerà amb una etiqueta «Custom») i prem Connect per autenticar-se i començar a usar-lo.
Com connectar ChatGPT (connector personalitzat)
Section titled “Com connectar ChatGPT (connector personalitzat)”A ChatGPT, els connectors MCP personalitzats es gestionen a través del Developer mode (mode desenvolupador).
Activar el Developer mode
Section titled “Activar el Developer mode”- Obre ChatGPT a la web i inicia sessió amb un compte d’un pla compatible.
- Ves a Settings > Connectors (Ajustos > Connectors) —segons la teva versió pot aparèixer com a Apps.
- Entra a Advanced settings (Ajustos avançats); pot ser que hagis de baixar per trobar-ho.
- Activa l’interruptor de Developer mode.
Crear el connector
Section titled “Crear el connector”- A Settings > Connectors (o Apps), prem Create (Crear) al costat de Advanced settings. El botó només apareix si el Developer mode està activat.
- Escriu un nom per identificar-lo (per exemple,
SmartOSH). - (Opcional) Afegeix una descripció, per exemple «Accés a les dades de SmartOSH».
- A MCP Server URL, enganxa la URL del servidor MCP remot de SmartOSH.
- A Authentication selecciona el mètode que correspongui (normalment OAuth) i completa el procés d’autenticació.
- Desa el connector. Apareixerà a la teva llista de connectors (a Drafts mentre es configura).
Usar-lo en una conversa
Section titled “Usar-lo en una conversa”- Obre una conversa nova i prem la icona «+» del compositor.
- Selecciona Developer mode i activa el connector de SmartOSH com a font.
Com connectar Microsoft Copilot
Section titled “Com connectar Microsoft Copilot”A l’ecosistema de Microsoft, els servidors MCP es connecten a través de Copilot Studio, on s’afegeixen com a eina a un agent.
- Entra a Copilot Studio i obre (o crea) l’agent al qual vulguis afegir la connexió.
- Ves a la pestanya Tools (Eines) i prem Add a tool > New tool > Model Context Protocol.
- Omple els camps de l’assistent:
- Server name (nom del servidor): per exemple,
SmartOSH. - Server description (descripció): una breu explicació de per a què serveix, ja que l’orquestrador l’usa per decidir quan cridar el servidor.
- Server URL: la URL del servidor MCP remot de SmartOSH.
- Server name (nom del servidor): per exemple,
- Configura l’autenticació que correspongui (habitualment OAuth 2.0) i completa l’assistent. Copilot Studio detecta automàticament les eines disponibles del servidor.
Com connectar Gemini
Section titled “Com connectar Gemini”A Gemini la via habitual per a connectors MCP remots és la Gemini CLI (orientada a perfils tècnics). Amb la CLI instal·lada, afegeix el servidor amb:
gemini mcp add --transport http SmartOSH <URL-del-servidor-MCP>Si el servidor requereix autenticació per capçalera, la pots afegir amb -H:
gemini mcp add --transport http --header "Authorization: Bearer <token>" SmartOSH <URL-del-servidor-MCP>Això guarda la configuració a ~/.gemini/settings.json (àmbit d’usuari) o a .gemini/settings.json (àmbit de projecte). Dins de Gemini CLI pots executar /mcp per veure el servidor configurat i les seves eines.
Altres clients compatibles amb MCP
Section titled “Altres clients compatibles amb MCP”El servidor MCP de SmartOSH segueix l’estàndard MCP, per la qual cosa pot connectar-se des de qualsevol client compatible (per exemple, editors i eines de desenvolupament com Cursor, VS Code o Cline, entre altres). Tot i que la interfície canvia segons l’eina, en general només necessites aquestes dades:
- La URL del servidor MCP remot de SmartOSH (producció o preproducció).
- El mètode d’autenticació (per exemple, OAuth, amb el seu Client ID i Client Secret si escau).
Responsabilitat i protecció de dades
Section titled “Responsabilitat i protecció de dades”A través del servei MCP, SmartOSH es limita a exposar dades i eines. El processament de la informació per part de la IA el realitza el motor o l’eina externa que tu decideixes connectar (Claude, ChatGPT, Copilot, Gemini o altra), fora del control de SmartOSH.
Durant l’ús de MCP, SmartOSH no utilitza els seus propis motors d’IA. Per tant, el consum de tokens (i qualsevol cost associat) corre a càrrec del client i de l’eina d’IA que estigui utilitzant.
Per tant, els següents aspectes són responsabilitat del client i de l’eina d’IA utilitzada:
- Els aspectes legals de l’ús de la IA.
- La zona geogràfica en què s’executa la IA i es processen les dades.
- Les implicacions de protecció de dades i el compliment dels reglaments aplicables sobre IA.