Prepara una carta para enviarla por correo con Grok e IRIS

Elige la vía de conexión con Grok

Este flujo de trabajo se refiere al producto de conversación Grok en grok.com. xAI documenta los conectores MCP personalizados en Grok Connectors: ve a grok.com/connectors, elige New Connector y Custom, ingresa la URL del servidor y completa el flujo de autenticación compatible. En Grok Business o Enterprise, un administrador debe configurar primero el conector en la consola del equipo en la nube. Agregas IRIS como un conector personalizado; no es uno de los conectores integrados de xAI.

La API para desarrolladores de xAI en api.x.ai es una vía diferente para crear tu propia aplicación con modelos de Grok. Una clave de API de xAI no es una clave de API de IRIS; tu aplicación llama a IRIS con su propia clave. Para una carta ocasional, deja que Grok la redacte, exporta y revisa un PDF final de tamaño carta de EE. UU. y súbelo en /letters/send de IRIS. No necesitas un conector, y una página en blanco y negro cuesta $3.20 con franqueo incluido.

• xAI: Conectores de Grok
• xAI: Administración de conectores de Grok Business y Enterprise
• IRIS: Subir y enviar por correo postal un PDF revisado

Conecta solo un servidor accesible y con los permisos adecuados

IRIS documenta https://api.irispostalforms.com/mcp como un endpoint remoto de Streamable HTTP. Cada solicitud MCP necesita una clave de API de IRIS de tipo bearer vinculada a una cuenta y con el permiso account:read. La preparación también necesita documents:write para las solicitudes de carga y el registro, y mailings:read para las cotizaciones. No otorgues mailings:write a un conector de preparación: ese permiso adicional permite usar create-mailing, que cobra créditos y da inicio al procesamiento del envío.

xAI exige que los servidores de Grok puedan acceder a un servidor MCP personalizado a través de la internet pública. El endpoint HTTPS publicado de IRIS es la URL del servidor, por lo que no se necesita un túnel local. Completa la autenticación mediante un flujo de conexión que admita la credencial Authorization: Bearer requerida y verifica el método de autenticación que ofrece tu cuenta de Grok antes de continuar. Si no admite encabezados bearer, usa una puerta de enlace autenticada aprobada por tu organización o la API REST de IRIS. Mantén la clave de API fuera de las URL, las instrucciones del chat, el código del navegador y las capturas de pantalla.

• IRIS: Autenticación MCP y permisos de las herramientas
• xAI: Accesibilidad de servidores MCP personalizados
• Consultar los requisitos comunes de MCP para correo postal físico

Transfiere el PDF terminado con código local de confianza

Termina la carta con datos verificados y exporta un PDF legible, sin cifrar y de tamaño carta de EE. UU. Abre el archivo final e inspecciona cada página. La conversación de Grok o un resultado de create-document-upload de MCP no transfieren, por sí solos, los bytes de un PDF local a IRIS. Desde un software de confianza con acceso al archivo, solicita una carga privada usando el nombre exacto del archivo, su longitud en bytes y el valor letter para kind; envía esos bytes mediante PUT a la uploadUrl devuelta antes de que venza, con todos los valores de uploadHeaders devueltos; verifica que PUT se haya completado correctamente; luego registra la key devuelta y guarda el ID inmutable del documento. No envíes la clave bearer de IRIS a la URL de carga del almacenamiento y mantén privada la URL prefirmada.

Esta transferencia local puede usar REST de IRIS aunque Grok utilice después la herramienta quote-mailing de MCP. Proporciona a Grok únicamente el ID del documento registrado y los datos mínimos aprobados de direcciones y opciones necesarios para solicitar una cotización. Un PDF revisado es un documento diferente: súbelo, regístralo, solicita una cotización y revísalo de nuevo en lugar de reutilizar un ID de documento o una aprobación anteriores.

• IRIS: Cargas privadas de PDF y registro
• IRIS: Contrato OpenAPI

Pide a Grok una cotización y luego detente

Proporciona las direcciones completas del remitente y del destinatario obtenidas de tus registros oficiales, el ID del documento registrado y las opciones explícitas de la carta. quote-mailing de IRIS recibe un objeto de envío completo y requiere mailings:read. Devuelve un precio en centavos de dólar estadounidense; una cotización no gasta créditos, no reserva ese precio ni tramita un envío postal. La siguiente instrucción sirve para la preparación después de cargar el PDF mediante un proceso de confianza; no es una orden para leer un archivo local ni crear un pedido.

Use the IRIS connector only to prepare one US letter mailing.
The final PDF has already been uploaded and registered by my trusted local workflow; its document ID is [REGISTERED_DOCUMENT_ID].
Use only the sender, recipient and letter options I explicitly provide. Do not invent or complete missing address fields.
Check the account balance and request a quote for the complete mailing object.
Show the document ID, both full addresses, all print options and quoted total in US cents for my review.
Do not call create-mailing, submit an order, or claim the letter has been sent. Stop and ask for human review.

• IRIS: Herramientas MCP y cotización

Haz que el envío postal de pago sea una decisión humana independiente

Antes de tramitar el pedido, una persona abre el PDF real (no solo el resumen de Grok) y verifica cada página, las direcciones del remitente y del destinatario, las opciones de impresión, la cotización actual y la autorización para enviar. Confirma los créditos disponibles y corrige cualquier discrepancia; obtén una nueva cotización si cambian los datos de la solicitud o si se retrasa su envío.

Después de la aprobación, un flujo de trabajo de confianza para tramitar pedidos con mailings:write crea el envío postal usando exactamente los datos aprobados y una única clave de idempotencia guardada de forma persistente para esa carta específica. Conserva el ID del pedido resultante; si una respuesta es incierta, vuelve a intentarlo con la misma clave y los mismos datos, sin cambios, en lugar de generar otra clave, y consulta el estado usando el ID del pedido. IRIS imprime la carta y la entrega a USPS First-Class Mail; USPS indica un plazo de 1–5 días hábiles una vez que la carta está en el correo. Excluir mailings:write del conector de preparación hace que el paso de revisión sea efectivo.

• IRIS: Revisión humana y tramitación del pedido
• Gestionar respuestas inciertas sin duplicar cartas