buildswithpaul/Frappe_Assistant_Core

해결하는 문제

Frappe Assistant Core(FAC)를 사용하면 사용자는 자연어로 ERPNext 사이트와 상호 작용할 수 있습니다. FAC는 LLM(Claude 또는 ChatGPT 등)과 ERPNext 데이터 사이의 간격을 메워 사용자가 인터페이스를 수동으로 탐색하지 않고도 연체 청구서 검색, 리드 상태 업데이트, 수익 보고서 실행과 같은 복잡한 작업을 수행할 수 있게 합니다.

작동 방식

FAC는 MCP(Model Context Protocol)를 통해 ERPNext 데이터와 기능을 노출하는 게이트웨이 역할을 합니다. 문서 CRUD, 검색, 보고서, 분석을 위한 24개의 내장 도구를 제공합니다.

주요 사용 방법은 두 가지입니다.

1. BYO-LLM(MCP 서버): 사용자는 MCP 지원 LLM 클라이언트(예: Claude Desktop, Cursor)를 자신의 사이트에 연결합니다. LLM은 사용자 자신의 API 키를 사용하며 데이터는 사용자 스택 내에 유지됩니다.
2. FAC 채팅(SaaS): FAC Cloud로 구동되는 Frappe Desk 내에서 기본 채팅 위젯과 전체 화면 SPA를 제공하는 옵트인 방식의 관리형 환경입니다.

인증은 OAuth 2.0을 통해 처리되며 LLM이 사용자의 ERPNext 역할에 따라 특정 사용자에게 허용된 데이터에만 액세스할 수 있도록 보장합니다. 모든 작업은 어시스턴트 감사 로그에 기록됩니다.

대상 사용자

비즈니스 워크플로우와 데이터 검색을 자동화하기 위해 AI 어시스턴트를 통합하려는 ERPNext/Frappe 사이트의 관리자와 사용자.

주요 기능

• MCP 통합: 외부 LLM 클라이언트에 원활하게 연결하기 위한 MCP(Model Context Protocol) 기본 지원.
• 실시간 스키마 액세스: Frappe의 API에서 메타데이터를 직접 읽으므로 동기화 없이도 사용자 정의 필드와 DocType이 LLM에 즉시 표시됩니다.
• 확장 가능한 도구 세트: 개발자는 자신의 Frappe 앱의 후크를 통해 자신만의 도구와 기술을 추가할 수 있습니다.
• 권한 인식: OAuth 2.0을 통해 ERPNext 사용자 권한을 엄격히 준수합니다.
• 내장 분석: 고급 데이터 분석을 위한 Python 코드 및 데이터베이스 쿼리 실행 도구가 포함되어 있습니다.