Jobber Automation MCP

ChatGPT가 Jobber 데이터를 검사하고 통제된 자동화를 관리할 수 있게 해주는 자체 호스팅 MCP 서버입니다. 동일한 Docker Compose 스택이 macOS, Linux, Raspberry Pi ARM64에서 실행됩니다.

이것은 초기 단일 소유자 빌드입니다. 공개 또는 다중 테넌트 호스팅용으로 설계되지 않았습니다.

현재 릴리스: v0.2.0

아키텍처

flowchart LR
    C[ChatGPT] --> T[Secure MCP Tunnel]
    T --> M[Jobber Automation MCP]
    M --> J[Jobber GraphQL API]
    M --> D[(Private SQLite data)]
    M --> W[Automation worker]

MCP 서버는 ChatGPT가 호출할 수 있는 도구를 정의합니다. 작업자는 채팅이 열려 있지 않아도 저장된 일정을 실행합니다. 작업 카탈로그는 의도적으로 통제됩니다. 자동화 정의는 임의의 운영 체제 명령을 실행할 수 없습니다.

현재 기능

• Jobber OAuth 인증 코드 흐름 및 순환 갱신 토큰 지원

• Jobber 계정, 클라이언트, 작업 조회

• 읽기 전용 GraphQL 및 확인된 변이 탈출구

• WAL 모드 및 개인 데이터베이스 파일을 사용하는 SQLite 영속성

• 자동화 생성, 목록, 조회, 업데이트, 활성화, 일시 중지, 미리 보기, 지금 실행, 기록 및 삭제 도구

• 수동 및 반복 간격 트리거

• 로그, Jobber 쿼리 및 Jobber 변이 작업

• 생성 시 초안 및 편집 후 초안 검토 수명 주기

• 실행별 승인 또는 명시적으로 사전 승인된 자동화 정책

• 실행 및 감사 기록이 있는 백그라운드 스케줄러

• macOS 개발 및 Linux ARM64 Raspberry Pi 호스트와 호환되는 Docker 패키징

안전 동작

• 새 자동화와 편집된 자동화는 초안이며 실행할 수 없습니다.

• 활성화하려면 정확한 문구 I APPROVE THIS AUTOMATION이 필요합니다.

• always 승인을 사용하는 Jobber 변이 자동화는 스케줄러에서 변이할 수 없습니다.

• 수동 실행에는 I CONFIRM THIS AUTOMATION RUN이 필요합니다.

• preapproved 변이 자동화는 전체 정의가 검토되고 활성화된 후에만 무인 실행이 가능합니다.

• 일반 일회성 변이에는 I CONFIRM THIS JOBBER CHANGE가 필요합니다.

• OAuth 상태는 해시되고, 일회용이며, 10분 후에 만료됩니다.

• 모든 변이 시도와 자동화 결과는 감사됩니다.

설치

작업에 맞는 문서로 시작하세요:

• 설치 및 업데이트

• Raspberry Pi 배포 및 마이그레이션

• 백업, 복원 및 롤백

• 보안 정책

• 버전 기록

빠른 로컬 개발 설정에는 Node.js 22.5 이상이 필요합니다:

npm install
npm run build
npm start

데이터베이스 기본값은 ./data/jobber-mcp.sqlite입니다.

ChatGPT MCP 엔드포인트

로컬 MCP 경로는 다음과 같습니다:

http://localhost:8080/mcp/YOUR_MCP_PATH_TOKEN

포함된 Compose 파일은 OpenAI Secure MCP Tunnel을 서버와 함께 실행합니다. 두 게시 포트 모두 호스트 루프백에만 바인딩됩니다. 라우터 포트 포워딩을 통해 노출하지 마십시오.

자동화 정의 예시

{
  "name": "Hourly account check",
  "description": "Verify that Jobber remains reachable.",
  "approvalPolicy": "always",
  "trigger": { "type": "interval", "everyMinutes": 60 },
  "actions": [
    {
      "type": "jobber.query",
      "query": "query Account { account { id name } }"
    }
  ]
}

MCP 도구는 이를 초안으로 생성합니다. 미리 보고, 활성화한 다음 기록을 검사하세요.

개발

npm run check

테스트 스위트는 GraphQL 작업 분리와 로컬 자동화 수명 주기를 다룹니다.

릴리스 정책

버전은 MAJOR.MINOR.PATCH 시맨틱 버전 관리를 사용합니다. 모든 릴리스에는 Git 태그와 일치하는 변경 로그 항목이 있습니다. v1.0까지는 마이너 릴리스에 마이그레이션 노트 검토가 필요한 상당한 변경 사항이 포함될 수 있습니다.

계획된 작업

• 일반 GraphQL 대신 인증된 스키마를 기반으로 한 명명된 Jobber 도구

• 캘린더/cron, Jobber 폴링 및 웹훅 릴레이 트리거

• 조건, 템플릿, 알림, 재시도 및 멱등성 키

• 임베디드 MCP Apps 자동화 대시보드

• 암호화 또는 운영 체제 기반 토큰 저장

• 자동화된 백업 검증 및 더 간단한 복원 명령

• 목적에 맞는 일정 및 방문 관리 워크플로

중요한 제한 사항

• 예약된 작업은 호스트가 켜져 있고 서버가 실행 중일 때만 실행됩니다.

• Secure MCP Tunnel은 ChatGPT를 MCP에 연결합니다. 일반 인바운드 Jobber 웹훅 엔드포인트가 아닙니다.

• Jobber 필드와 변이는 프로덕션 사용 전에 인증된 스키마 및 선택된 API 버전과 대조하여 검증해야 합니다.

• 로컬 포트를 공개 인터넷에 직접 노출하지 마십시오.

라이선스

MIT 라이선스에 따라 릴리스되었습니다.