SendLettersOnline.co.uk

npx add-mcp 'https://sendlettersonline.co.uk/api/mcp'

Un servidor MCP. Para cartas de verdad.

El servidor MCP de Send Letters Online conecta asistentes de IA compatibles con la impresión y el envío de cartas físicas. Un asistente puede consultar tu saldo, revisar pedidos, previsualizar el precio de una carta y enviar un pedido pagado usando tu cuenta habilitada. Revisa el borrador, el destinatario y el total cotizado en tu asistente antes de autorizarlo a enviar.

Gestionar el acceso del asistente Ver las opciones de configuración

¿Qué es un servidor MCP para enviar cartas?

El Model Context Protocol (MCP) es una forma en que un asistente puede llamar a herramientas proporcionadas por otro servicio. Send Letters Online expone herramientas para tu saldo, pedidos de cartas y precios. El asistente prepara el texto; el servicio de cartas realiza la operación de impresión y envío pagada tras recibir los campos de confirmación requeridos.

• Guía oficial del servidor remoto MCP
• Flujos de trabajo para cartas comerciales

¿Cómo envío una carta física a través de un asistente?

Indica a tu asistente conectado para quién es la carta y qué debe decir. Revisa tú mismo el borrador completo y la dirección postal. Solicita una previsualización del precio para el documento, las opciones de impresión y el servicio postal, y luego aprueba explícitamente el pedido previsto en tu cliente.

Tras un pedido confirmado, la carta se imprime, se dobla, se introduce en un sobre y se envía. Usa get_order o tu panel para seguir su progreso. No asumas que un asistente que dice "enviado" es prueba de envío o entrega.

• Conecta tu cuenta habilitada usando un método de autenticación compatible.
• Redacta y revisa el contenido completo y la dirección del destinatario.
• Previsualiza el precio actual sin hacer un pedido.
• Autoriza la carta específica y el total en tu cliente.
• Comprueba el pedido resultante y su estado registrado.
• Cómo funciona la impresión y el envío
• Comparar opciones de franqueo

¿Cómo conecto un cliente MCP remoto?

El endpoint del servidor remoto es https://sendlettersonline.co.uk/api/mcp. Si tu cliente admite MCP remoto con OAuth, añade la URL del servidor y sigue el flujo de inicio de sesión y consentimiento. Asegúrate de que el acceso a la API esté habilitado para tu cuenta y de que tu saldo prepago cubra cualquier pedido.

Para los clientes que usan una configuración de comandos local, el ejemplo de puente a continuación pasa una clave de API de portador al mismo endpoint remoto. Revisa la documentación de configuración actual de tu cliente: la compatibilidad con conectores remotos y los ajustes difieren entre productos y planes.

• Saldo de la cuenta y ajustes de acceso
• Guía de la API REST

¿Qué comprueba la salvaguarda de confirmación de precio?

preview_letter_price es de solo lectura. Llamar a create_letter_order sin confirmación devuelve una cotización en lugar de crear o pagar un pedido. Una llamada pagada debe proporcionar confirmed: true y expectedTotalPence igual al total actual; un total ausente o que no coincida se rechaza.

Este es un contrato del lado del servidor para la llamada a la herramienta, no una prueba independiente de que una persona haya hecho clic en un botón de aprobación. Tu asistente y tu cliente deben obtener tu permiso y enviar los campos correctos. Conecta solo clientes de confianza, mantén las credenciales privadas y revisa cada destinatario y cargo propuestos.

¿Debo usar MCP o la API REST?

Elige MCP cuando quieras que un asistente compatible interactúe con el servicio usando herramientas con nombre. Elige la API REST cuando tu aplicación necesite solicitudes HTTP directas y tus propios controles de flujo de trabajo. Usa el sitio web para cartas ocasionales sin ninguna de las dos integraciones.

Los tres flujos de trabajo conducen al correo físico. MCP no ofrece una asignación de franqueo gratuita separada, una red de Royal Mail diferente ni una garantía de entrega. La API y MCP comparten el saldo de la cuenta y la lógica de pedidos de cartas.

