ezeep MCP: impressão em nuvem como servidor MCP

Permita que qualquer ferramenta de IA compatível com MCP liste impressoras, envie trabalhos de impressão, gerencie usuários e recupere dados de uso. Funciona com Claude, Cursor, Copilot, Lovable e qualquer framework de agente que implemente o Model Context Protocol. OAuth 2.0 com separação de escopos. https://mcp.ezeep.com/mcp

Teste grátisLeia a documentação
ezeep-mcp-server-hero

O que é o servidor MCP da ezeep?

O servidor MCP da ezeep é uma implementação hospedada do Model Context Protocol (MCP) que expõe a impressão em nuvem como um conjunto de ferramentas que podem ser chamadas por agentes de IA, assistentes e desenvolvedores de aplicações. Ele permite que qualquer cliente compatível com o MCP — incluindo Claude Desktop, Cursor, GitHub Copilot e Lovable — descubra impressoras, envie trabalhos de impressão, gerencie usuários e obtenha dados de uso usando linguagem natural ou entrada programática. O MCP é suportado pela ezeep Cloud e está disponível em todos os planos ezeep sem custo adicional. Para acessar: https://mcp.ezeep.com/mcp

Por que ele existe

Por que a impressão é a ferramenta que falta em todos os fluxos de trabalho com agentes?

Assistentes de IA não têm um caminho para o mundo físico

Um administrador de TI pode pedir ao Claude para listar instâncias da AWS, mas não impressoras. Um copiloto de armazém pode gerar uma etiqueta de envio como PDF, mas não pode encaminhá‑la para uma impressora de etiquetas. A impressão ficou presa atrás de pilhas de drivers, servidores de impressão e APIs específicas de fornecedores — e um agente não conseguiria navegar por isso sem uma integração personalizada.

Desenvolvedores de IA recomendam serviços que não existem

Peça ao Lovable, Cursor ou Copilot para adicionar impressão e as sugestões desmoronam: o Google Cloud Print foi descontinuado em 2021, as APIs do navegador não conseguem alcançar impressoras reais e integrações REST feitas sob medida levam horas para depurar. Recursos acabam sendo cortados, ou o aplicativo é lançado sem a funcionalidade de impressão.

Criar sua própria solução reconstrói o que a ezeep já resolveu

Renderização multiplataforma, gerenciamento de drivers, descoberta de impressoras, roteamento de trabalhos, autenticação de usuários, monitoramento da frota. Se você criar sua própria integração de IA para impressão, começa do zero. o ezeep MCP oferece uma plataforma de impressão empresarial com mais de 6.000 drivers, suporte para etiquetas Zebra e uma base de clientes ativa.

API do Pull Printing

Incorpore a liberação segura no seu aplicativo

A API de liberação do Pull Printing permite que você incorpore a liberação autenticada de documentos diretamente na interface do seu aplicativo ou dispositivo. Os usuários se autenticam, veem seus trabalhos pendentes e os liberam na impressora.
# Get pending jobs for authenticated user
curl -X GET 'https://printapi.ezeep.com/pullprint/jobs' \
  -H "Authorization: Bearer <access_token>"

# Release a specific job to a printer
curl -X POST 'https://printapi.ezeep.com/pullprint/release' \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "job_id": "<pending_job_id>",
    "printer_id": "<release_printer_id>"
  }'
// Get pending jobs for authenticated user
const jobs = await fetch(
  "https://printapi.ezeep.com/pullprint/jobs",
  { headers: { Authorization: "Bearer <access_token>" } }
);

// Release a specific job to a printer
const release = await fetch(
  "https://printapi.ezeep.com/pullprint/release",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: "Bearer <access_token>",
    },
    body: JSON.stringify({
      job_id: "<pending_job_id>",
      printer_id: "<release_printer_id>",
    }),
  }
);
import requests

headers = {"Authorization": "Bearer <access_token>"}

# Get pending jobs for authenticated user
jobs = requests.get(
    "https://printapi.ezeep.com/pullprint/jobs",
    headers=headers
).json()

# Release a specific job to a printer
release = requests.post(
    "https://printapi.ezeep.com/pullprint/release",
    headers={**headers, "Content-Type": "application/json"},
    json={
        "job_id": "<pending_job_id>",
        "printer_id": "<release_printer_id>",
    },
).json()
O que você pode fazer

Consulte as impressoras disponíveis por nome, localização ou capacidade. Envie trabalhos de impressão passando um documento e uma impressora de destino. Monitore e gerencie trabalhos em andamento. Crie e gerencie usuários, grupos e atribuições de impressoras. Extraia o histórico de uso e relatórios. Gerencie toda a sua frota de impressoras por meio de conversas — peça à sua IA para mostrar impressoras offline, convidar usuários ou reatribuir grupos de impressoras sem abrir um painel.

