Configuración de plataformas MCP

Endpoint de producción:

https://ecommercedataapi.com/mcp

Este endpoint usa Streamable HTTP y ofrece 49 herramientas: 45 de negocio individuales y las 4 genéricas originales, además de 1 MCP Prompt. Los nombres de negocio se derivan de las URL canónicas, por ejemplo amazon_asin_detail y amazon_asin_competitor. La carga de archivos OCR sigue siendo solo REST.

La vía más rápida: envía tu clave API y esta página a la IA

Si tu agente puede editar su propia configuración MCP (por ejemplo WorkBuddy, Claude Code, Cursor, Codex o Hermes), no necesitas editar archivos de configuración. Copia la clave completa en la página de claves API, colócala en la plantilla de abajo y envía el mensaje completo. Con la clave y el enlace a la documentación en un solo mensaje, la IA puede escribir la configuración sin detenerse a pedirte la clave.

Añade Ecommerce Data API como servidor MCP en la configuración MCP de tu cliente actual.
Documentación: https://ecommercedataapi.com/es/docs/mcp-platforms
Mi clave API: <pega aquí tu clave API>

Requisitos:
1. Usa el método de clave API directa de la documentación: transporte Streamable HTTP, URL https://ecommercedataapi.com/mcp, cabecera Authorization: Bearer <la clave de arriba> (un espacio ASCII después de Bearer).
2. Añade solo un servidor llamado ecommerce-data-api y conserva el resto de configuraciones MCP. No pongas la clave en la URL.
3. No repitas la clave completa en tu respuesta.
4. Al terminar, dime si debo reiniciar o reconectar. Una vez conectado, usa ecommerce_account para consultar mis créditos restantes. No llames todavía a APIs de datos de pago.

La clave queda en el historial de este chat. Crea una clave exclusiva para clientes de IA y restablécela o elimínala en la página de claves API cuando ya no la necesites. En ChatGPT web la IA no puede editar la configuración; usa los pasos de OAuth de abajo.

¿Qué conexión elegir?

Los clientes OAuth deben admitir OAuth 2.1 con PKCE S256. Un cliente que solo acepte un Bearer Token fijo puede usar el acceso directo por clave API como alternativa.

ChatGPT web

1. Abre los ajustes de plugins de ChatGPT en chatgpt.com/settings/plugins-settings y cambia Default permissions a Allow low-risk tools. Después abre chatgpt.com/plugins, pulsa Add y elige Add custom MCP server.
2. Introduce la URL de producción como URL del servidor y selecciona OAuth.
3. Inicia sesión en Ecommerce Data API.
4. Selecciona una clave activa y confirma, o elige explícitamente Crear y autorizar. Una única clave aparece preseleccionada, pero también requiere confirmación.
5. Vuelve a ChatGPT, abre una conversación nueva y pide: Usa ecommerce_account para consultar mis créditos. No llames todavía a las API de datos de pago.

Cliente ChatGPT: conexión directa con clave API en Plugins

Si el cliente muestra Ajustes → Plugins → MCP:

1. Pulsa Añadir → Añadir servidor MCP, selecciona Streamable HTTP y escribe Ecommerce Data API como nombre.
2. Introduce https://ecommercedataapi.com/mcp como URL.
3. En Encabezados, añade la clave Authorization y el valor Bearer <TU_CLAVE_API>. Deja un espacio entre Bearer y la clave; deja vacío el campo de variable de entorno del token Bearer.
4. Guarda y activa el servidor. En una conversación nueva, usa la consulta de créditos anterior para comprobar que ecommerce_account está disponible.

Este método guarda la clave API original en el cliente y no inicia OAuth en el navegador. No incluyas la clave en URL, capturas ni archivos de configuración compartidos. Restablece o elimina la clave para detener el acceso directo.

Hermes

Añade un servidor remoto, selecciona Streamable HTTP, introduce el endpoint y, cuando esté disponible, elige OAuth / autorización en el navegador. Inicia sesión, selecciona o crea y autoriza una clave, confirma y actualiza la conexión.

Si Hermes solo ofrece un campo Bearer Token fijo, usa la alternativa por clave API. La compatibilidad del protocolo no demuestra que el flujo OAuth se haya probado en una versión concreta de Hermes.

WorkBuddy

Usa el acceso directo por clave API para WorkBuddy. Lo más sencillo es enviar a WorkBuddy la plantilla de arriba, con tu clave y esta página, para que escriba la configuración. También puedes configurarlo a mano con estos pasos.

La configuración de usuario está en ~/.workbuddy/mcp.json; en Windows, en %USERPROFILE%\\.workbuddy\\mcp.json; la configuración del proyecto está en .workbuddy/mcp.json. Añade solo esta entrada a mcpServers y conserva los demás MCP.

Alternativa directa por clave API

1. Crea una clave en la página de claves API o copia una clave completa existente.
2. Sustituye YOUR_API_KEY por tu clave. Deja un espacio entre Bearer y la clave.
3. Guarda la configuración y activa o vuelve a conectar este servidor MCP en WorkBuddy.

{
  "mcpServers": {
    "ecommerce-data-api": {
      "type": "http",
      "url": "https://ecommercedataapi.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

No pongas la clave en la URL. Este modo guarda el valor de la clave en el cliente y no crea una conexión OAuth en el navegador.

Después de conectar, comprueba herramientas como amazon_asin_detail y ecommerce_api_search, ecommerce_api_describe, ecommerce_api_call y ecommerce_account. El Prompt conservado se llama ecommerce-data-api, tiene el título Ecommerce Data API y un argumento opcional task de hasta 4,000 caracteres. Seleccionarlo solo carga instrucciones: no consulta datos ni consume créditos. El menú de comandos depende del cliente; las solicitudes en lenguaje natural siguen disponibles.

Claude Code remoto OAuth

Instala el plugin desde Claude Code. Añade este servidor MCP y la Agent Skill a la vez:

/plugin install ecommerce-data-api --marketplace ecommercedataapi/ecommerce-data-api

Para añadir solo el servidor MCP:

claude mcp add --transport http ecommerce-data-api https://ecommercedataapi.com/mcp

Abre /mcp, elige la autorización en el navegador, inicia sesión, selecciona o crea y autoriza una clave, confirma y vuelve a Claude Code.

Claude Code local stdio

El instalador y la conexión stdio local siguen usando una clave API, no OAuth:

curl -fsSL https://ecommercedataapi.com/install.sh | bash -s -- --yes --only claude-code

Introduce la clave en el prompt local del instalador. Usa CLI 0.2.2 o posterior y ejecuta ecomdata doctor y ecomdata mcp status. Los usuarios de URL remota no necesitan la CLI.

Créditos y ciclo de vida de la clave

MCP y REST comparten el saldo. Un mensaje puede generar varias consultas facturables. Las claves no tienen presupuestos, permisos ni límites de velocidad independientes. Restablecer, eliminar o dejar caducar la clave seleccionada invalida el acceso; cambiar la clave OAuth requiere una nueva autorización.

Revocar una conexión MCP no elimina ni desactiva la clave REST ni detiene el acceso directo. Para detenerlo, restablece o elimina la clave. Las solicitudes de pago fallidas no se reintentan automáticamente.

Consulta las guías oficiales de WorkBuddy: conectores y MCP.