HM

hallboys/mcp4acumatica

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。 原文を見る

20 stars 18 forks 品質 74 トレンド 30Apache-2.0

Acumatica ERPのMCPサーバー

概要

このプロジェクトは、独立したコミュニティ構築の統合であり、Acumaticaは、Acumatica, Inc.の登録商標です。 Acumatica 名と API の使用は、相互運用性のみを目的としています。 ClaudeをAcumatica ERP 2025 R2に接続するリモートモデルコンテキストプロトコル(MCP)サーバー。 Cloudflare Workers で、Acumatica インスタンスに対するユーザ OAuth 認証を実行します。 各ユーザーは、独自の Acumatica 認証情報を認証します。 彼らがアクセスできるレコードを記録する彼らのAcumaticaロール制御。 MCP サーバーには、アクセスのための特定の Acumatica の役割が別途必要です。, 同意の interstitial を表示し、データが AI モデルに達する前に、機密フィールドを自動的に赤字化します。.

概要(AI 翻訳)

免責事項: このプロジェクトは、独立したコミュニティ構築の統合であり、** Acumatica, Inc. が承認、承認、またはAcumatica, Inc. によってサポートされています。** Acumatica, Inc.の登録商標です。 Acumatica 名と API の使用は、相互運用性のみを目的としています。

ClaudeをAcumatica ERP 2025 R2に接続するリモートモデルコンテキストプロトコル(MCP)サーバー。 Cloudflare Workers で、Acumatica インスタンスに対するユーザ OAuth 認証を実行します。

各ユーザーは、独自の Acumatica 認証情報を認証します。 彼らがアクセスできるレコードを記録する彼らのAcumaticaロール制御。 MCP サーバーには、アクセスのための特定の Acumatica の役割が別途必要です。, 同意の interstitial を表示し、データが AI モデルに達する前に、機密フィールドを自動的に赤字化します。.

##特徴

  • ** 51 ツール** – 38 読み取り専用ルックアップ + 6 ユーティリティ/ディスカバリー + 4 スキーマ知識 + 2 ドキュメンテーション + 1 ドキュメンテーション ツール (顧客作成/更新, デフォルトで無効にし、クライアントから有効まで非表示) (利用可能なツールを参照してください) -Per-user OAuth – Acumatica 認証情報 (または SSO) でログイン
  • ロールベースアクセス – 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 のガイドから始めましょう →