Cómo conectar EasyPost a Cursor vía MCP

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

EasyPost + Cursor

Deja que tu IA envíe con EasyPost: verifica direcciones, compara tarifas en tiempo real de tus transportistas, compra, convierte, asegura y reembolsa etiquetas, sigue paquetes, prepara declaraciones de aduana y crea scan forms. Las claves de prueba son gratuitas.

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:

EASYPOST_API_KEY

Paso 1 — Obtener credenciales

1. Crea una cuenta gratuita de EasyPost en https://app.easypost.com/signup. Antes de mostrar las claves de API, EasyPost te pide configurar el wallet y una dirección de remitente, y una cuenta nueva puede tener que completar primero una breve comprobación de seguridad con los datos de su empresa. Las claves aparecen cuando EasyPost la ha aceptado.
2. Abre la página de claves de API en https://app.easypost.com/account/settings?tab=api-keys (Account settings → API keys). Copia la clave Test (gratuita, las etiquetas no son válidas) o la clave Production (compra etiquetas reales).
3. Pégala en EASYPOST_API_KEY e instala el conector.
4. Ejecuta easypost_list_addresses para comprobar la clave. En una cuenta nueva la lista puede venir vacía.

Prueba o producción: lo decide la clave. Con una clave de prueba las etiquetas no cuestan nada y no son válidas, y el seguimiento solo acepta los códigos de prueba de EasyPost de EZ1000000001 a EZ7000000007, cada uno para un estado (pendiente de envío, entregado, devuelto al remitente, etc.). Para listar las cuentas de transportista conectadas (easypost_list_carrier_accounts) hace falta una clave de producción.

Comprar cuesta dinero, así que primero confirma: con una clave de producción, easypost_buy_shipment y easypost_insure_shipment cargan el importe al wallet de EasyPost al instante. Antes de comprar, la IA indica transportista, servicio, precio y ambas direcciones y espera tu sí. Un seguro añadido después de la compra cuesta el 1 por ciento del importe asegurado, como mínimo 1 USD. easypost_refund_shipment anula una etiqueta sin usar, que ya no debe utilizarse; el reembolso tarda de días a semanas (las etiquetas de USPS se pueden reembolsar en 30 días, las de UPS y FedEx en 90 días).

Cómo funciona un envío: easypost_create_shipment recibe el destinatario, la dirección de remitente y el paquete y devuelve tarifas en tiempo real de tus transportistas con precio y días de entrega. Eliges una tarifa con la IA, que compra la etiqueta con easypost_buy_shipment y obtiene el enlace a la etiqueta (PNG, o PDF y ZPL con easypost_convert_label), el número de seguimiento y una página de seguimiento pública. Sigue el paquete con easypost_get_tracker, o empieza a seguir cualquier número, también de etiquetas compradas en otro sitio, con easypost_create_tracker. La IA también puede verificar direcciones y crear scan forms, para que el transportista escanee una sola hoja en la recogida.

Unidades y envíos internacionales: pesos en onzas y medidas en pulgadas (1 kg son 35,27 oz, 1 cm son 0,394 in), importes en USD salvo que se indique otra moneda. Para un envío internacional, la IA crea primero las partidas aduaneras y una declaración de aduana y la adjunta al envío.

Errores comunes: 401 UNAUTHORIZED o 403 APIKEY.INACTIVE: la clave falta, es incorrecta o está desactivada. 403 MODE.UNAUTHORIZED: la llamada necesita una clave de producción. 402 PAYMENT_REQUIRED: el wallet no tiene fondos. Los errores 422 como ADDRESS.VERIFY.FAILURE, SHIPMENT.POSTAGE.FAILURE o SHIPMENT.CUSTOMS_INFO.REQUIRED indican el problema con la dirección, la compra o los datos de aduana que faltan. 429: demasiadas solicitudes, espera y vuelve a intentarlo.

El conector no gestiona recogidas, pedidos, devoluciones, webhooks, usuarios y claves de API, informes ni la conexión de 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 Cursor

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.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de EasyPost.

Herramientas disponibles

Ejemplos de prompts

• "Compara las tarifas para un paquete de 3 lb y 12 x 10 x 6 pulgadas desde nuestro almacén a esta dirección de Chicago y muéstrame la opción más barata y la más rápida."
• "¿Dónde está el paquete con el número de seguimiento 1Z999AA10123456784 y cuándo debería llegar?"
• "Revisa esta dirección del cliente y dime si hay algo que corregir antes de enviar."
• "Compra la etiqueta de ese envío con la tarifa de USPS más barata, pero muéstrame antes transportista, servicio, precio y ambas direcciones."

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT