Frappe_Assistant_Core MCP — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

21 built-in tools: document CRUD, search, reports, analytics, Python exec, visualization
OAuth 2.0 + OIDC with dynamic client registration — per-user sessions, no shared API key
Respects ERPNext role-based permissions — users can only read/write what they already can in the UI
Plugin architecture — custom Frappe apps expose their own tools via hooks.py
One-click Claude Desktop setup via generated DXT bundle

라이브 데모

실제 사용 모습

frappe-assistant-core.replay ▶ 준비됨

0/0

설치

클라이언트 선택

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

{
  "mcpServers": {
    "frappe-assistant-core": {
      "command": "uvx",
      "args": [
        "Frappe_Assistant_Core"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "frappe-assistant-core": {
      "command": "uvx",
      "args": [
        "Frappe_Assistant_Core"
      ],
      "_inferred": true
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "frappe-assistant-core": {
      "command": "uvx",
      "args": [
        "Frappe_Assistant_Core"
      ],
      "_inferred": true
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "frappe-assistant-core": {
      "command": "uvx",
      "args": [
        "Frappe_Assistant_Core"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "frappe-assistant-core",
      "command": "uvx",
      "args": [
        "Frappe_Assistant_Core"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "frappe-assistant-core": {
      "command": {
        "path": "uvx",
        "args": [
          "Frappe_Assistant_Core"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add frappe-assistant-core -- uvx Frappe_Assistant_Core

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: Frappe_Assistant_Core

Ask business questions against ERPNext in plain English

👤 Founders, ops leads, finance teams ⏱ ~15 min beginner

언제 쓸까: You want sales / inventory / AR numbers without clicking through ERPNext reports or waiting for the analyst.

사전 조건

ERPNext site with Frappe Assistant Core installed — bench get-app + bench install-app frappe_assistant_core
User account with appropriate read roles — Use your own login; permissions follow

흐름

Connect Claude Desktop via OAuth

Connect to my ERPNext MCP endpoint at https://erp.example.com/api/method/frappe_assistant_core.mcp✓ 복사됨

→ OAuth login completes; Claude lists available tools
Ask a business question

What's my total sales this month broken down by customer group? Compare to last month.✓ 복사됨

→ Claude runs report tool and returns comparison
Drill into an anomaly

Customer group 'Wholesale' dropped 40%. Show me the top 10 customers in that group and their YoY sales.✓ 복사됨

→ Ranked list with actionable insight

결과: Answers to finance/ops questions in seconds without leaving your chat client.

함정

Claude hallucinates a Doctype name that doesn't exist in your customization — Always ask it to list available Doctypes first, then reference by exact name
Python execution tool runs unsanitized code against your DB — Disable the execute_python_code tool for non-admin users via role permissions

함께 쓰기: notion

Create or update documents in bulk from a brief

👤 ERPNext implementation consultants, data migrators ⏱ ~20 min intermediate

언제 쓸까: You have a spreadsheet or paragraph of data that needs to land in ERPNext as multiple Docs (Items, Customers, Suppliers).

사전 조건

Write permission on the target Doctype — Via the role assigned to your user

흐름

Describe what to create

I have these 15 new suppliers [paste table]. Create them as Supplier records with country, currency, and tax category set.✓ 복사됨

→ Claude proposes the records, asks to confirm before writing
Confirm then execute

Looks good, proceed. Report any validation errors per row.✓ 복사됨

→ Row-by-row create report with any errors
Verify in ERPNext

List the Suppliers I just created along with their creation date to confirm.✓ 복사됨

→ Matching list of 15

결과: Bulk data entry completed in minutes without CSV import tool friction.

함정

Claude creates duplicate records if natural keys aren't checked — Tell it to search for existing records before each create

Expose your custom Frappe app's logic as MCP tools

👤 Frappe/ERPNext developers ⏱ ~45 min advanced

언제 쓸까: You have a custom app with domain logic (e.g. loan amortization, manufacturing BOM exploder) and want LLMs to call it directly.

사전 조건

A Frappe custom app — Standard bench new-app

흐름

Register a tool in your app's hooks.py

Walk me through adding a custom MCP tool in my app acme_lending that computes loan amortization, based on the Frappe Assistant Core plugin spec.✓ 복사됨

→ Concrete hooks.py snippet + tool function
Reload and verify

How do I reload Frappe Assistant Core to pick up the new tool, and how do I confirm it shows up in Claude?✓ 복사됨

→ bench restart + tool listing check

결과: Your domain logic is now callable from any MCP client, no separate API to build.

함정

Tool logs sensitive fields into audit log — Mark fields as no_copy or mask in the tool response

조합

다른 MCP와 조합해 10배 효율

frappe-assistant-core + notion

Run monthly ERPNext P&L, post summary to Notion for the leadership weekly

Run our monthly P&L report in ERPNext for last month, summarize top 3 variances vs plan, and create a Notion page in 'Finance Weekly'.✓ 복사됨

frappe-assistant-core + filesystem

Export ERPNext report to CSV/Markdown for offline sharing

Run Sales by Customer report for Q1, save as /reports/sales-q1.csv.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출	비용
get_document	doctype: str, name: str	Fetch a specific ERPNext document by primary key	1 DB read
get_list	doctype: str, filters?: obj, fields?: str[], limit?: int	List/search documents of a Doctype with filters	1 DB query
create_document	doctype: str, data: obj	Insert a new document — respects validation	1 DB write + hooks
update_document	doctype, name, data	Patch fields on an existing doc	1 DB write
run_report	report_name: str, filters?: obj	Execute a saved Frappe Query/Script/Report Builder report	variable
execute_python_code	code: str	Run arbitrary Python in the Frappe context — ADMIN ONLY, disable for regular users	unbounded
get_chart_data	chart_name / config	Render a Frappe Dashboard chart as data	1 aggregation query

비용 및 제한

운영 비용

API 쿼터: Bounded by your ERPNext site's capacity — treat MCP calls like web UI calls
호출당 토큰: List queries 500-3000 tokens; single Doc reads 200-800
금액: Free — AGPL-3.0. Cost is whatever you pay for ERPNext hosting.
팁: Always pass fields to get_list — fetching a full Sales Invoice with all child tables can blow through 10k tokens per row.

보안

권한, 시크릿, 파급범위

최소 스코프: Whatever role permissions the user already has in ERPNext

자격 증명 저장: OAuth token stored by MCP client; rotate in ERPNext User settings

데이터 외부 송신: Direct from your ERPNext site to the LLM provider you've connected

절대 부여 금지: System Manager to the OAuth app unless genuinely needed Enable `execute_python_code` for non-admin users

AGPL-3.0 license — if you run Frappe Assistant Core as a network service, AGPL terms apply to any modifications.
Audit every tool call — ERPNext logs them; review weekly during rollout.

문제 해결

자주 발생하는 오류와 해결

OAuth redirect fails / invalid_client

Confirm the OAuth client is registered in ERPNext > OAuth Client and redirect URIs match your MCP client's callback exactly.

확인: Check `bench log` and the OAuth Client record

Tool says 'Permission denied' for a Doctype

The logged-in user lacks read/write role. Grant the appropriate role in User permissions.

확인: Try the same operation in the ERPNext web UI

Custom plugin tool not appearing

Run bench restart and ensure the app is installed on the site and hooks.py exposes the tool correctly.

확인: List tools from Claude — your custom tool should be present

ChatGPT custom connector rejects the endpoint

ChatGPT custom connectors require ChatGPT Plus with Developer Mode. Claude Desktop is more forgiving.

대안

Frappe_Assistant_Core 다른 것과 비교

대안	언제 쓰나	단점/장점
Direct REST API + custom MCP wrapper	You only need 2-3 operations and don't want to install a Frappe app	You build and maintain the wrapper yourself
Odoo MCP	You're on Odoo instead of ERPNext	Different ERP, different Doctypes

Frappe_Assistant_Core

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

설치

클라이언트 선택

사용 사례

실전 활용법: Frappe_Assistant_Core

Ask business questions against ERPNext in plain English

사전 조건

흐름

함정

Create or update documents in bulk from a brief

사전 조건

흐름

함정

Expose your custom Frappe app's logic as MCP tools

사전 조건

흐름

함정

조합

다른 MCP와 조합해 10배 효율

도구

이 MCP가 노출하는 것

비용 및 제한

운영 비용

보안

권한, 시크릿, 파급범위

문제 해결

자주 발생하는 오류와 해결

대안

Frappe_Assistant_Core 다른 것과 비교

더 보기

리소스