STRATEGIC OVERVIEW
Client Context & The Integration Deadlock The client runs hub-and-spoke distribution across North America, Western Europe, and Southeast Asia.
Client Context & The Integration Deadlock
The client runs hub-and-spoke distribution across North America, Western Europe, and Southeast Asia. SAP S/4HANA anchors orders and finance; a custom WMS handles high-velocity lanes; TMS tracks carrier events; ServiceNow-class ITSM manages exceptions. Dispatch supervisors touched six to eleven screens per stuck shipment.
Early copilots drafted emails but could not resolve exceptions—no governed tool execution existed. Inbound MCP proposals (public HTTPS into the DMZ) were rejected twice for lateral movement and weak audit attribution.
Citation anchor: In regulated logistics, the blocker is rarely model quality—it is provable containment. Auditors ask whether an agent can exfiltrate shipment data or write under another user's identity. Without outbound tunnels, per-tool schemas, and HITL on writes, architecture review stops the program.
Why Inbound MCP Exposure Failed Security Review
Security's red-team surfaced three show-stoppers familiar to AI agent ERP integration programs:
| Dimension | Inbound MCP (Rejected) | Outbound Private MCP Tunnel (Selected) |
|---|---|---|
| Firewall posture | New inbound allow rules per environment | Egress-only from MCP zone |
| Blast radius | DMZ compromise may pivot to internal APIs | Broker enforces schema + OIDC per call |
| Audit attribution | Shared service account in logs | Per-session agent JWT + supervisor HITL |
| Time to sign-off | Est. 9–14 weeks | Pilot approved in 4 weeks |
Target Architecture: Private MCP Mesh
The mesh has four planes:
- Orchestration — plans multi-step workflows, selects tools, enforces budgets.
- Tunnel — outbound SSE from enterprise MCP broker to orchestrator; no inbound initiation.
- Tool — on-prem MCP servers wrapping SAP OData, WMS REST, TMS events, ITSM tickets.
- Governance — OIDC for humans, machine identities for agents, immutable audit, HITL console for writes.
Exception Workflow: From Stuck Shipment to Resolved Ticket
Median resolution dropped from 4.2 hours to 38 minutes on 2,400 pilot exceptions.
Trigger: TMS publishes SHIPMENT_DELAYED to Kafka with order ID and lane.
Plan: Orchestrator decomposes into ERP holds, WMS pick status, ITSM search, and proposed carrier rebook.
Write tools (erp.release_credit_hold, wms.reallocate_inventory, itsm.update_ticket) require HITL approval.
Measured Outcomes & Before/After
| Metric | Before | After (Pilot) |
|---|---|---|
| Median exception resolution | 4.2 hours | 38 minutes |
| Manual copy-paste hours / month | ~1,200 | ~310 |
| Systems connected via governed tools | 0 | 14 |
| Critical policy violations (pilot window) | — | 0 |
Lessons for Platform & Engineering Leaders
- Treat enterprise MCP integration as outbound tunnel architecture, not "expose APIs to Claude."
- Version tool manifests in Git; security signs off on manifest diffs, not weekly firewall tickets.
- Bind agent identity → tool allow-list → prompt hash at the gateway to kill confused-deputy risk.
- Ship a two-week shadow study before broker code—swivel-chair tax quantifies ROI better than model benchmarks.
Frequently Asked Questions
How long did the pilot take?
Ninety days for scoped tools across two hubs, plus six weeks for broker hardening and HITL console UAT.
Did you use inbound MCP at all?
No public MCP endpoints. All connectivity is outbound-initiated from the enterprise MCP zone.
What orchestrator was used?
Hybrid Azure zone with vendor-neutral MCP manifests post-AAIF—details anonymized; pattern applies to any MCP-compliant host.
| Agent | Role | Current Task | Status | Tasks Done | Error Rate |
|---|---|---|---|---|---|
| Researcher-01 | Researcher | Contract clause extraction #247 | Running | 98 | 0.8% |
| Auditor-01 | Auditor | Compliance cross-check #246 | Running | 94 | 0.5% |
| Writer-01 | Writer | Legal summary generation #245 | Running | 55 | 1.1% |
| Researcher-02 | Researcher | — | Idle | 42 | 0.0% |
| Supervisor | Orchestrator | Routing #247-249 | Orchestrating | 247 | 0.2% |
| Name | Role | Model | Tools | Memory | Status | |
|---|---|---|---|---|---|---|
| Researcher-01 | Researcher | GPT-4o | PineconeSearch, DocParser | Long+Short | Active | |
| Auditor-01 | Auditor | Claude 3.5 Sonnet | ComplianceDB, RegCheck | Long+Short | Active | |
| Writer-01 | Writer | GPT-4o | DocGenerate, Template | Short only | Active | |
| Researcher-02 | Researcher | GPT-4o | PineconeSearch, WebSearch | Long+Short | Idle | |
| Supervisor | Orchestrator | GPT-4o (Router) | AllAgentBus | Session | Orchestrating |
| Task ID | Type | Priority | Assigned To | Queued | Status | |
|---|---|---|---|---|---|---|
#T-248 | Clause Extraction | P1 | Researcher-01 | 0m ago | Processing | |
#T-249 | Compliance Check | P2 | Auditor-01 | 1m ago | Processing | |
#T-250 | Legal Summary | P3 | Unassigned | 2m ago | Queued | |
#T-251 | Risk Assessment | P2 | Unassigned | 3m ago | Queued | |
#T-252 | Entity Extraction | P3 | Researcher-02 | 4m ago | Pending | |
#T-253 | Doc Generation | P3 | Writer-01 | 5m ago | Pending |
| Vector ID | Agent | Content Snippet | Similarity | Stored | Namespace |
|---|---|---|---|---|---|
v-89a3 | Researcher-01 | "Indemnification clause: Licensor shall defend…" | 0.97 | 2h ago | long-term |
v-76c1 | Researcher-01 | "Limitation of liability not to exceed 12 months…" | 0.94 | 3h ago | long-term |
v-55f2 | Auditor-01 | "GDPR Art.28 processor agreement required for…" | 0.91 | 5h ago | long-term |
v-34d8 | Researcher-01 | "Force majeure events include: pandemic, natural…" | 0.88 | 6h ago | long-term |
v-12b9 | Auditor-01 | "SOC 2 Type II audit evidence submitted Q3…" | 0.85 | 1d ago | long-term |
| Time | Agent | Tool | Input | Latency | Status |
|---|---|---|---|---|---|
| 09:14:24 | Researcher-01 | PineconeSearch | "indemnification clause" | 142ms | OK |
| 09:14:22 | Supervisor | AgentBus | route(task_248,researcher_01) | 8ms | OK |
| 09:11:18 | Researcher-01 | DocParser | contract_247.pdf | 1240ms | OK |
| 09:08:45 | Researcher-01 | PineconeSearch | "liability cap" | 138ms | OK |
| 09:05:31 | Auditor-01 | ComplianceDB | check_regulation(GDPR,Art28) | 298ms | OK |
| 09:02:10 | Writer-01 | DocGenerate | template=legal_summary | 520ms | OK |
| Tool | Agents | Rate Limit | Enabled |
|---|---|---|---|
| PineconeSearch | Researcher | 100/min | |
| DocParser | Researcher | 20/min | |
| ComplianceDB | Auditor | 50/min | |
| DocGenerate | Writer | 30/min | |
| WebSearch | Researcher | 10/min |
| Timestamp | Event | Agent | Task ID | Details | Hash |
|---|---|---|---|---|---|
| 09:14:24 | TOOL_CALL | Researcher-01 | #T-248 | PineconeSearch executed | a8f3b... |
| 09:14:22 | TASK_START | Supervisor | #T-248 | Task dispatched | c2e9d... |
| 09:08:12 | TASK_COMPLETE | Writer-01 | #T-247 | Output generated 2,100 tokens | f7a1c... |
| 09:05:31 | CORRECTION | Researcher-01 | #T-246 | Low confidence, retry #1 | 3b8e2... |
| 09:02:10 | TASK_COMPLETE | Writer-01 | #T-245 | Legal summary delivered | d9f4a... |
| 09:00:01 | AGENT_INIT | All | — | System startup | 1a7b3... |