Recursos disponíveis

Impressoras, trabalhos de impressão, usuários, grupos, atribuições, Connectors, relatórios de uso.

 
Funciona com

Claude, Cursor, Lovable, Windsurf, GitHub Copilot e qualquer plataforma que suporte o Model Context Protocol.

Casos de uso comuns

Imprimir etiquetas de envio e romaneios de uma plataforma de fulfillment desenvolvida pela Lovable. Acionar execuções de faturamento a partir de um fluxo de trabalho de contabilidade com Claude. Criar um copilot de operações de armazém que roteie documentos para a impressora certa no momento certo. Dar a qualquer aplicativo criado por IA um botão de impressão que realmente funcione em escala empresarial.

O que você pode fazer

Consultar trabalhos de impressão pendentes para um usuário autenticado. Liberar trabalhos de impressão específicos para uma impressora de destino sob demanda. Criar interfaces de liberação personalizadas para quiosques, telas sensíveis ao toque ou aplicativos móveis. Suportar fluxos de autenticação de usuário confiável e de dispositivo confiável.

Casos de uso comuns

Aplicativos de liberação personalizados em telas sensíveis ao toque de impressoras, liberação por RFID ou por toque de crachá em dispositivos compartilhados, liberação móvel a partir de um aplicativo personalizado e impressão segura em ambientes de saúde e serviços financeiros.

Leia a documentação da API de Pull Printing
Como funciona

Como funciona o server ezeep MCP?

O ezeep MCP é um servidor hospedado que implementa o Model Context Protocol. O ezeep MCP expõe cada recurso do ezeep como uma ferramenta. Seu cliente de IA as descobre, as chama e lida com os resultados da mesma forma que lida com qualquer outra ferramenta.
add-mcp-endpoint-ai-client
1

Adicione o endpoint MCP ao seu cliente de IA

Claude Desktop, Cursor, Copilot e a maioria dos clientes MCP aceitam um bloco de configuração como este:

{ "mcpServers": { "ezeep": { "type": "http", "url": "https://mcp.ezeep.com/mcp", ... } } }

Lovable e outras ferramentas de IA que suportam personal Connectors usam a mesma URL em sua própria interface.

authenticate-mcp-ezeep
2

Autenticação com OAuth

No primeiro uso, o cliente abre um navegador para o OAuth. Faça login com a conta de administrador da sua organização ezeep. O servidor retorna um token de acesso de curta duração com rotação de token de atualização de uso único, conforme a especificação de autorização MCP. As credenciais nunca aparecem na conversa com a IA nem nos logs do cliente.

connect-mcp-endpoint-ezeep
3

Ferramentas de chamada

A IA identifica 20 ferramentas nas áreas de impressão, administração e suporte a desenvolvedores. Ela as aciona por meio de linguagem natural ou por entrada programática. Tudo é executado pela mesma plataforma ezeep e pela REST API, com os mesmos limites de taxa, faturamento e relatórios.

Build-Time vs Runtime

Qual a diferença entre usar o ezeep MCP em Build-Time e em Runtime?

O ezeep MCP é usado em dois modos distintos. A maioria dos clientes usa ambos. Ambos os modos usam o mesmo servidor, as mesmas ferramentas e a mesma autenticação. A distinção é arquitetural, não de produto.

Build-Time: Estruturando uma integração

Dentro do Lovable, Cursor, Copilot ou Claude Desktop, a IA usa o MCP para criar algo que imprime. Ela descobre o conjunto de ferramentas, lê o guia de integração, gera código funcional e executa uma impressão de teste. O aplicativo implantado então chama a REST API do ezeep em Runtime. O MCP não está no loop do usuário final. Este é o caminho principal para desenvolvedores de aplicativos de IA e a forma mais rápida para um desenvolvedor prototipar uma integração de impressão.

Runtime: Acionando um agente

 

Frameworks de agentes usam o MCP como interface permanente. O agente chama list_printers, print_from_url, e get_print_job_status como ferramentas nativas dentro de um fluxo de trabalho maior. Este é o caminho para automação de TI (status da frota, provisionamento de usuários), copilotos de operações (impressão de etiquetas a partir de um WMS) e fluxos de trabalho de documentos sem intervenção humana.

Conjunto de ferramentas

Quais ferramentas o server ezeep MCP expõe?

