Cómo conectar Orderful a Gemini — via MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Orderful, pega tus credenciales, genera una MCP API key — listo. Sin Docker, sin git clone, sin servidor local.

Orderful + Gemini

Plataforma EDI Orderful: lista y lee transacciones EDI (pedidos de compra, confirmaciones, avisos de envío, facturas, avisos de inventario) en ambas direcciones, lee su contenido, gestiona una bandeja de entregas entrantes, acepta o rechaza entregas, confirma transacciones, envía nuevas transacciones y lista las relaciones con socios comerciales.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

ORDERFUL_API_URL, ORDERFUL_API_KEY

Paso 1 — Obtener credenciales

1. Inicia sesión en ui.orderful.com (EE. UU.) o ui-eu.orderful.com (UE).
2. Haz clic en tu avatar, luego en Settings → Organization Settings → API Credentials, y copia el API Token en ORDERFUL_API_KEY. Se envía en la cabecera orderful-api-key.
3. Pon en ORDERFUL_API_URL tu región, sin barra final: https://api.orderful.com (EE. UU.) o https://api-eu.orderful.com (UE). Los datos no se comparten entre regiones; un token de EE. UU. no funciona en el host de la UE.
4. Llama a orderful_get_organization para comprobar el token y ver tus cuentas EDI (ISA ids), y después a orderful_list_transactions, filtrando por direction, simplified_transaction_type (PURCHASE_ORDER, INVOICE, SHIP_NOTICE...), stream o business_number.

Recepción: lee la bandeja del Inbound Poller con orderful_list_inbox_transactions (el id de la bandeja está en la interfaz de Orderful, en Communication Channels), procesa cada documento y luego llama a orderful_accept_delivery, o a orderful_fail_delivery con una nota. En las relaciones JSON envía también orderful_acknowledge_transaction, una vez por transacción; las relaciones X12 y EDIFACT confirman con un 997.

Envío: orderful_create_transaction envía un 850, 855, 856, 810, 846 o 860 en el Mosaic JSON de Orderful. Usa stream: test hasta que la relación esté en producción: una transacción live llega al socio comercial. Revisa validationStatus en el resultado; las transacciones INVALID no se entregan.

Paginación: hasta 100 transacciones por página; para la siguiente, pasa el valor nextCursor de metadata.pagination.links.next.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Orderful.

Herramientas disponibles

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse