convez.ai
MCP ServerIntegração & APIsAvançado
OpulentiaAI

OpulentAggro — MCP Server de STO Interempresas

OpulentiaAI/opulentaggro

41 ferramentas MCP para STO, faturamento IC e clearing interempresas no ERPNext

Ver no GitHub
InicialPluginScore · de 0 a 100

MCP server especializado em Transferências de Estoque (STO) interempresas para ERPNext, com suporte a faturamento IC, clearing de tesouraria, vendas triangulares e accruals. Integra-se via Vercel (gateway SSE) e stdio, fornecendo 41 ferramentas para automação de fluxos comerciais complexos em agronegócio.

Instalação

$npx convez-ai OpulentiaAI/opulentaggro

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
37%
Último commit
há 4 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Automação de Transferências de Estoque (STO) entre subsidiárias
  • Faturamento intercompany (IC) com three-way matching e accruals
  • Clearing de tesouraria e reconciliação triangular
  • Integração Cursor/Claude com ERPNext via MCP para decisões comerciais

Veredito

Solução especializada e bem-arquitetada para operações interempresas complexas em ERPNext. Exige conhecimento profundo de STO, IC billing e MCP; não é apropriada para casos simples de ERP, mas é robusta para agronegócios multi-entidade.

README

A tradução para o português deste README ainda está na fila.

OpulentAggro Intercompany STO

ERPNext fork + MCP server + Vercel desk for AgroFresh-style intercompany Stock Transfer Orders, IC billing, treasury clearing, triangular sales, and accruals.

Architecture

flowchart TB
  subgraph agents [Agents]
    Cursor[Cursor / Cloud Agent]
  end
  subgraph gateway [Vercel]
    UI["/app/* desk"]
    MCP["/api/mcp SSE"]
    API["/api/sto /api/ic"]
  end
  subgraph backend [Railway]
    ERP[ERPNext whitelisted APIs]
  end
  Cursor --> MCP
  Cursor -->|stdio| MCPlocal[erpnext-mcp-server]
  MCPlocal --> ERP
  MCP --> ERP
  API --> ERP
  UI --> API

Full flow map: docs/opulentaggro-flow-coverage.mdx

Agent skills

Skills follow Letta creating-skills and converting-mcps-to-skills patterns (progressive disclosure, MCP call → verify UI).

SkillPathPurpose
opulentaggro-sto-mcp.cursor/skills/opulentaggro-sto-mcp/Primary — 41 MCP tools, schemas, transports, workflows
opulentaggro-mcp-ui-e2e.cursor/skills/opulentaggro-mcp-ui-e2e/MCP + UI test harness, screenshots, env loading
opulentaggro-sto-navigation.cursor/skills/opulentaggro-sto-navigation/Desk routes, STO stages, Frappe REST
opulentaggro-vercel.cursor/skills/opulentaggro-vercel/Vercel deploy, API proxies
mcp-db-alignment.cursor/skills/mcp-db-alignment/Tool registry SSOT, seed parity
erpnext-sto-mcp.cursor/skills/erpnext-sto-mcp/Alias → opulentaggro-sto-mcp
mcp-e2e-testing.cursor/skills/mcp-e2e-testing/Alias → opulentaggro-mcp-ui-e2e

Agent instructions: AGENTS.md

MCP (41 tools)

GroupCountExamples
sto_*16sto_create, sto_three_way_match, sto_open_dispute
ic_* billing6ic_create_invoice_pair, ic_submit_invoice
ic_* extended8ic_match_and_clear, ic_triangular_sale, ic_create_accrual
Generic11get_document, call_method
TransportEndpointAuth
Stdioerpnext-mcp-server/build/index.jsERPNEXT_API_KEY+SECRET or ERPNEXT_NO_AUTH=1 (local)
Vercel SSE/api/mcpServer-side API token; optional MCP_AUTH_TOKEN

Env vars: ERPNEXT_URL, ERPNEXT_API_KEY, ERPNEXT_API_SECRET, MCP_AUTH_TOKEN, VERCEL_MCP_URL. Templates: config/demo-credentials.env.example, config/cloud-agent-remote.env.example.

Quick start — local MCP + UI test

cp config/demo-credentials.env.example config/demo-credentials.env
bash -lc 'source scripts/load_env.sh && ./scripts/start_all.sh && cd erpnext-mcp-server && npm run build && cd .. && ./scripts/verify_mcp_alignment.sh && ERPNEXT_NO_AUTH=1 python3 scripts/test_all_41_mcp_tools.py && ./scripts/test_local_mcp_ui_screenshots.sh'
  • ERPNext: http://localhost:8000
  • Vercel: http://localhost:3000
  • MCP: http://localhost:3000/api/mcp

Hosted stack

InterfaceURL
Vercel deskhttps://vercel-indol-phi-69.vercel.app
Vercel MCPhttps://vercel-indol-phi-69.vercel.app/api/mcp
Railway ERPNexthttps://erpnext-production-512a.up.railway.app

Latest validation: docs/local-mcp-ui-validation-report.md (33/33 PASS local).

Repo layout

PathPurpose
erpnext/ERPNext fork (STO module, Pierre theme)
erpnext-mcp-server/MCP server (41 tools)
vercel/Next.js desk + API gateway
docs/Setup, flow coverage, validation reports
scripts/Seed, E2E, alignment

Docs

Ver o original no GitHub

Bom para

Relacionados