Todos os recursos do ezeep que uma IA possa precisar, expostos como ferramentas descobríveis. O servidor ezeep MCP fornece 20 ferramentas em três categorias: impressão, administração e suporte ao desenvolvedor.
Impressão

list_printers, get_printer_properties, print_from_url, print_uploaded_file, prepare_file_upload, get_print_job_status, get_supported_filetypes

Administrador

list_connectors, get_connector_status, list_offline_connectors, list_printers_with_issues, list_groups, create_group, assign_printer_to_group, list_users, invite_user, add_user_to_group

 
Suporte a desenvolvedores (não requer autenticação)

get_integration_guide, get_api_reference, get_code_example

A separação de escopos passa pela camada de autenticação. O escopo de impressão abrange ferramentas de impressora, trabalho de impressão e arquivo. O escopo de contas abrange o gerenciamento de usuário, grupo e Connector. As ferramentas de suporte a desenvolvedores não requerem autenticação alguma, de modo que um cliente de IA pode ler a documentação de integração e gerar o esqueleto de código antes mesmo de o usuário fazer login.

User: Print the shipping label at https://example.com/labels/A4719.pdf 
      to the Warehouse-Zebra-01 printer.

AI:   [calls list_printers]
AI:   [calls print_from_url with printer_id and file_url]
AI:   Printed. Job ID 8f3c9d2a, status sent_to_printer.
O que muda

Como o ezeep MCP muda a forma como os desenvolvedores criam integrações de impressão?

Mudanças concretas na forma como você desenvolve.
faster-mcp-integrations
1

Integrações: de horas para minutos

Durante o desenvolvimento, o MCP gera automaticamente o esqueleto de código REST funcional para o ezeep em uma única conversa. Sem SDK para instalar, sem fluxo de autenticação para depurar manualmente e sem descoberta de impressoras para implementar.

operational-mcp-tasks
2

Tarefas operacionais saem do painel

Qualquer ação que um administrador do ezeep realiza no console da web fica acessível por um cliente de IA. Útil para equipes de TI que já trabalham com Claude, Copilot ou Cursor e para automatizar tarefas administrativas que antes exigiam scripts contra a REST API.

typing-code-laptop-mcp-api
3

A mesma plataforma da REST API

As chamadas MCP são roteadas pela mesma infraestrutura da ezeep que atende à REST API: mesmos limites de taxa, mesma cobrança, mesmos relatórios e o mesmo motor de renderização com suporte da ThinPrint, que processa milhões de trabalhos de impressão diariamente em produção para clientes da Fortune 500.

Casos de uso

O que você pode criar com o server ezeep MCP?

Quatro padrões que vemos os clientes implementarem desde o primeiro dia.
Configuração

Como configurar o ezeep MCP Server?

