intuit/quickbooks-online-mcp-server

해결하는 문제

이 프로젝트는 AI 모델(Claude Code 등)과 QuickBooks Online 사이의 다리를 제공하여 AI 에이전트가 재무 데이터와 상호작용할 수 있도록 합니다. LLM이 Model Context Protocol (MCP)를 통해 회계 엔티티 및 재무 보고서를 직접 읽고 생성하며 관리할 수 있게 함으로써 수동 데이터 입력 또는 수동 보고서 생성의 필요성을 제거합니다.

작동 방식

사용자 기계에서 하위 프로세스로 실행되는 로컬 MCP 서버로 작동합니다. OAuth 2.0 인증을 사용하여 QuickBooks Online API에 연결합니다. 서버는 AI 클라이언트에게 145개의 별도 도구를 노출하며, AI는 특정 회계 작업을 수행하기 위해 이를 호출할 수 있습니다. 장기적인 안전한 접근을 유지하기 위해 토큰 회전 기능이 내장되어 있습니다.

대상 사용자

QuickBooks Online을 사용하고 AI 에이전트 또는 MCP 호환 LLM 클라이언트를 사용하여 회계 워크플로우를 자동화하고자 하는 개발자 및 비즈니스 소유자.

주요 특징

• 포괄적인 API 커버리지: 고객, 청구서, 청구서 등 29개의 엔티티 유형과 손익계산서, 자산부채표 등 11개의 재무 보고서를 포함한 총 145개의 도구 제공.
• 완전한 CRUD 기능: 대부분의 엔티티에 대해 생성, 읽기, 업데이트, 삭제를 지원.
• 세밀한 접근 제어: 환경 변수를 통해 쓰기, 업데이트, 삭제 카테고리의 도구를 비활성화하여 원하는 경우 AI에 읽기 전용 접근만 허용할 수 있습니다.
• 보안 인증: 샌드박스 및 프로덕션 환경 모두를 지원하는 OAuth 2.0을 구현.
• 타입 안전성: TypeScript와 Zod를 사용하여 AI와 API 간의 데이터 전달에 엄격한 검증을 수행.