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.

¿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 ChatGPT y activa Developer mode.
2. Añade un servidor MCP remoto en la URL de producción 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.

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

La configuración remota preferida de WorkBuddy es OAuth en el navegador. Configura solo:

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

No añadas Authorization, Client ID ni Client Secret. Un cliente compatible abre el navegador automáticamente. Inicia sesión, selecciona una clave activa y confirma, o pulsa explícitamente Crear y autorizar. Si solo hay una clave, aparece preseleccionada, pero también debes confirmar. WorkBuddy no recibe el valor de la clave.

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.

Si la configuración antigua tiene una cabecera Authorization fija, OAuth no se iniciará. Elimina solo esa cabecera de este servicio y vuelve a conectar. Si hace falta, borra únicamente la caché de autorización de esta conexión. No borres las cachés de otros MCP.

Alternativa directa por clave API

Úsala solo si el cliente no ofrece OAuth en el navegador:

{
  "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

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.