Servidor MCP de BizPrint

Descripción

Un servidor MCP (Model Context Protocol) que conecta asistentes de IA a la API de impresión en la nube de BizPrint. Envía trabajos de impresión, gestiona impresoras y estaciones, y supervisa el estado de los trabajos de impresión mediante lenguaje natural.

Related MCP server: OpenPrints MCP

Características

• Listar e inspeccionar impresoras, estaciones y trabajos de impresión

• Enviar documentos a cualquier impresora configurada mediante URL

• Supervisar el estado de los trabajos de impresión en tiempo real

• Soporte de paginación para grandes flotas

• Autenticación de API segura HMAC-SHA256

• Instalación con un solo clic mediante la extensión de Claude Desktop

Herramientas

Requisitos previos

• Una cuenta de BizPrint Cloud con claves de API (empezar)

• Node.js 18 o posterior (no requerido para la instalación de la extensión de escritorio)

Instalación

Extensión de escritorio (Recomendado)

Instala directamente desde el Directorio de Conectores de Anthropic en Claude Desktop:

1. Abre Claude Desktop

2. Ve a Ajustes > Extensiones

3. Busca "BizPrint" y haz clic en Instalar

4. Introduce tus claves de API de BizPrint cuando se te solicite

Tus claves de API se almacenan de forma segura en el llavero de tu sistema operativo.

Alternativamente, descarga el archivo .mcpb desde Releases y haz doble clic para instalarlo.

Desde el código fuente

git clone https://github.com/bizswoop-development/bizprint-mcp-server.git
cd bizprint-mcp-server
npm install
npm run build

Esto genera un servidor compilado en build/index.js al que puedes hacer referencia en la configuración de tu cliente MCP.

Configuración

El servidor requiere dos variables de entorno, con una anulación opcional:

Puedes encontrar tus claves de API en el panel de control de BizPrint bajo la configuración de tu aplicación.

Claude Desktop (Manual)

Añade lo siguiente a tu archivo de configuración de Claude Desktop, ajustando la ruta a donde clonaste el repositorio:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "bizprint": {
      "command": "node",
      "args": ["/absolute/path/to/bizprint-mcp-server/build/index.js"],
      "env": {
        "BIZPRINT_PUBLIC_KEY": "your-public-key",
        "BIZPRINT_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

Claude Code

claude mcp add bizprint -- node /absolute/path/to/bizprint-mcp-server/build/index.js \
  --env BIZPRINT_PUBLIC_KEY=your-public-key \
  --env BIZPRINT_SECRET_KEY=your-secret-key

Ejemplos

Ejemplo 1: Comprobar la configuración de tu impresora

Tú: ¿Qué impresoras tengo configuradas?

Claude: Déjame comprobar tus impresoras BizPrint.

Tienes 2 impresoras configuradas:

1. Front Desk Laser (ID: 12) - Habilitada, Estación 3, A4, Color

2. Warehouse Label (ID: 15) - Habilitada, Estación 3, Etiqueta 4x6, B&N

Ambas impresoras están asignadas a la Estación 3 ("Office Station"), que actualmente está en línea.

Ejemplo 2: Enviar un trabajo de impresión

Tú: Imprime la factura en https://example.com/invoices/1042.pdf en la impresora de recepción.

Claude: He creado un trabajo de impresión:

• ID de trabajo: 287

• Impresora: Front Desk Laser (ID: 12)

• Estado: pendiente

• Documento: https://example.com/invoices/1042.pdf

El trabajo se ha enviado a BizPrint y se imprimirá una vez que la estación lo recoja.

Ejemplo 3: Supervisar el estado del trabajo de impresión

Tú: Muéstrame los trabajos de impresión recientes y su estado.

Claude: Aquí tienes tus trabajos de impresión recientes:

1. Trabajo 287 - COMPLETADO, Impresora 12, "Factura #1042"

2. Trabajo 286 - COMPLETADO, Impresora 15, "Etiqueta de envío pedido #523"

3. Trabajo 285 - FALLIDO, Impresora 12, "Informe mensual"

El trabajo 285 falló. Es posible que quieras comprobar el estado de la impresora e intentarlo de nuevo.

Tú: ¿Cuál es el estado del trabajo 287?

Claude: El trabajo 287 está ahora completado. Se imprimió correctamente en la impresora Front Desk Laser.

Desarrollo

npm install
npm test          # run tests
npm run build     # compile TypeScript
npm run pack:mcpb # build .mcpb desktop extension bundle

Política de privacidad

Esta extensión se conecta a la API de impresión en la nube de BizPrint (print.bizswoop.app) utilizando tus credenciales de API. Transmite comandos de impresora y URLs de documentos a los servidores de BizPrint para la ejecución del trabajo de impresión. No se almacenan datos localmente más allá de tus claves de API (protegidas en el llavero de tu SO). Para obtener información completa sobre privacidad, consulta nuestra política de privacidad: https://getbizprint.com/privacy-policy/

Tratamiento de datos

• Las credenciales de la API se almacenan en el llavero seguro de tu sistema operativo

• Los datos del trabajo de impresión (URLs de documentos, selecciones de impresora) se envían a la API de BizPrint Cloud

• Esta extensión no recopila datos de conversación ni información personal

• No se comparten datos con terceros más allá de lo necesario para la ejecución del trabajo de impresión

Soporte

• Problemas en GitHub: https://github.com/bizswoop-development/bizprint-mcp-server/issues

• Correo electrónico: support@bizswoop.com

• Documentación: https://www.getbizprint.com

Licencia

MIT