Cómo conectar Shippo a Gemini vía MCP

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

Shippo + Gemini

Deja que tu IA gestione los envíos con Shippo: valida direcciones, compara tarifas en tiempo real de tus transportistas, compra y reembolsa etiquetas, rastrea paquetes, prepara la documentación de aduanas y crea scan forms. El modo de prueba es gratuito.

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:

SHIPPO_API_TOKEN

Paso 1 — Obtener credenciales

1. Regístrate gratis en apps.goshippo.com/join, abre después el portal de la API en portal.goshippo.com/api-config/api y ve a API Configuration → Developer keys.
2. Haz clic en Create new test key para probarlo todo gratis, o en Create new live key para comprar etiquetas reales. Copia la clave en ese momento: Shippo solo la muestra una vez. Las claves de prueba empiezan por shippo_test_ y las reales por shippo_live_.
3. Pega la clave en SHIPPO_API_TOKEN tal como aparece, sin la palabra ShippoToken, e instala el conector.
4. Empieza con shippo_list_carrier_accounts: debería mostrar las cuentas de transportista propias de Shippo (por ejemplo USPS), listas para usar en EE. UU., junto con los nombres de transportista que espera shippo_get_tracking.

Prueba o real: lo decide la clave. Con una clave de prueba las etiquetas son gratis y llevan la marca de agua "SAMPLE - DO NOT MAIL", los números de seguimiento nunca se actualizan, los reembolsos siempre salen bien y los manifiestos (scan forms) no están disponibles. Una clave de prueba solo ve datos de prueba y una clave real solo datos reales. Las cuentas de transportista que conectes en Shippo con tus propias credenciales del transportista solo funcionan en el modo en que se añadieron.

Comprar una etiqueta cuesta dinero: con una clave real, shippo_buy_label carga al instante el precio de la etiqueta (más el seguro, si lo hay) en tu cuenta de Shippo, así que la IA indica antes transportista, servicio, precio y ambas direcciones y espera tu confirmación. shippo_create_shipment solo consulta tarifas en tiempo real y no compra nada. El enlace a la etiqueta caduca al cabo de un tiempo; shippo_get_label devuelve uno nuevo. shippo_request_refund anula una etiqueta, que ya no se podrá usar, y pide al transportista que devuelva el importe. Solo valen etiquetas sin usar de hasta 90 días, y el reembolso tarda de días a semanas.

Permisos y solo lectura: una clave puede hacer todo lo que puede hacer tu cuenta de Shippo. Para una configuración que nunca gaste dinero ni anule etiquetas, desactiva shippo_buy_label, shippo_request_refund y shippo_create_manifest. La IA podrá seguir validando direcciones, comparando tarifas, rastreando paquetes y consultando etiquetas anteriores.

Envíos internacionales: necesitan una declaración de aduanas. La IA crea una línea por producto con shippo_create_customs_item (descripción, cantidad, peso neto, valor, país de origen, código arancelario), después shippo_create_customs_declaration con una persona que certifica los datos, y la adjunta al envío. Ten a mano los códigos arancelarios y los valores de tus productos.

Validación de direcciones: shippo_validate_address guarda la dirección comprobada y normalizada (por ejemplo con el código ZIP+4) como una dirección nueva y deja la original como estaba; los envíos van después a la nueva. Con una clave de prueba, las direcciones fuera de EE. UU. vuelven sin comprobar; con una clave real, validarlas tiene coste.

Límites: por minuto Shippo permite 500 creaciones y 4.000 lecturas de objetos sueltos, pero solo 50 consultas de listas (10 con una clave de prueba). Si se supera un límite, Shippo responde 429: espera un minuto y vuelve a intentarlo.

Errores frecuentes: 401 Token does not exist significa que la clave es incorrecta o se eliminó: crea una nueva en API Configuration → Developer keys y pégala sin la palabra ShippoToken. 400 indica el campo que falta o no es válido, por ejemplo una dirección que el transportista rechaza. 422, o una etiqueta con estado ERROR, significa que el transportista la rechazó, por ejemplo porque el servicio no cubre esa ruta o faltan datos de aduanas; los mensajes explican el motivo. Una etiqueta o un reembolso con estado QUEUED o WAITING todavía se está procesando: vuelve a consultarlo unos segundos después.

El conector no gestiona lotes, pedidos, recogidas, webhooks distintos del registro de seguimiento ni la conexión de tus propias cuentas de transportista.

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 Shippo.

Herramientas disponibles

Ejemplos de prompts

• "Compara las tarifas de UPS y USPS para un paquete de 2 kg (30 x 20 x 15 cm) desde nuestra dirección de almacén guardada hasta 350 5th Ave, New York, NY 10118, y muéstrame la opción más barata y la más rápida."
• "¿Dónde está ahora el paquete con el número de seguimiento de USPS 9400111899223197428490 y cuándo se espera que llegue?"
• "Compra la etiqueta de USPS más barata para el pedido de Acme Ltd con destino 233 S Wacker Dr, Chicago, IL 60606, y dame el número de seguimiento y el enlace a la etiqueta."
• "Prepara la documentación de aduanas para 3 tazas de cerámica por un valor total de 45 USD para un cliente en Toronto, Canadá, y luego muéstrame las tarifas 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