• Comparar métodos de envío empresarial
• Integración directa con la API REST
• Enviar una carta en el sitio web

¿Qué debo revisar antes de conectar un asistente?

El asistente puede recibir el contenido y la información de la cuenta que necesita para completar tu solicitud. Revisa su configuración de privacidad, los permisos que concedes y si estás autorizado a compartir la información de la carta. Nunca pegues claves de API en una conversación y revoca el acceso cuando ya no sea necesario.

• Aviso de privacidad
• Acuerdo de procesamiento de datos
• Gestionar el acceso conectado

Ejemplo de configuración del puente con clave de API

{
  "mcpServers": {
    "send-letters-online": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://sendlettersonline.co.uk/api/mcp",
        "--header", "Authorization: Bearer ${API_KEY}"
      ],
      "env": { "API_KEY": "YOUR_API_KEY" }
    }
  }
}

¿Qué herramientas expone el servidor MCP?

get_balance

Lee el saldo prepago disponible para tu cuenta, sin gastarlo.

list_orders

Revisa tus cartas anteriores, empezando por la más reciente.

get_order

Consulta una carta específica, incluido si ya se ha enviado.

preview_letter_price

Calcula exactamente cuánto costará una carta, sin gastar nada ni crear un pedido.

create_letter_order

Sin confirmación, devuelve una previsualización del precio. Con confirmed: true y el expectedTotalPence correspondiente, crea un pedido de carta pagado con cargo a tu saldo.

Preguntas frecuentes

¿Qué asistentes de IA funcionan con esto?

Usa un cliente que admita MCP remoto y el método de autenticación que elijas. Los clientes con compatibilidad nativa con servidores remotos pueden conectarse a la URL del servidor. Un cliente local que espera un servidor basado en comandos puede usar un puente adecuado como mcp-remote. La disponibilidad del conector depende del cliente y de la configuración de su cuenta.

¿Qué impide un pedido de carta no confirmado?

El servidor requiere confirmed: true y expectedTotalPence que coincida con el total cotizado actual antes de crear un pedido pagado. El asistente y el cliente son responsables de pedirte aprobación; el servidor comprueba los campos de confirmación enviados, no un clic humano independiente. Usa un cliente de confianza y revisa lo que autorizas.

¿Cómo se autentica el asistente?

Usa el inicio de sesión y consentimiento OAuth cuando tu cliente lo admita, o proporciona la clave de API de portador de tu cuenta. El acceso a la API debe estar habilitado para la cuenta. Mantén las claves privadas y no las pegues en una conversación ni las publiques en un repositorio.

¿Usa un saldo distinto del de la API o el sitio web?

No. Los pedidos de MCP y REST comparten el saldo prepago y el historial de pedidos de la cuenta de cliente habilitada. Los pagos del saldo del sitio web también pueden usar ese saldo. Financiar solo una cartera del sitio web no habilita el acceso a la API ni a MCP.

¿Puedo ver qué ha pedido mi asistente de IA?

Sí. Consulta los pedidos en tu panel, o usa list_orders y get_order en tu asistente. Revisa el contenido, el destinatario y el estado registrados en lugar de confiar solo en una afirmación conversacional de que se envió una carta.

¿Puedo desconectar un asistente de IA más adelante?

Gestiona los asistentes conectados y el acceso a la API en los ajustes de saldo y acceso de tu cuenta. Revoca la conexión OAuth o la clave de API correspondiente si ya no confías en ella. Desconectar no recupera una carta ya pedida o enviada.

¿preview_letter_price envía una carta o me cobra?

No. Calcula un precio sin crear un pedido ni gastar saldo. Una llamada confirmada a create_letter_order es la operación pagada.

¿Puede el asistente garantizar cuándo llega mi carta?

No. El asistente puede seleccionar un servicio postal y leer la información disponible del pedido, pero la llegada se rige por el servicio postal y sus términos. El envío, el seguimiento y la entrega confirmada son estados diferentes.