HM

hallboys/mcp4acumatica

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

20 stars 18 forks 품질 74 트렌드 30Apache-2.0

Acumatica ERP를 위한 MCP 서버

개요

이 프로젝트는 독립적 인 커뮤니티 구축 통합이며 "Acumatica"는 Acumatica, Inc의 등록 상표입니다. Acumatica 이름과 API의 사용은 상호 운용성 목적으로만 사용됩니다. Acumatica ERP 2025 R2에 Claude를 연결하는 먼 모형 Context 의정서 (MCP) 서버. Acumatica 인스턴스에 대한 per-user OAuth 인증으로 Cloudflare Workers에서 실행합니다. 각 사용자는 자신의 Acumatica 자격 증명을 인증합니다. 그들의 Acumatica 역할은 그들이 접근할 수 있는 기록을 통제합니다. MCP 서버는 추가적으로 접근을 위한 특정한 Acumatica 역할을 요구하고, 동의 interstitial를 보여주고, 자료의 앞에 과민한 분야는 AI 모형을 도달합니다.

개요(AI 번역)

** 면책 조항:** 이 프로젝트는 독립적 인 커뮤니티 구축 통합이며 ** 제휴, 승인 또는 Acumatica, Inc.** "Acumatica"가 Acumatica, Inc.의 등록 상표입니다. Acumatica 이름과 API의 사용은 상호 운용성 목적으로만 사용됩니다.

Acumatica ERP 2025 R2에 Claude를 연결하는 먼 모형 Context 의정서 (MCP) 서버. Acumatica 인스턴스에 대한 per-user OAuth 인증으로 Cloudflare Workers에서 실행합니다.

각 사용자는 자신의 Acumatica 자격 증명을 인증합니다. 그들의 Acumatica 역할은 그들이 접근할 수 있는 기록을 통제합니다. MCP 서버는 추가적으로 접근을 위한 특정한 Acumatica 역할을 요구하고, 동의 interstitial를 보여주고, 자료의 앞에 과민한 분야는 AI 모형을 도달합니다.

특징

  • 51 도구 – 38 읽기 전용 조회 + 6 유틸리티 / 발견 + 4 schema-knowledge + 2 문서 + 1 쓰기 도구 (고객 생성 / 업데이트, 기본적으로 비활성화 및 클라이언트에서 숨겨진 가능) (사용 가능한 도구 참조) -Per-user OAuth – 사용자가 Acumatica credentials (또는 SSO)로 로그인
  • **Role 기반 액세스 ** – Acumatica의 보안 모델은 각 사용자가 볼 수 있는 것

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

MCP4Acumatica

Disclaimer: This project is an independent, community-built integration and is not affiliated with, endorsed by, or supported by Acumatica, Inc. “Acumatica” is a registered trademark of Acumatica, Inc. Use of the Acumatica name and API is for interoperability purposes only.

A remote Model Context Protocol (MCP) server that connects Claude to Acumatica ERP 2025 R2. Runs on Cloudflare Workers with per-user OAuth authentication against your Acumatica instance.

Each user authenticates with their own Acumatica credentials. Their Acumatica role controls which records they can access. The MCP server additionally requires a specific Acumatica role for access, shows a consent interstitial, and automatically redacts sensitive fields before data reaches the AI model.

Features

  • 51 tools – 38 read-only lookups + 6 utility/discovery + 4 schema-knowledge + 2 documentation + 1 write tool (Customer create/update, disabled by default and hidden from clients until enabled) (see Available Tools)
  • Per-user OAuth – users log in with their Acumatica credentials (or SSO)
  • Role-based access – Acumatica’s security model governs what each user sees
  • Access gate – only users who can read a designated canary Generic Inquiry can connect (restrict it however you like; a marker role such as MCP Access is the recommended way)
  • Consent interstitial – users must acknowledge AI data processing before accessing tools
  • Sensitive field redaction – SSN, bank accounts, salary, and other PII fields are automatically redacted before data leaves the server
  • Rate limiting – 3 concurrent requests and 40 requests/minute per user by default, both adjustable from the admin console. A request that finds all slots busy waits briefly for one instead of failing outright, and a rejection returns a structured { error: "rate_limited", retryAfterSeconds, actionRequired } envelope telling the AI exactly how long to wait rather than to retry in a loop
  • Pagination refusal – list/query tools return a structured { truncated, paginationSupported: false, actionRequired } envelope when results hit the record cap, instructing the AI to ask the user for a narrower filter rather than calling the tool again
  • Structured audit logging – all tool invocations, auth events, and field redactions are logged
  • Admin console – web-based admin interface at /docs/admin for viewing logs and managing runtime settings without redeploying
  • Long-term log retention – R2-backed log storage via Cloudflare Logpush with searchable log viewer

Architecture

Claude (claude.ai / Desktop / API)
    |
    v  MCP over streamable-http
+----------------------------------+
|  Cloudflare Worker               |
|  OAuth 2.1 Provider              |
|    /authorize -> Acumatica login |
|    /callback  <- Acumatica       |
GitHub에서 전체 README 보기

설치

npx wrangler kv namespace create TOKEN_STORE
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →