
hallboys/mcp4acumatica
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
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 Accessis 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/adminfor 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 |
설치
npx wrangler kv namespace create TOKEN_STORE