> ## Documentation Index > Fetch the complete documentation index at: https://docs.retailgrid.io/llms.txt > Use this file to discover all available pages before exploring further. # Conexiones de IA > Conecta Claude o ChatGPT a Retailgrid, revisa las herramientas MCP disponibles y sus permisos, y desconecta un cliente de IA. Conecta un asistente de IA a Retailgrid para explorar tu catálogo, trabajar con tus Grids, clasificar roles de producto con **Product Roles** y revisar precios propuestos. El asistente usa tu inicio de sesión de Retailgrid. Las lecturas del catálogo abarcan tu organización; los Grids y los trabajos (jobs) se limitan a los que te pertenecen. Abre **Settings → AI connections** en Retailgrid para revisar los clientes conectados, ver el acceso que se les concedió o desconectarlos. ![Settings - AI connections, sin clientes conectados todavía](https://mintcdn.com/retailgrid/eeNZD0h61Oo_RGG9/images/settings/ai-connections.png?fit=max\&auto=format\&n=eeNZD0h61Oo_RGG9\&q=85\&s=a9b1710e606681665e225f01c4bccb05) ## Antes de conectar Necesitas una cuenta activa de Retailgrid con **las conexiones de IA habilitadas para tu organización**, y un cliente de IA que admita conexiones MCP remotas con OAuth. Es posible que tu espacio de trabajo de Claude o ChatGPT también requiera que un administrador habilite las conexiones personalizadas. > [!NOTE] > > Si AI connections no aparece en Settings, contáctanos para habilitarlo en tu organización. Usa esta URL del servidor, incluyendo `/mcp`: ```text theme={null} https://mcp.retailgrid.io/mcp ``` Retailgrid usa inicio de sesión y consentimiento en el navegador. No necesitas una clave de API de Retailgrid ni un ID o secreto de cliente OAuth creado manualmente. ## Elegir acceso de lectura o escritura | Acceso | Qué permite | | :- | :- | | **Read** (`retailgrid:read`) | Explorar productos, inspeccionar tus Grids y trabajos, y leer Product Roles y propuestas de precio. | | **Read and write** (`retailgrid:read retailgrid:write`) | Además, crear o editar Grids, ejecutar Product Roles, cambiar decisiones de revisión de precios y publicar precios aceptados. | Las conexiones nuevas suelen solicitar acceso de lectura y escritura. Un cliente que solicita explícitamente solo `retailgrid:read` recibe acceso de solo lectura. Revisa los permisos en la pantalla de consentimiento de Retailgrid antes de aprobar; rechaza si no quieres conceder el acceso solicitado. Si tu cliente permite elegir los scopes, solicita acceso de solo lectura para empezar. La autorización de escritura y las solicitudes de confirmación de herramientas de tu cliente son cosas distintas. Retailgrid aplica los scopes concedidos en cada llamada. La configuración de tu cliente de IA determina cuándo te pide aprobar una acción individual, y puede recordar una aprobación para llamadas posteriores. Revisa esa configuración y el Grid, las filas y los valores previstos antes de permitir escrituras. Para ampliar una conexión existente de solo lectura, solicita ambos scopes y completa un nuevo flujo de consentimiento. Refrescar la conexión no añade acceso de escritura. Si el cliente no ofrece un nuevo flujo de autorización, desconéctalo en Retailgrid y vuelve a conectarlo; después comprueba que la pantalla de consentimiento y la lista de conexiones muestran acceso de lectura y escritura. Una escritura intentada con acceso de solo lectura se rechaza con un error de scope insuficiente. ## Conectar desde Claude 1. Abre **Customize → Connectors** en Claude y elige **Add custom connector** en el menú de añadir. 2. Nombra el conector **Retailgrid** e introduce `https://mcp.retailgrid.io/mcp` como URL del servidor remoto. 3. Mantén habilitado el inicio de sesión OAuth. Si Claude ofrece elegir el cliente OAuth, selecciona **Register automatically**. Deja vacíos los encabezados de solicitud fijos y las credenciales de cliente suministradas manualmente. 4. Termina de añadir el conector y selecciona **Connect** si se te solicita. En la página de Retailgrid que se abre, inicia sesión con tu correo y contraseña habituales o con tu cuenta de Google. 5. Revisa el nombre del cliente y los permisos solicitados de lectura o lectura/escritura, y luego aprueba o rechaza. Tras la aprobación, comprueba que Claude aparece en **Settings → AI connections** de Retailgrid. 6. Habilita Retailgrid en el menú de conectores de la conversación y pregunta: **"Use Retailgrid to list my first 20 Grids."** En un espacio de trabajo Team o Enterprise, un administrador autorizado añade primero el conector remoto en **Organization settings → Connectors → Add → Custom → Web**. Después, cada miembro se conecta con su propio inicio de sesión de Retailgrid. La misma conexión remota está disponible a través de Claude Desktop; usa la URL pública del servidor indicada arriba. Consulta la [guía de conectores remotos de Claude](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp) para conocer los controles actuales del cliente y los requisitos del espacio de trabajo. ## Conectar desde ChatGPT 1. Abre [ChatGPT Plugins](https://chatgpt.com/plugins) en la web. En el menú del signo más, elige **Add custom MCP server**. Las conexiones personalizadas deben estar permitidas por tu espacio de trabajo. 2. Introduce **Retailgrid** como nombre y `https://mcp.retailgrid.io/mcp` como URL del servidor. 3. Selecciona la autenticación **OAuth**. Usa el registro automático de cliente (DCR) si ChatGPT ofrece elegir el tipo de registro; Retailgrid registra el cliente por ti, así que deja vacías las credenciales de cliente suministradas manualmente. 4. Revisa el aviso de conexión de ChatGPT y crea el plugin. Completa la autorización de la cuenta cuando se te solicite: inicia sesión en la página de Retailgrid con tu correo y contraseña habituales o con tu cuenta de Google, revisa los permisos solicitados y aprueba o rechaza. 5. Instala el plugin resultante en el área personal o del espacio de trabajo donde lo creaste. Comprueba que ChatGPT aparece en **Settings → AI connections** de Retailgrid con el acceso que aprobaste. 6. En una conversación, escribe **@**, selecciona Retailgrid y pregunta: **"List my first 20 Grids."** Si la opción de añadir un servidor personalizado no está disponible, revisa con el administrador los permisos de conexiones personalizadas y de modo desarrollador de tu espacio de trabajo. Consulta la [guía de conexiones MCP personalizadas de OpenAI](https://developers.openai.com/api/docs/guides/custom-mcp-server) para conocer los controles y la disponibilidad actuales. ## Herramientas disponibles Las siguientes herramientas están disponibles en el endpoint de producción. **Read** requiere acceso de lectura. **Write** requiere acceso de lectura y escritura, incluidas las acciones que inician un trabajo. ### Catálogo | Herramienta | Qué hace | Acceso | | :- | :- | :- | | `list_products` | Recorre por páginas el catálogo de productos de tu organización. | Read | | `get_product` | Lee un producto por su UUID. | Read | ### Grids y alcance | Herramienta | Qué hace | Acceso | | :- | :- | :- | | `list_grids` | Lista tus Grids no archivados. | Read | | `get_grid_scope_fields` | Descubre los campos de alcance, métricas, operadores, ventanas de tiempo y límites de copia. | Read | | `get_grid_scope_options` | Encuentra los valores permitidos para los campos de alcance, incluidas las opciones de tienda, zona y canal. | Read | | `preview_grid_scope` | Previsualiza los productos coincidentes y el número de filas antes de crear un Grid. | Read | | `get_grid_scope` | Lee el alcance guardado y el estado de construcción de un Grid. | Read | | `create_grid` | Crea un Grid con nombre a partir de un alcance revisado. | Write | | `duplicate_grid` | Duplica uno de tus Grids con el mismo alcance o con uno modificado. | Write | ### Columnas y datos del Grid | Herramienta | Qué hace | Acceso | | :- | :- | :- | | `list_grid_columns` | Descubre las claves, tipos y definiciones de columna disponibles. | Read | | `read_grid` | Lee columnas almacenadas seleccionadas o columnas de fórmula en vivo soportadas de tu Grid. | Read | | `add_grid_column` | Añade una columna personalizada, de fórmula o de métrica histórica/de pronóstico soportada. | Write | | `edit_grid_column` | Edita la definición de una columna personalizada conservando su identidad. | Write | | `update_grid_cells` | Establece valores en una columna personalizada editable. | Write | ### Recomendaciones y propuestas de precio | Herramienta | Qué hace | Acceso | | :- | :- | :- | | `explain_price_recommendation` | Explica la recomendación de precio y el pronóstico guardados de una fila. | Read | | `get_price_optimization_summary` | Resume las propuestas actuales y su impacto pronosticado. | Read | | `query_price_proposals` | Filtra y clasifica las propuestas actuales, con restricciones de selección opcionales. | Read | Estas herramientas leen recomendaciones y propuestas existentes. Ejecuta Price Optimization desde la [aplicación de Retailgrid](https://docs.retailgrid.io/es/agents/price-optimization.md) antes de pedir a un asistente que revise sus resultados. ### Price Approval | Herramienta | Qué hace | Acceso | | :- | :- | :- | | `read_price_approval_queue` | Lee las filas de revisión de precios usando filtros y búsqueda de productos. | Read | | `get_price_approval_counts` | Lee los recuentos de cada estado de revisión en todo el Grid. | Read | | `get_price_approval_impact` | Lee el impacto pronosticado de una selección filtrada. | Read | | `get_price_approval_history` | Lee las decisiones y comentarios de MCP de una fila. | Read | | `read_approved_prices` | Lee el historial de precios registrados y el estado de entrega sin marcar los precios como entregados. | Read | | `set_price_approval_status` | Acepta o rechaza propuestas en una selección revisada. | Write | | `override_price_proposal` | Establece un precio de revisor, o elimina la anulación, y actualiza sus pronósticos. | Write | | `comment_on_price_proposal` | Guarda un comentario en una fila y conserva su historial de comentarios de MCP. | Write | | `publish_approved_prices` | Registra todos los precios actualmente aceptados en el Grid para su entrega posterior. | Write | > [!NOTE] > > Aceptar o anular una propuesta no la publica. Publicar registra **todos los precios actualmente aceptados en el Grid**, no solo las filas de una vista filtrada. Restablece las decisiones Accepted y Rejected a To Review. La entrega a una tienda se realiza a través de la integración posterior. ### Product Roles | Herramienta | Qué hace | Acceso | | :- | :- | :- | | `get_product_roles_config` | Lee los valores por defecto de clasificación y los ajustes de umbral permitidos. | Read | | `run_product_roles` | Inicia la clasificación y guarda los Product Roles en tu Grid. | Write | | `get_current_product_roles` | Lee las clasificaciones actuales o los roles guardados y fijados de un Grid. | Read | | `get_product_role_detail` | Explica la clasificación de una fila del Grid y su rol fijado efectivo. | Read | | `set_product_role_override` | Fija o libera un rol en una fila del Grid. | Write | | `get_product_role_history` | Lee el historial de fijación y liberación de la fila desde la interfaz y desde MCP. | Read | ### Trabajos | Herramienta | Qué hace | Acceso | | :- | :- | :- | | `get_job_status` | Lee el estado de un trabajo que te pertenece. | Read | ## Trabajar con tus datos Empieza pidiendo al asistente que liste tus Grids, descubra las columnas de un Grid y lea una página pequeña usando las claves de columna devueltas. Un asistente puede leer columnas almacenadas accesibles desde la interfaz y valores de fórmula en vivo soportados. La herramienta de clasificación de propuestas no admite ordenar ni proyectar por fórmulas. Las lecturas se paginan y reflejan datos en vivo, por lo que los valores pueden cambiar entre llamadas. Pide al asistente que siga la información de paginación devuelta y que conserve los avisos de truncamiento. Una página pequeña o un conjunto limitado de columnas es más fácil de revisar que un catálogo completo. Para las escrituras, pide al asistente que previsualice el alcance o la selección y muestre primero el cambio previsto. Si la adición de una columna tiene un resultado incierto, inspecciona las columnas y los trabajos del Grid antes de reintentar; repetir una adición puede crear otra columna. Para las operaciones que usan un ID de solicitud, reutiliza ese ID al reintentar la misma acción. Usa la [API pública](https://docs.retailgrid.io/es/api-reference/introduction.md) para extracciones programadas o integraciones con una herramienta ERP o BI. ## Desconectar un cliente 1. En Retailgrid, abre **Settings → AI connections**. 2. Busca el cliente y selecciona **Disconnect**. Retailgrid revoca la autorización de inmediato, de modo que los tokens emitidos anteriormente dejan de funcionar. Tus datos y las demás conexiones de clientes permanecen intactos. Para volver a usar ese cliente, reconéctalo desde el cliente de IA y aprueba una nueva solicitud de consentimiento. También puedes eliminar el conector o el plugin desde el cliente de IA. Usa la acción Disconnect de Retailgrid para revocar su acceso a Retailgrid. ## Solución de problemas | Problema | Qué comprobar | | :- | :- | | AI connections no aparece o se deniega el inicio de sesión. | Tu cuenta debe estar activa y tu organización habilitada para las conexiones de IA. Contáctanos si es necesario. | | Falta la opción de conector o plugin personalizado. | Revisa el plan de tu cliente y los permisos del espacio de trabajo con su administrador. | | El registro OAuth falla. | Usa la URL HTTPS completa que termina en `/mcp`, autenticación OAuth y registro automático. | | Una escritura devuelve un error de scope insuficiente. | Autoriza los scopes de lectura y escritura mediante un nuevo consentimiento. Refrescar por sí solo no amplía el acceso. | | No se encuentra un Grid o un trabajo. | La conexión usa tu cuenta personal de Retailgrid; comprueba que ese Grid o trabajo te pertenece. | | La lista de herramientas del asistente está desactualizada. | Refresca las herramientas en el cliente de IA, o reconéctalo para descubrir las herramientas actuales del servidor. | ## Relacionado * [Conecta tu asistente de IA](https://docs.retailgrid.io/es/settings/connect-ai-assistant.md) * [Price Approval](https://docs.retailgrid.io/es/agents/price-approval.md) * [Product Roles](https://docs.retailgrid.io/es/agents/product-roles.md) * [Introducción a la API](https://docs.retailgrid.io/es/api-reference/introduction.md) * [Integraciones](https://docs.retailgrid.io/es/settings/integrations.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.