Envía documentos por correo con Claude Code y el servidor MCP de IRIS

Prepara la cuenta y el documento local

Comienza con una cuenta de desarrollador de IRIS verificada con créditos prepagados y un PDF final de tamaño carta estadounidense (US Letter) que tu empresa esté autorizada a enviar por correo postal. Para la preparación, usa una clave con los permisos account:read, documents:write y mailings:read. El envío del pedido requiere además mailings:write y créditos suficientes para el pedido. Excluir el permiso de escritura de una clave destinada únicamente a la preparación establece un límite claro para esa clave.

Esta guía paso a paso es para Claude Code, donde una herramienta local puede leer un PDF y transferir sus bytes. Los conectores de Claude para la web o el escritorio pueden usar un flujo de autenticación o de acceso a archivos diferente, así que consulta la documentación de IRIS correspondiente al cliente que uses.

• Documentación de la API de IRIS y límites actuales

Conecta el endpoint de MCP con autenticación

Anthropic documenta las conexiones HTTP de MCP y la expansión de variables de entorno en .mcp.json. Integra la siguiente entrada en la configuración de tu proyecto y proporciona IRIS_API_KEY al entorno que inicia Claude Code. El archivo contiene una referencia a una variable, no tu credencial real. Revisa la configuración del servidor cuando Claude te pida que confirmes que confías en él.

Abre /mcp en Claude Code para inspeccionar la conexión. Un valor de entorno ausente, una clave revocada o la falta del permiso account:read impedirán que la sesión sea útil. Mantén las credenciales reales fuera de las instrucciones, las capturas de pantalla, el control de versiones y los registros compartidos.

{
  "mcpServers": {
    "iris": {
      "type": "http",
      "url": "https://api.irispostalforms.com/mcp",
      "headers": {
        "Authorization": "Bearer ${IRIS_API_KEY}"
      }
    }
  }
}

• Anthropic: conecta Claude Code a MCP
• Consulta los requisitos de MCP independientes del cliente

Usa las herramientas en el orden correcto

IRIS ofrece seis herramientas de servidor. La carga de un archivo local es una operación aparte que se realiza entre la segunda y la tercera herramienta de la lista siguiente: tu código local de confianza debe enviar los bytes reales mediante PUT a la URL de almacenamiento devuelta, usando uploadHeaders. Que se devuelva una URL de carga no demuestra que el archivo haya llegado.

Asigna a Claude una tarea de preparación con un punto de detención claro

La siguiente es una instrucción de ejemplo para un documento cuyo procesamiento ya aprobaste. Reemplaza el nombre del archivo y proporciona las direcciones reales mediante tu flujo de trabajo de confianza. La instrucción está diseñada para detenerse antes de crear un pedido.

Prepare letter.pdf for one IRIS mailing.
Use the sender and recipient I supplied; do not infer addresses.
Upload the PDF privately and register the exact file.
Quote a black-and-white, double-sided letter.
Show me the document ID, PDF, addresses, options, and price.
Stop before create-mailing. Ask me to review the complete mailing.

Aprueba el documento y luego guarda el comprobante

Abre el PDF real y revisa cada página. Confirma que los datos del destinatario estén actualizados, que el contenido sea correcto y que el precio y la opción de envío postal sean adecuados para la tarea. Si Claude modifica el documento después de la revisión, registra el nuevo PDF y vuelve a revisarlo. La aprobación de un borrador anterior no debe extenderse a un archivo modificado.

Para enviar el pedido, guarda de forma persistente una idempotencyKey junto con el envío postal aprobado. Guarda de inmediato el orderId devuelto. Si se pierde la respuesta, vuelve a intentar la misma operación con la misma clave y los mismos datos; crear una clave nueva puede generar otra carta de pago. Una respuesta que indica que el pedido está pagado significa que existe un pedido, no que USPS lo haya entregado. Usa get-mailing-status para el siguiente paso operativo.

• Gestiona los reintentos sin duplicar cartas