API2Cart MCP

API2Cart MCP permite a los agentes de IA trabajar con plataformas de comercio electrónico conectadas a través de API2Cart sin tener que llamar manualmente a cada endpoint REST. El agente se conecta al servidor MCP, recibe las herramientas disponibles, selecciona una integración y una conexión, y luego realiza acciones de API dentro de los permisos del token MCP.

Esta guía explica cómo crear un token MCP, conectar un cliente MCP, trabajar con conexiones existentes y añadir una nueva conexión.

Antes de Empezar

Antes de usar API2Cart MCP, asegúrate de tener:

1. Una cuenta de API2Cart.
2. Acceso a Settings -> MCP en el panel de API2Cart.
3. Un cliente compatible con MCP, como Claude Code, Cursor, VS Code, OpenAI Codex, Google Antigravity o LM Studio.
4. Una conexión existente de API2Cart o credenciales para añadir una nueva conexión.

Endpoint del servidor MCP de producción:

https://mcp.api2cart.com/

Versión del Protocolo y Compatibilidad

El servidor MCP de API2Cart implementa el Model Context Protocol sobre transporte HTTP. Es compatible con las versiones actuales de clientes MCP, incluyendo Claude Code, Cursor, VS Code, OpenAI Codex, Google Antigravity y LM Studio. Debido a que la especificación MCP aún está evolucionando, confirma que tu cliente soporta transporte HTTP y la notificación tools/list_changed antes de conectarte.

Crear un Token MCP

Para conectar un cliente MCP, crea primero un token de acceso MCP.

1. Inicia sesión en el panel de API2Cart.
2. Abre Settings -> MCP.
3. Haz clic en Generate New Token.
4. Introduce una etiqueta para el token, por ejemplo local agent o Cursor workspace.
5. Selecciona la duración del token.
6. Opcionalmente, restringe el token por integraciones, métodos de API, IDs de conexión o la opción de ocultar claves de conexión.
7. Haz clic en Generate Token.
8. Copia el token y el endpoint.

El token se pasa al cliente MCP a través del encabezado HTTP:

Authorization: Bearer YOUR_MCP_TOKEN

El token MCP da acceso a las herramientas MCP de API2Cart dentro de los permisos seleccionados durante la generación del token.

Una cuenta puede tener hasta 5 tokens MCP activos. Los tokens caducados se eliminan automáticamente. La duración máxima del token es de 180 días.

Permisos del Token MCP

Se recomienda crear un token separado para cada cliente de IA o espacio de trabajo.

1. Allowed integrations - el agente solo ve las integraciones de comercio electrónico seleccionadas.
2. Allowed API methods - el agente solo puede llamar a los métodos habilitados.
3. Connection IDs - el agente solo puede trabajar con conexiones específicas.
4. Hide connection keys - el agente usa valores de id de conexión y no ve los valores sin procesar de store_key o connection_key.

Si un token está restringido a IDs de conexión específicos, el agente no puede añadir nuevas conexiones porque la nueva conexión aún no está en la lista blanca.

Si Hide connection keys está habilitado, las herramientas que cambian directamente las claves sin procesar a través de parámetros como new_store_key o new_connection_key pueden no estar disponibles para el agente.

Conectar un Cliente MCP

Para conectar un cliente MCP, sigue estos pasos:

1. Abre Settings -> MCP.
2. Busca el token requerido en la cuadrícula de tokens.
3. Haz clic en Connect.
4. Selecciona tu cliente MCP.
5. Copia el comando o la configuración generada.

Ejemplo para Claude Code:

claude mcp add --transport http api2cart https://mcp.api2cart.com/ --header "Authorization: Bearer YOUR_MCP_TOKEN"

Cómo Funciona la Sesión MCP

Después de que el cliente MCP se conecta, recibe automáticamente la guía de API2Cart y las herramientas disponibles. Los usuarios no necesitan ejecutar herramientas internas ni gestionar el conjunto de herramientas manualmente.

API2Cart almacena la integración seleccionada y la conexión activa en una sesión del lado del servidor. Cuando el agente cambia de integración o añade una nueva conexión, las herramientas disponibles se actualizan automáticamente. Algunos clientes MCP pueden necesitar unos segundos para mostrar el conjunto de herramientas actualizado.

Si el cliente pierde su contexto de conversación local, la sesión de API2Cart puede permanecer activa. El agente puede continuar trabajando con la conexión seleccionada. Para restaurar el contexto, proporciona el id de conexión; los valores sin procesar de store_key o connection_key no son necesarios para una conexión existente.

Trabajar con una Conexión Existente

Cuando le pides al agente que trabaje con una conexión que ya existe en API2Cart, encuentra las conexiones disponibles, identifica la integración relevante y selecciona la conexión:

find connection -> select integration -> select connection -> use platform tools

Después de seleccionar la conexión, el agente utiliza herramientas específicas de la integración, como herramientas de producto, pedido, categoría, cliente, envío, reembolso o webhook.

Si ya conoces el id de conexión, inclúyelo en tu solicitud. Esto permite al agente restaurar la conexión requerida sin pedir credenciales sin procesar.

Elegir la Integración Correcta

Una plataforma puede tener múltiples integraciones. Por ejemplo, WooCommerce puede estar disponible como integración basada en API y como integración basada en puente. Magento también puede tener opciones separadas basadas en API y basadas en puente.