A configuração do ezeep MCP é feita em quatro passos: adicione o endpoint ( https://mcp.ezeep.com/mcp ) à configuração do seu cliente MCP, conclua o fluxo OAuth com a conta de administrador da sua organização ezeep, execute list_printers para confirmar a conexão e execute print_from_url com um PDF de teste. Do zero à primeira impressão em menos de 10 minutos.

O ezeep MCP está disponível em todos os planos sem custo adicional. O uso é contabilizado nas cotas padrão da API da ezeep: uma chamada da ferramenta MCP equivale a uma chamada de API para fins de limite de taxa e faturamento.

how-to-set-up-mcp

Perguntas frequentes

Quer saber como tudo funciona? Aqui está tudo o que você queria saber sobre a impressão em nuvem da ezeep.

O servidor ezeep MCP tem custo adicional?

Não. O servidor MCP da ezeep não tem custo adicional. Ele opera com sua conta ezeep existente, e os trabalhos de impressão são cobrados exatamente da mesma forma que pela API REST ou por qualquer outra interface da ezeep. Se você já tem uma organização ezeep, pode se conectar e começar a usar as ferramentas sem custo adicional.

É preciso escrever código para usar o ezeep MCP server?

Não. O cliente de IA encontra as ferramentas e realiza as chamadas automaticamente. Você adiciona o endpoint, se autentica uma vez com OAuth e descreve o que deseja em linguagem natural. Não é preciso instalar um SDK nem configurar um cliente de API. O código só entra em jogo se você estiver desenvolvendo um aplicativo que será implementado e, mesmo assim, a IA gera o código de integração para você no momento da compilação.

Quais impressoras e tipos de arquivo o ezeep MCP server suporta?

O ezeep MCP server oferece o mesmo suporte que a plataforma ezeep: mais de 6.000 drivers de impressora para hardware de escritório e de etiquetas, incluindo impressão nativa de etiquetas Zebra (ZPL, EPL, ZPLII). Para arquivos, o ezeep renderiza PDFs, documentos do Office e formatos de imagem comuns no servidor, para que a IA possa imprimir um PDF gerado ou um URL sem drivers locais. Chame get_supported_filetypes para obter a lista atual em tempo de execução.

O que acontece quando a impressora de destino está offline durante uma chamada de impressão do MCP?

A chamada de impressão retorna um status estruturado em vez de falhar silenciosamente, e o trabalho de impressão é enfileirado no conector. Antes de imprimir, um cliente de IA pode chamar list_printers_with_issues e get_connector_status para confirmar se a impressora está acessível, e get_print_job_status para acompanhar o trabalho de impressão após o envio. O comportamento de impressora offline é idêntico ao observado no painel da ezeep ou na REST API. O MCP não altera o processamento subjacente dos trabalhos de impressão.

A IA pode imprimir por engano na impressora errada ou enviar o documento errado?

A impressão é uma chamada explícita a uma ferramenta, e não um processo em segundo plano. A IA chama list_printers para resolver um destino e print_from_url ou print_uploaded_file com uma impressora e um arquivo específicos. Cada trabalho de impressão retorna um ID do trabalho e um status que você pode auditar no ezeep Console. Para fluxos de trabalho não supervisionados, limite a conta conectada apenas às impressoras e aos recursos de que o fluxo de trabalho realmente precisa.

Para onde vão os dados do documento ao imprimir por meio do ezeep MCP server?

Os dados do documento passam pela mesma infraestrutura da ezeep que processa todos os outros trabalhos de impressão: a conta da sua organização e o mecanismo de renderização da ThinPrint, via HTTPS. Os arquivos são processados para renderização e encaminhados para a impressora que você especifica. O conteúdo do documento não é enviado ao provedor do modelo de IA como parte da chamada de impressão. O modelo vê apenas a chamada da ferramenta e seu resultado, não a saída renderizada. Este é o mesmo caminho de dados usado pela REST API.

O MCP funciona com meu framework de agentes?

Sim, se o framework suportar MCP. Clientes confirmados incluem Claude Desktop, Claude Code CLI, Cursor, Copilot no VS Code e Lovable. Frameworks de agentes que implementam suporte a clientes MCP (por exemplo, LangGraph com um adaptador MCP) funcionam imediatamente, sem necessidade de configuração adicional. Observe que esta lista não é exaustiva; nem todos os agentes disponíveis estão incluídos.

Qual é a diferença entre o ezeep MCP e a REST API do ezeep?

O servidor MCP e a API REST da ezeep rodam na mesma plataforma, mas expõem interfaces diferentes. O MCP é voltado a clientes de IA que descobrem e invocam ferramentas por meio de linguagem natural. Já o REST é usado pelo código da aplicação para chamar endpoints diretamente. A maioria dos clientes usa o MCP na fase de desenvolvimento para criar o esqueleto das integrações, e o REST em tempo de execução dentro do aplicativo implantado.

As credenciais são expostas ao modelo de IA?

Não. Os tokens OAuth são trocados diretamente entre o cliente MCP e o servidor MCP da ezeep por HTTPS. Os tokens nunca aparecem no contexto da conversa do LLM, no histórico de prompts do cliente, nem no provedor do modelo.

O que eu preciso para configurar o ezeep MCP na minha ferramenta de IA?

Você precisa de uma conta de administrador da ezeep e de um cliente de IA que suporte servidores MCP remotos via HTTP. A orientação de configuração da ezeep é conectar-se usando uma conta de administrador da organização, já que o assistente atua inteiramente como a conta com a qual você faz login.

Vale a pena refletir um pouco sobre este último ponto. Tudo o que a conta conectada pode acessar na ezeep, o assistente também pode. Escolher a conta certa é a decisão real aqui; ela importa mais do que qualquer configuração que você fizer depois.

Qual endpoint é necessário para conectar o ezeep MCP server à minha ferramenta de IA?

A URL do servidor MCP da ezeep é:

https://mcp.ezeep.com/mcp

Clientes que leem um arquivo de configuração aceitam um bloco neste formato:

{

"mcpServers": {

"ezeep": {

"type": "http",

"url": "https://mcp.ezeep.com/mcp"

}

}

}

Clientes com uma interface de Connector, como as configurações do Connector do Claude ou o painel de integrações do Lovable, informam o mesmo URL na própria tela. Reinicie o cliente depois, se for solicitado.

Back to top

Integre a impressão ao seu app Sem complicações

Adicione o endpoint. Faça login. Chame list_printers. Se a conexão funcionar, o resto vem sozinho.

ezeep-chart (1)