Depois que o ezeep estiver conectado, seu assistente terá um conjunto de ferramentas de impressão que poderá chamar por você. Você descreve o que deseja e ele escolhe a ferramenta adequada, portanto, os nomes abaixo só são importantes quando você quiser ser específico sobre alguma coisa. Esta página explica o que cada ferramenta faz, quais informações ela precisa de você e o que retorna.
Localizar e consultar impressoras
| Ferramenta | Finalidade |
| List Printers | Retorna todas as impressoras às quais a conta conectada pode acessar, incluindo identificador, nome de exibição, localização e a indicação de se a entrada é uma fila. O status da impressora não faz parte desta resposta, portanto, perguntas sobre quais impressoras estão indisponíveis são respondidas com base nos conectores. |
| Get Printers Properties | Precisa do identificador de uma impressora. Retorna a visão mais completa que uma única ferramenta pode fornecer: suporte a impressão colorida e frente e verso, incluindo as configurações padrão, agrupamento, todos os tamanhos de papel compatíveis com suas dimensões e qual é o padrão, a lista de bandejas, orientações e resoluções. Perguntas sobre o que uma determinada impressora é capaz de fazer fisicamente são respondidas em uma única chamada. |
| Check Supported File Types | Retorna a configuração da plataforma, que contém as extensões de arquivos compatíveis juntamente com uma grande quantidade de detalhes do sistema que não estão relacionados. Peça especificamente pelas extensões e o assistente irá extraí-las para você. |
| List Printers with issues | Retorna uma contagem e as impressoras que estão informando um problema no momento. Quando não há nenhum problema, retorna uma lista vazia e uma contagem de zero, e não um erro. |
Imprimir um documento
| Ferramenta | Finalidade |
| Print from a URL | Precisa da URL do arquivo, de um nome de arquivo e do identificador de uma impressora. Número de cópias, impressão colorida, frente e verso e tamanho do papel são opcionais. Retorna um identificador de trabalho. |
| Print a local or generated file | A preparação de um upload precisa de um nome de arquivo e retorna um local de upload com tempo limitado. Depois que o arquivo for colocado nesse local, a chamada de impressão precisará do identificador do arquivo e do identificador da impressora, com as mesmas configurações opcionais. |
Acompanhar um trabalho
| Ferramenta | Finalidade |
| Get Print Job Status | Precisa de um identificador de trabalho, que é retornado quando o trabalho é enviado. Retorna o status atual. O mesmo trabalho aparece no portal de administração, portanto, tudo o que for impresso a partir de um cliente de IA pode ser auditado no local habitual. |
Status dos conectores e das impressoras
| Ferramenta | Finalidade |
| List Connectors | Retorna uma página por vez. Cada conector contém seu identificador, nome, descrição, tipo, status online ou offline, localização, nome do host, endereço interno, sistema operacional, versão do software, quando esteve online pela última vez e quando suas impressoras foram atualizadas pela última vez. |
| List offline Connectors | Retorna diretamente os conectores que estão offline. |
| Get Connector Status | Precisa de um identificador de conector e retorna os detalhes desse conector. |
Gerenciar usuários e acessos
| Ferramenta | Finalidade |
| List Groups | Não precisa de nenhuma informação e retorna uma página por vez. Cada grupo contém seu identificador, nome, descrição, indicadores de impressão local e impressora pessoal, a origem do grupo (um provedor de identidade ou o próprio ezeep) e a quantidade de membros e impressoras. |
| Create a Group | Precisa de um nome. A descrição é opcional. |
| Add a User to a Group | Precisa de um identificador de grupo e de um identificador de usuário. |
| Assign a printer to a group | Precisa de um identificador de grupo e de um identificador de impressora. |
| List Users | Retorna a lista completa de usuários da organização em uma única resposta, com dados de contato, identificadores de login, status de verificação, indicadores de recursos e associações a grupos de cada pessoa. É importante saber disso antes de pedir a um cliente de IA para ler essa lista. |
| Invite a User | Precisa de um endereço de e-mail. Nome, sobrenome e duração do convite são opcionais. |
Verificar sua conta
| Ferramenta | Finalidade |
| Get Account Info | Retorna o nome de exibição da conta conectada, a organização, as funções, o status de verificação, o idioma e o provedor de identidade. Consulte essas informações primeiro sempre que os resultados parecerem desconhecidos ou uma chamada de gerenciamento for recusada. |
| Get Organization | Retorna os dados da organização, incluindo seu nome e o provedor de identidade ao qual ela está vinculada.
|
Suporte para desenvolvedores
O servidor possui sua própria documentação como ferramentas que podem ser chamadas: um guia de integração, uma referência da API e exemplos de código. Essas ferramentas funcionam antes mesmo de você fazer login, por isso um assistente pode criar a estrutura de uma integração com o ezeep e depois orientar você durante a conexão. Criar um aplicativo que imprime com a API do ezeep explica esse processo.
O que o servidor MCP não faz
Excluir um usuário, excluir um grupo, remover uma impressora de um grupo e cancelar um trabalho em andamento não estão disponíveis por meio do servidor MCP. A API REST permite excluir impressoras, conectores e usuários. Portanto, essas não são limitações da plataforma, mas apenas ferramentas que não estão disponíveis na interface MCP. Use o portal de administração.
