# 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: ```bash 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: ```bash codex mcp add galco --url https://mcpgalco.yungol.com/mcp ``` 2. Si no se abre el navegador para iniciar sesión: ```bash codex mcp login galco ``` 3. Alternativa: agregá esto a `~/.codex/config.toml` y después ejecutá `codex mcp login galco`: ```toml [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): ```json { "$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.