La respuesta breve
IRIS ofrece un servidor MCP autenticado para envíos postales físicos individuales dentro de EE. UU. en https://api.irispostalforms.com/mcp. Usa un cliente compatible con Streamable HTTP remoto y encabezados bearer, inicializa la conexión y descubre sus herramientas. El servidor prepara una carga, registra un PDF, cotiza un envío, presenta un pedido pagado previamente revisado con cargo a tus créditos prepagados y consulta el estado; tu código de confianza transfiere los bytes del PDF y mantiene el paso de aprobación humana antes de presentar el pedido.
Verifica el endpoint, el transporte y el cliente antes de conectarte
Un servidor MCP de correo postal es un endpoint de herramientas al que un cliente compatible llama en nombre de tu cuenta. La documentación de IRIS es la fuente oficial de la URL del servidor: https://api.irispostalforms.com/mcp. Usa ese endpoint exacto, no el origen de la API REST ni la URL del sitio web.
Tu cliente debe ser compatible con Streamable HTTP remoto autenticado, enviar una clave de API de IRIS mediante Authorization: Bearer y negociar la conexión MCP. Las solicitudes de Streamable HTTP indican application/json y text/event-stream en Accept. Sigue el procedimiento documentado de tu cliente para proporcionar la URL y el secreto; la sintaxis de configuración y la compatibilidad con encabezados personalizados varían. Inicializa la conexión y usa el descubrimiento de herramientas de MCP para ver las herramientas disponibles, en lugar de suponer que pegar una instrucción o usar un conector stdio local ha establecido el acceso.
Los resultados de las herramientas contienen JSON serializado dentro del contenido de texto de MCP; no usan la estructura envolvente de respuesta data de la API REST. Un cliente conectado también necesita una forma confiable de acceder al PDF final y transferirlo, porque el servidor MCP remoto no puede leer cualquier archivo de tu computadora.
Descubre seis herramientas y separa la preparación del gasto
Cada solicitud MCP de IRIS requiere account:read. Una credencial de preparación puede agregar documents:write para solicitar y registrar una carga, y mailings:read para cotizar y consultar el estado. Solo el componente autorizado para presentar un envío pagado aprobado necesita mailings:write. Un cliente que permite acceder a todas las herramientas mediante una clave con permisos amplios hace que una llamada errónea o manipulada tenga consecuencias más graves; una clave exclusiva para preparación no puede crear un envío.
Usa los esquemas de entrada descubiertos en lugar de adivinar los nombres de los campos. Las herramientas de cotización y presentación reciben un objeto de envío completo con un ID de documento registrado, las direcciones completas del remitente y del destinatario, y las opciones de impresión correspondientes. create-mailing también requiere un idempotencyKey. Guarda las claves de API en un almacenamiento de secretos de confianza, no en una instrucción compartida, un paquete de código para el navegador, un PDF, una captura de pantalla ni un repositorio.
| Herramienta | Propósito | Permiso adicional |
|---|---|---|
| get-account-balance | Consultar los créditos prepagados disponibles. | Ninguno |
| create-document-upload | Solicitar una URL privada y temporal para cargar un PDF. | documents:write |
| register-document | Validar el PDF transferido y obtener su ID de documento inmutable. | documents:write |
| quote-mailing | Calcular el precio de un objeto de envío completo. | mailings:read |
| create-mailing | Crear un pedido pagado después de la revisión. | mailings:write |
| get-mailing-status | Consultar el estado actual de un pedido existente. | mailings:read |
Transfiere los bytes del PDF por la vía de carga de confianza
La herramienta create-document-upload devuelve un uploadUrl temporal, uploadHeaders y una clave de almacenamiento. Esa herramienta no carga el PDF por sí misma. En tu código de confianza, ya sea local o del lado del servidor, envía mediante PUT los bytes exactos del PDF aprobado a esa URL antes de llamar a register-document con la clave devuelta, fileName y kind. Envía todos los valores de uploadHeaders devueltos, incluido If-None-Match cuando se proporcione; no envíes la clave bearer de IRIS a la URL de almacenamiento. Comprueba que el PUT se haya completado correctamente, luego registra el documento y conserva su ID de documento y su huella digital. La clave de almacenamiento no es un ID de documento, y una URL prefirmada no demuestra que la carga se haya completado.
Trata tanto el PDF como la URL prefirmada como información confidencial. Limita quién puede ver la URL, úsala antes de que venza y no le pidas a una herramienta de modelo que no sea de confianza que acceda a cualquier URL devuelta usando tus credenciales. Un PDF modificado requiere una nueva carga, registro y revisión; la aprobación del documento anterior no autoriza una versión revisada. Consulta los límites documentados de tamaño, páginas y dimensiones del PDF antes de crear un flujo de trabajo para una pieza postal específica.
Establece una revisión obligatoria entre la cotización y el pedido pagado
Llama a quote-mailing con el ID del documento registrado, el remitente, el destinatario y las opciones de envío. Una cotización calcula un precio; no reserva ese precio, no gasta créditos ni envía nada por correo. Muéstrale a una persona el PDF final real, ambas direcciones completas, las opciones de impresión, la cotización actual, el propósito y la autorización para enviar. Si el documento o los datos de la solicitud cambian, vuelve a cotizar y revisar. Al presentar el pedido, se recalcula el precio, así que actualiza una cotización desactualizada y devuelve cualquier importe modificado a quien realiza la revisión, en lugar de considerar garantizada una estimación anterior.
Después de esa revisión, la lógica de la aplicación de confianza permite llamar a create-mailing con el objeto de envío aprobado y un único idempotencyKey persistente para esa carta prevista. Guarda la clave y los datos de la solicitud de forma persistente antes del primer intento y conserva el orderId devuelto. Si se pierde una respuesta, vuelve a intentarlo con la misma clave y los mismos datos sin modificar; una clave nueva puede crear otra carta pagada, mientras que cambiar los datos con la clave anterior genera un conflicto. Una confirmación de pago significa que existe un pedido. Usa get-mailing-status con orderId para consultar el estado y cualquier información de seguimiento disponible. 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.
Una lista de verificación de conexión y seguridad independiente del cliente
Independientemente del servidor MCP que conectes para enviar correo postal, verifica su operador, transporte, autenticación, herramientas, permisos de gasto y vía de transferencia de documentos. La configuración específica de cada cliente corresponde a la documentación de ese cliente; la siguiente lista se aplica tanto si tu cliente es un asistente de programación como si es una aplicación personalizada.
No permitas que las instrucciones incluidas en un PDF, una página recuperada o una respuesta de herramienta cambien el destino aprobado o autoricen la presentación del pedido. Una descripción de herramienta que indique que una persona debe revisar es una orientación útil, no un mecanismo que garantice su cumplimiento. Coloca el control de aprobación en código de confianza o en un proceso controlado equivalente, y verifica los resultados inciertos de los pedidos en lugar de enviar automáticamente una carta de reemplazo.
- Verifica que el endpoint oficial sea https://api.irispostalforms.com/mcp y que el cliente sea compatible con Streamable HTTP remoto autenticado con encabezados bearer.
- Crea una clave con permisos limitados a la etapa que estás implementando; excluye mailings:write de una conexión exclusiva para preparación y nunca expongas la clave a contenido que no sea de confianza.
- Inicializa MCP y descubre las herramientas y los esquemas reales. Confirma que se pueda acceder a las herramientas de preparación antes de crear un envío.
- Prepara el PDF final en un entorno de confianza; solicita una URL de carga, envía los bytes mediante PUT con todos los encabezados de carga devueltos, comprueba que se haya completado correctamente y luego registra y guarda el ID del documento.
- Cotiza el envío exacto y muestra el PDF real, las direcciones, las opciones, el precio y la intención a una persona autorizada; detente si algo cambia o no se puede verificar.
- Presenta únicamente los datos aprobados con una clave de idempotencia guardada a través de una vía autorizada; conserva el ID del pedido, vuelve a intentar las solicitudes de resultado incierto con la misma clave y los mismos datos, y consulta el estado en lugar de realizar otro pedido.
Fuentes y lecturas adicionales
- Documentación de la API de IRIS: MCP, cargas, revisión y estado
- Model Context Protocol: transporte Streamable HTTP
Publicado por IRIS Postal Forms, operado por Great Lakes Computing Office LLC. ¿Encontraste información desactualizada? Envía una corrección.