# Documentación de agentes de IA y MCP | MerchandAise

- slug: developers-ai-agents-mcp
- locale: es
- localeResolved: es
- canonical: https://www.merchandaise.com/es/developers/ai-agents-mcp

Explora la documentación MCP, el descubrimiento de servidores y las herramientas de agentes de IA de MerchandAise para diseño y presupuestos, con permisos y aprobaciones.

## Entiende qué puede hacer el asistente
En sesiones compatibles, un usuario puede describir una idea, ver el producto en 3D interactivo y pedir cambios. El asistente utiliza la misma información de producto y estado de diseño que el proceso de MerchandAise. Las herramientas actuales determinan qué puede leer o cambiar.
La ficha del servidor y los metadatos de herramientas externas son públicos para su descubrimiento. Cada llamada sigue respetando sus límites declarados de seguridad y espacio de trabajo, mientras las aprobaciones del comprador, las pruebas y la producción permanecen visibles y atribuibles.

## Descubre el servidor. Después, solicita el acceso adecuado.
- **Agentes de IA y MCP:** Conecta un asistente de IA mediante el Model Context Protocol. Descubre las herramientas compatibles y conserva las decisiones de diseño, los permisos y las confirmaciones necesarias del usuario. Human guide: Leer la guía de implementación MCP (/es/developers/ai-agents-mcp#implementation-checklist). Machine-readable contract: Ficha pública del servidor MCP en JSON (/.well-known/mcp/server-card). Acceso: Público. Documento público de descubrimiento para clientes de máquina. La lista de herramientas externas en /api/v1/mcp/tools muestra los metadatos actuales. Cada llamada sigue respetando sus límites declarados de seguridad, espacio de trabajo y confirmación. Canonical page: /es/developers/ai-agents-mcp. Canonical section: /es/developers/ai-agents-mcp#mcp-tools.
- **Documentación API y OpenAPI:** Encuentra la referencia API para herramientas de asistentes y sesiones de diseño. Después, elige el contrato de comunidad, proveedor o empresa para tu proceso. Human guide: Explorar la documentación API (/es/developers/api-integrations). Machine-readable contract: OpenAPI de herramientas para asistentes en JSON (/api/docs/openapi.json). Acceso: Público. Referencia pública para API de asistentes y herramientas. El acceso a producción y las operaciones que afectan a pedidos siguen requiriendo la autorización aplicable. Canonical page: /es/developers/ai-agents-mcp. Canonical section: /es/developers/ai-agents-mcp#api-docs.

## Del descubrimiento del servidor a tu primer proceso
- **Step 1: Descubre de forma segura:** Utiliza la ficha pública del servidor MCP y la lista de herramientas para identificar MerchandAise y el inventario actual de herramientas externas. El descubrimiento por sí solo no concede una autorización amplia para presupuestar, cambiar el estado o pedir.
- **Step 2: Concede los permisos mínimos:** Autoriza solo las herramientas, el espacio y el entorno que necesita el asistente. Separa la exploración de solo lectura de las acciones que cambian el diseño, el presupuesto, la aprobación o el estado del pedido.
- **Step 3: Confirma antes de una acción con consecuencias:** Mantén la confirmación humana explícita para las acciones sensibles, prueba el comportamiento ante estados obsoletos y rechazos y demuestra las opciones de recuperación antes de habilitar tráfico de producción.

## Qué debe conservar el agente
- **Un único estado de producto versionado:** El asistente trabaja sobre el mismo diseño, intención de compra, presupuesto respaldado por el proveedor, aprobación y estado del pedido que las demás interfaces de MerchandAise.
- **Privacidad comercial y del proveedor:** Cuando MerchandAise procesa la transacción del comprador, Hutter Products GmbH es el vendedor contratante y el Merchant of Record bajo la marca MerchandAise. La identidad privada del proveedor, los contactos y los datos internos no se muestran a un agente.
- **Las aprobaciones de pruebas siguen siendo humanas:** Una vista en 3D no es una prueba física. El presupuesto confirmado explica las opciones de muestras para el cliente disponibles, sus costes, limitaciones y plazos. Aprueba la prueba digital exacta y completa las comprobaciones técnicas obligatorias y las aprobaciones de muestras necesarias o elegidas antes de la producción en serie. Los requisitos ya aceptados del pedido siguen siendo vinculantes.

## Antes de que un agente llegue a producción
Un servidor MCP descubrible es solo el principio. Estar listo para producción significa que el asistente tiene una función limitada, cada acción con consecuencias tiene un responsable y los errores devuelven al usuario a un estado seguro.
- **Define el acceso según las consecuencias:** Clasifica cada herramienta como de solo lectura, orientación, cambio de estado, datos sensibles de proveedores o efectos sobre pedidos antes de concedérsela a un asistente.
- **Identifica al responsable de cada confirmación:** Define quién confirma los cambios de producto, presupuestos, pruebas digitales, muestras de producción y pedidos, y qué hace el asistente cuando esa persona no está disponible.
- **Observa, rechaza y recupera:** Prueba entradas no válidas, estados obsoletos, permisos que faltan, rechazos, reintentos, telemetría y reversión antes de que el tráfico real llegue al proceso.

## Preguntas frecuentes
- **¿Qué es MCP? ¿Es una aplicación pública de ChatGPT?:** MCP significa Model Context Protocol: una forma de que un asistente descubra y utilice herramientas. Estos documentos describen las capacidades de integración de MerchandAise. Una ficha pública del servidor no confirma la disponibilidad en la tienda de aplicaciones de ChatGPT. El acceso al espacio de ChatGPT depende de tu cuenta, de la configuración de la aplicación y del entorno compatible.
- **¿Qué puede hacer un agente de IA con MerchandAise?:** Un asistente autorizado puede utilizar las herramientas aprobadas para su espacio y entorno, como el descubrimiento de productos, la orientación de diseño o presupuestos y otras operaciones habilitadas explícitamente. Las herramientas disponibles y sus permisos se determinan durante la revisión de la integración.
- **¿Un agente de IA puede realizar pedidos automáticamente?:** No por descubrir el servidor o listar herramientas. Todo proceso que afecte a pedidos debe conservar la autenticación, la confirmación del comprador y del espacio de trabajo, los precios actualizados, la aprobación de la prueba digital, la viabilidad de producción confirmada por el proveedor, las comprobaciones técnicas obligatorias y la opción exacta de muestras para el cliente y sus requisitos de aprobación acordados para el pedido. Los requisitos ya aceptados del pedido no pueden eliminarse sin avisar.
- **¿La integración MCP de MerchandAise es pública?:** La ficha del servidor MCP y los metadatos actuales de las herramientas externas son públicos para el descubrimiento por máquinas. Cada llamada sigue su modelo de seguridad declarado. Las operaciones protegidas de espacios de trabajo, proveedores, empresas, presupuestos y pedidos conservan sus autorizaciones y confirmaciones necesarias.

## ¿Tienes en mente un proceso con agentes?
Cuéntanos a quién sirve el asistente, qué debería poder hacer y dónde debe mantener el control una persona. Definiremos los límites adecuados de MCP, API y aprobaciones.
- **Revisar un proceso con agentes:** /es/contact?intent=agent-mcp-review
- **Explorar los contratos API:** /es/developers/api-integrations