Para elegir la integración correcta, el agente utiliza estos campos:

1. integration_id - identificador técnico para select_integration y add_connection.
2. name - nombre para mostrar.
3. connection_method - basada en API o basada en puente.
4. versions - versiones de plataforma compatibles.

Las conexiones basadas en API funcionan a través de la API de la plataforma y requieren credenciales de API. Las conexiones basadas en puente funcionan a través del puente o conector de API2Cart en el lado de la tienda y pueden requerir una clave de puente, acceso FTP/SSH o instalación de un plugin.

Si no está claro qué opción usar, pide al agente que compare las credenciales requeridas para las integraciones disponibles.

Añadir una Nueva Conexión

Cuando le pides al agente que añada una nueva conexión, identifica las integraciones disponibles, comprueba los parámetros requeridos y solo pide las credenciales necesarias para la plataforma seleccionada:

find integration -> check required parameters -> add connection -> verify connection

Después de una conexión exitosa, la nueva conexión se activa automáticamente y el agente verifica sus detalles. Si una plataforma tiene múltiples integraciones, puedes especificar el método de conexión preferido, como basado en API o basado en puente.

Tienda de Demostración Compartida

La tienda de demostración compartida puede ser visible en la lista de conexiones, pero no es accesible para llamadas a herramientas MCP. Si el agente selecciona una conexión de demostración, API2Cart MCP devuelve un error explícito. Para trabajo real, conecta tu propia tienda a través de add_connection o usa una conexión existente que no sea de demostración.

Ejemplos de Prompts

Exportación de productos:

Use API2Cart MCP. Work with connection id 12345 and get the first 10 products with id, name, sku, price, and image URLs only.

Verificación de pedidos:

Use API2Cart MCP. Work with my selected connection. Get orders updated during the last 24 hours. Return only order id, status, total, currency, customer email, and updated time.

Añadir una conexión:

Use API2Cart MCP. I want to connect a Shopify store. Show the required connection parameters first. Ask only for credentials that are required by the selected integration.

Recomendaciones de Seguridad

1. Crea tokens MCP separados para diferentes clientes o proyectos.
2. Usa una duración corta del token para pruebas.
3. Restringe el token a las integraciones y métodos requeridos cuando sea posible.
4. Usa la restricción de Connection IDs para cuentas sensibles en producción.
5. Habilita Hide connection keys si el agente de IA debe trabajar solo con IDs de conexión.
6. No pegues tokens MCP en chats, tickets, registros, capturas de pantalla o documentos compartidos.
7. Elimina los tokens que ya no se usen.

Revocar un Token MCP

Para revocar el acceso inmediatamente, abre Settings -> MCP, busca el token en la cuadrícula de tokens y elimínalo. La revocación tiene efecto inmediato: cualquier cliente MCP que use ese token pierde el acceso en su próxima solicitud, y las sesiones en caché vinculadas al token se invalidan.

Registros de Solicitudes MCP

API2Cart crea un registro de auditoría por cada solicitud HTTP al endpoint MCP. El registro incluye la hora de la solicitud, el nombre de la herramienta llamada, el estado de la respuesta y la duración de la ejecución.

Los registros de la cuenta están disponibles en el panel en Dashboard -> MCP Logs. Los registros están limitados a tu cuenta. Para investigar un problema, usa la hora de la solicitud y el nombre de la herramienta, luego comprueba el estado y la duración de la respuesta.

El valor de Authorization y las credenciales de add_connection se redactan antes del almacenamiento. El registro de auditoría MCP no almacena el cuerpo de la respuesta, por lo que ayuda a diagnosticar errores y solicitudes lentas, pero no es un archivo de respuestas API completas. Los registros más antiguos se eliminan automáticamente según la política de rotación de registros.

Solución de Problemas

El cliente está conectado, pero no se ven herramientas de API

Algunos clientes MCP necesitan unos segundos para mostrar un conjunto de herramientas actualizado. Si las herramientas no aparecen, pide al agente que actualice la sesión MCP o inicie un nuevo turno de cliente.

Faltan herramientas de producto o pedido

Comprueba que la integración correcta esté seleccionada y que el token MCP permita los métodos requeridos. Si el cliente se conectó recientemente, espera unos segundos para que el conjunto de herramientas se actualice.

La herramienta indica que un método está deshabilitado

El token MCP se generó con restricciones. Abre Settings -> MCP y edita los permisos del token, o crea un token que permita el método requerido.

El agente solicita store_key o connection_key

Proporciona el id de conexión o pide al agente que encuentre la conexión en tu cuenta de API2Cart. No proporciones claves sin procesar a menos que estés añadiendo intencionalmente una nueva conexión y la integración seleccionada las requiera.

La solicitud devuelve demasiados datos

Pide al agente que devuelva solo los campos requeridos, usa un count más pequeño o reduce el rango de fechas o filtros.

¡VE API2CART EN ACCIÓN!

Descubre cómo API2Cart puede facilitar tus integraciones de comercio electrónico con una demostración personalizada. Ve cómo nuestra solución puede conectar tu software con más de 70 plataformas de comercio electrónico sin problemas.

¡No te lo pierdas! Esta es una oferta exclusiva de una sola vez. Asegura tu período de prueba adicional reservando tu demostración ahora.

×