BizPrint MCP 서버

설명

AI 어시스턴트를 BizPrint 클라우드 인쇄 API에 연결하는 MCP(Model Context Protocol) 서버입니다. 자연어를 통해 인쇄 작업을 전송하고, 프린터와 스테이션을 관리하며, 인쇄 작업 상태를 모니터링할 수 있습니다.

Related MCP server: OpenPrints MCP

기능

• 프린터, 스테이션 및 인쇄 작업 목록 확인 및 검사

• URL을 통해 구성된 모든 프린터로 문서 전송

• 실시간 인쇄 작업 상태 모니터링

• 대규모 프린터 관리를 위한 페이지네이션 지원

• 보안 HMAC-SHA256 API 인증

• Claude Desktop 확장을 통한 원클릭 설치

도구

사전 요구 사항

• API 키가 있는 BizPrint 클라우드 계정 (시작하기)

• Node.js 18 이상 (데스크톱 확장 설치 시에는 필요 없음)

설치

데스크톱 확장 (권장)

Claude Desktop의 Anthropic 커넥터 디렉토리에서 직접 설치하세요:

1. Claude Desktop 열기

2. 설정 > 확장(Extensions)으로 이동

3. "BizPrint" 검색 후 설치 클릭

4. 메시지가 표시되면 BizPrint API 키 입력

API 키는 운영 체제의 키체인에 안전하게 저장됩니다.

또는 릴리스에서 .mcpb 파일을 다운로드하여 더블 클릭하여 설치하세요.

소스에서 설치

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

이 작업은 MCP 클라이언트 구성에서 참조할 수 있는 build/index.js에 컴파일된 서버를 생성합니다.

구성

서버는 두 개의 환경 변수가 필요하며, 하나의 선택적 재정의 변수가 있습니다:

API 키는 BizPrint 대시보드의 애플리케이션 설정에서 찾을 수 있습니다.

Claude Desktop (수동)

Claude Desktop 구성 파일에 다음을 추가하고, 저장소를 복제한 경로에 맞게 수정하세요:

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

예시

예시 1: 프린터 설정 확인

사용자: 설정된 프린터가 무엇인가요?

Claude: BizPrint 프린터를 확인하겠습니다.

2개의 프린터가 구성되어 있습니다:

1. Front Desk Laser (ID: 12) - 활성화됨, 스테이션 3, A4, 컬러

2. Warehouse Label (ID: 15) - 활성화됨, 스테이션 3, 4x6 라벨, 흑백

두 프린터 모두 현재 온라인 상태인 스테이션 3("Office Station")에 할당되어 있습니다.

예시 2: 인쇄 작업 전송

사용자: https://example.com/invoices/1042.pdf 청구서를 프런트 데스크 프린터로 인쇄해줘.

Claude: 인쇄 작업을 생성했습니다:

• 작업 ID: 287

• 프린터: Front Desk Laser (ID: 12)

• 상태: 대기 중(pending)

• 문서: https://example.com/invoices/1042.pdf

작업이 BizPrint로 전송되었으며 스테이션이 가져오면 인쇄됩니다.

예시 3: 인쇄 작업 상태 모니터링

사용자: 최근 인쇄 작업과 상태를 보여줘.

Claude: 최근 인쇄 작업은 다음과 같습니다:

1. 작업 287 - 완료됨, 프린터 12, "Invoice #1042"

2. 작업 286 - 완료됨, 프린터 15, "Shipping label order #523"

3. 작업 285 - 실패함, 프린터 12, "Monthly report"

작업 285가 실패했습니다. 프린터 상태를 확인하고 다시 시도해 보세요.

사용자: 작업 287의 상태는 어때?

Claude: 작업 287은 현재 완료되었습니다. Front Desk Laser 프린터에서 성공적으로 인쇄되었습니다.

개발

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

개인정보 처리방침

이 확장은 API 자격 증명을 사용하여 BizPrint 클라우드 인쇄 API(print.bizswoop.app)에 연결합니다. 인쇄 작업 실행을 위해 프린터 명령과 문서 URL을 BizPrint 서버로 전송합니다. API 키(OS 키체인에 보안 저장됨) 외에 로컬에 저장되는 데이터는 없습니다. 전체 개인정보 처리방침은 다음을 참조하세요: https://getbizprint.com/privacy-policy/

데이터 처리

• API 자격 증명은 운영 체제의 보안 키체인에 저장됩니다.

• 인쇄 작업 데이터(문서 URL, 프린터 선택)는 BizPrint 클라우드 API로 전송됩니다.

• 이 확장은 대화 데이터나 개인 정보를 수집하지 않습니다.

• 인쇄 작업 실행에 필요한 것 외에는 제3자와 데이터를 공유하지 않습니다.

지원

• GitHub 이슈: https://github.com/bizswoop-development/bizprint-mcp-server/issues

• 이메일: support@bizswoop.com

• 문서: https://www.getbizprint.com

라이선스

MIT