SendLettersOnline.co.uk

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

Um servidor MCP. Para cartas de verdade.

O servidor MCP do Send Letters Online conecta assistentes de IA compatíveis à impressão e postagem de cartas físicas. Um assistente pode verificar seu saldo, revisar pedidos, visualizar o preço de uma carta e enviar um pedido pago usando sua conta habilitada. Revise o rascunho, o destinatário e o total cotado no seu assistente antes de autorizá-lo a enviar.

Gerenciar acesso do assistente Ver as opções de configuração

O que é um servidor MCP para enviar cartas?

O Model Context Protocol (MCP) é uma forma de um assistente chamar ferramentas fornecidas por outro serviço. O Send Letters Online expõe ferramentas para seu saldo, pedidos de cartas e preços. O assistente prepara o texto; o serviço de cartas realiza a operação paga de impressão e postagem após receber os campos de confirmação necessários.

• Guia oficial de servidor remoto MCP
• Fluxos de trabalho de cartas comerciais

Como envio uma carta física por meio de um assistente?

Informe ao seu assistente conectado para quem é a carta e o que ela deve dizer. Verifique você mesmo o rascunho completo e o endereço postal. Peça uma prévia do preço para o documento, as opções de impressão e o serviço postal, e então aprove explicitamente o pedido pretendido no seu cliente.

Após um pedido confirmado, a carta é impressa, dobrada, envelopada e postada. Use get_order ou seu painel para acompanhar o progresso. Não presuma que o assistente dizer "enviado" seja prova de postagem ou entrega.

• Conecte sua conta habilitada usando um método de autenticação compatível.
• Redija e revise o conteúdo completo e o endereço do destinatário.
• Visualize o preço atual sem fazer o pedido.
• Autorize a carta específica e o total no seu cliente.
• Verifique o pedido resultante e o status registrado.
• Como funciona a impressão e a postagem
• Comparar opções de postagem

Como conecto um cliente MCP remoto?

O endpoint do servidor remoto é https://sendlettersonline.co.uk/api/mcp. Se seu cliente oferece suporte a MCP remoto com OAuth, adicione a URL do servidor e siga o fluxo de login e consentimento. Certifique-se de que o acesso à API está habilitado para sua conta e que seu saldo pré-pago cobre quaisquer pedidos.

Para clientes que usam uma configuração de comando local, o exemplo de ponte abaixo passa uma chave de API bearer para o mesmo endpoint remoto. Consulte a documentação de configuração atual do seu cliente: o suporte a conectores remotos e as configurações variam entre produtos e planos.

• Saldo da conta e configurações de acesso
• Guia da API REST

O que a proteção de confirmação de preço verifica?

preview_letter_price é somente leitura. Chamar create_letter_order sem confirmação retorna uma cotação em vez de criar ou pagar por um pedido. Uma chamada paga deve fornecer confirmed: true e expectedTotalPence igual ao total atual; um total ausente ou divergente é rejeitado.

Este é um contrato do lado do servidor para a chamada da ferramenta, não uma prova independente de que uma pessoa clicou em um botão de aprovação. Seu assistente e cliente devem obter sua permissão e enviar os campos corretos. Conecte apenas clientes em que você confia, mantenha as credenciais privadas e revise cada destinatário e cobrança propostos.

Devo usar MCP ou a API REST?

Escolha MCP quando quiser que um assistente compatível interaja com o serviço usando ferramentas nomeadas. Escolha a API REST quando sua aplicação precisar de requisições HTTP diretas e de seus próprios controles de fluxo de trabalho. Use o site para cartas ocasionais sem nenhuma das duas integrações.

Os três fluxos de trabalho levam a correio físico. O MCP não fornece uma franquia de postagem gratuita separada, uma rede Royal Mail diferente ou uma garantia de entrega. A API e o MCP compartilham o saldo da conta e a lógica de pedidos de cartas.

• Comparar métodos de envio comercial
• Integração direta com a API REST
• Enviar uma carta pelo site

O que devo revisar antes de conectar um assistente?

O assistente pode receber o conteúdo e as informações da conta de que precisa para concluir sua solicitação. Revise as configurações de privacidade dele, as permissões que você concede e se você está autorizado a compartilhar as informações da carta. Nunca cole chaves de API em uma conversa e revogue o acesso quando ele não for mais necessário.

• Aviso de privacidade
• Contrato de Processamento de Dados
• Gerenciar acesso conectado

Exemplo de configuração da ponte com chave 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" }
    }
  }
}

Quais ferramentas o servidor MCP expõe?

get_balance

Lê o saldo pré-pago disponível para sua conta, sem gastá-lo.

list_orders

Consulta suas cartas anteriores, da mais recente para a mais antiga.

get_order

Verifica uma carta específica, incluindo se ela já foi postada.

preview_letter_price

Calcula exatamente quanto uma carta vai custar - sem gastar nada ou criar um pedido.

create_letter_order

Sem confirmação, retorna uma prévia de preço. Com confirmed: true e o expectedTotalPence correspondente, cria um pedido de carta pago a partir do seu saldo.

Perguntas frequentes

Quais assistentes de IA funcionam com isto?

Use um cliente que ofereça suporte a MCP remoto e ao método de autenticação que você escolher. Clientes com suporte nativo a servidor remoto podem se conectar à URL do servidor. Um cliente local que espera um servidor baseado em comando pode usar uma ponte apropriada, como mcp-remote. A disponibilidade do conector depende do cliente e das configurações da conta dele.

O que impede um pedido de carta não confirmado?

O servidor exige confirmed: true e expectedTotalPence correspondente ao total cotado atual antes de criar um pedido pago. O assistente e o cliente são responsáveis por pedir sua aprovação; o servidor verifica os campos de confirmação enviados, não um clique humano separado. Use um cliente confiável e revise o que você autoriza.

Como o assistente se autentica?

Use login e consentimento OAuth quando compatível com seu cliente, ou forneça a chave de API bearer da sua conta. O acesso à API deve estar habilitado para a conta. Mantenha as chaves privadas e não as cole em uma conversa nem as publique em um repositório.

Ele usa um saldo separado da API ou do site?

Não. Pedidos via MCP e REST compartilham o saldo pré-pago e o histórico de pedidos da conta de cliente habilitada. Pagamentos de saldo pelo site também podem usar esse saldo. Apenas abastecer uma carteira do site não habilita o acesso à API ou ao MCP.

Posso ver o que meu assistente de IA pediu?

Sim. Veja os pedidos no seu painel ou use list_orders e get_order no seu assistente. Revise o conteúdo registrado, o destinatário e o status em vez de confiar apenas na afirmação conversacional de que uma carta foi enviada.

Posso desconectar um assistente de IA depois?

Gerencie os assistentes conectados e o acesso à API nas configurações de saldo e acesso da sua conta. Revogue a conexão OAuth ou a chave de API relevante se você não confiar mais nela. Desconectar não cancela uma carta já pedida ou postada.

preview_letter_price envia uma carta ou me cobra?

Não. Ele calcula um preço sem criar um pedido ou gastar saldo. Uma chamada confirmada de create_letter_order é a operação paga.

O assistente pode garantir quando minha carta chegará?

Não. O assistente pode selecionar um serviço postal e ler as informações disponíveis do pedido, mas a chegada é regida pelo serviço postal e seus termos. Postagem, rastreamento e entrega confirmada são estados diferentes.