Conectar Galco con tu IA (MCP)

El MCP de Galco deja que tu propia IA (Claude, ChatGPT, Codex u OpenCode) consulte información de Galco. Le preguntás en lenguaje natural, por ejemplo “¿cuántos pedidos hubo en septiembre?”, y ella busca los datos en Galco y te responde. Por ahora es solo de consulta: no crea ni modifica nada.

Datos del servidor

• Dirección del servidor MCP: https://mcpgalco.yungol.com/mcp
• Nombre recomendado del servidor: galco
• Transporte: HTTP (Streamable HTTP), remoto.
• Autenticación: OAuth 2.1 con tu cuenta de Galco (Google o correo y contraseña). No se usan claves ni tokens manuales.

Antes de empezar

• Una cuenta de Galco con el rol MCP Galco. Si no lo tenés, pedíselo a un administrador: se asigna en Editar usuario, grupo “MCP”.
• Un asistente que admita servidores MCP remotos con inicio de sesión: Claude Code, Claude (web y escritorio), ChatGPT, Codex u OpenCode.

El rol MCP Galco solo da acceso al MCP. No da acceso a la aplicación web de Galco.

Instalación

Claude Code

1. En la terminal:

   claude mcp add -s user --transport http galco https://mcpgalco.yungol.com/mcp

   -s user deja el servidor disponible en todas las carpetas. Sin esa opción solo queda en la carpeta donde lo agregaste.

2. Abrí Claude Code, escribí /mcp, elegí galco y pulsá Authenticate.

3. Iniciá sesión en la página “Conectar con MCP Galco” que se abre en el navegador.

4. Probá: “¿Cuántos pedidos hubo en septiembre de 2026 y cuántos están terminados?”.

Claude (web y escritorio)

1. Andá a Personalizar → Conectores.
2. Pulsá ”+ Agregar” → “Agregar conector personalizado”.
3. Nombre: Galco. URL: https://mcpgalco.yungol.com/mcp. Pulsá “Continuar” y luego “Agregar”.
4. Iniciá sesión con tu cuenta de Galco cuando Claude te lo pida.
5. En cada conversación, activalo desde el botón ”+” → Conectores.

El plan gratuito de Claude permite un solo conector personalizado. En planes Team y Enterprise, un propietario tiene que agregarlo primero en la configuración de la organización.

ChatGPT

1. En ChatGPT web, abrí Configuración → Apps (en algunas cuentas aparece como Conectores) → Configuración avanzada y activá el modo desarrollador si te lo pide.
2. Creá una app MCP: nombre Galco, URL https://mcpgalco.yungol.com/mcp, autenticación OAuth.
3. Iniciá sesión con tu cuenta de Galco y activá la app en la conversación.

En espacios de trabajo, un administrador tiene que crear y publicar la app. Solo funciona en la versión web. Los nombres de los menús de ChatGPT cambian seguido.

Codex

1. En la terminal:

   codex mcp add galco --url https://mcpgalco.yungol.com/mcp

2. Si no se abre el navegador para iniciar sesión:

   codex mcp login galco

3. Alternativa: agregá esto a ~/.codex/config.toml y después ejecutá codex mcp login galco:

   [mcp_servers.galco]
   url = "https://mcpgalco.yungol.com/mcp"

4. Revisá la conexión con codex mcp list.

OpenCode

1. Agregá esto a opencode.json (global en ~/.config/opencode/opencode.json o en tu proyecto):

   {
     "$schema": "https://opencode.ai/config.json",
     "mcp": {
       "galco": {
         "type": "remote",
         "url": "https://mcpgalco.yungol.com/mcp"
       }
     }
   }

2. Iniciá sesión: opencode mcp auth galco.

3. Revisá la conexión con opencode mcp list.

Primer inicio de sesión

Al conectar se abre la página “Conectar con MCP Galco”. Iniciá sesión con Google o con correo y contraseña, con la misma cuenta que usás en Galco. Si tu cuenta no tiene el rol MCP Galco, vas a ver el mensaje “No tienes permisos para acceder al MCP de Galco. Pídele a un administrador el rol MCP Galco.” y no se concede el acceso.

Si te quitan el rol, el acceso se corta en la siguiente consulta, sin esperar a que venza la sesión.

Qué podés hacer

Herramienta	Para qué sirve
pedidos_del_mes	Ver los pedidos de producción de un mes: total, cuántos están terminados, cuántos hay en cada estado y el detalle de cada pedido (documento, cliente, vendedor, fechas de pedido y entrega, estado y avance). Trae hasta 500 pedidos por consulta.
whoami	Ver con qué cuenta de Galco está conectada tu IA.

Ejemplos de preguntas:

• “¿Cuántos pedidos hubo en septiembre de 2026 y cuántos están terminados?”
• “Mostrame los pedidos de octubre de 2026 que todavía no están finalizados.”
• “Compará la cantidad de pedidos de agosto y septiembre de 2026.”

Iremos sumando más consultas. Cuando aparezcan, reconectá el servidor para verlas.

Problemas frecuentes

• No se abre el inicio de sesión. Claude Code: escribí /mcp y elegí galco. Codex: codex mcp login galco. OpenCode: opencode mcp auth galco. Claude y ChatGPT: desconectá y volvé a conectar la app.
• “No tienes permisos para acceder al MCP de Galco”. Pedile a un administrador el rol MCP Galco y volvé a conectar.
• Las herramientas nuevas no aparecen. Reconectá el servidor (en Claude Code: /mcp → Reconnect).
• Quiero desconectarlo. Claude Code: claude mcp remove -s user galco. Codex: codex mcp remove galco. OpenCode: opencode mcp logout galco. Claude: Personalizar → Conectores → quitar. ChatGPT: eliminá la app en Configuración.

Instrucciones para agentes

Si sos un agente de IA y te pidieron instalar este MCP:

1. Usá estos datos exactos: nombre galco, URL https://mcpgalco.yungol.com/mcp, transporte HTTP remoto, autenticación OAuth (no pidas ni configures tokens).
2. Agregá el servidor con el comando de tu cliente, según la sección Instalación (Claude Code: claude mcp add -s user --transport http galco https://mcpgalco.yungol.com/mcp).
3. Iniciá el flujo de autenticación y pedile a la persona que complete el inicio de sesión en el navegador con su cuenta de Galco.
4. Verificá la conexión llamando a whoami. Si responde con el correo de la persona, la instalación está lista.
5. Si el inicio de sesión responde que no tiene permisos, decile a la persona que le pida a un administrador el rol MCP Galco. No reintentes.