JDE MCP Server

A Model Context Protocol (MCP) server that exposes JD Edwards (JDE) purchase order approval and sales order workflows to AI assistants like Claude. It acts as a bridge between Claude and the JDE backend through a Mulesoft API layer. A

Table of Contents

• Overview
• Architecture
• Prerequisites
• Configuration
  • Adding the MCP Server to Claude.ai
  • Adding the MCP Server to Claude Desktop
• Testing with MCP Inspector
• Authentication
• Available Tools
  • Purchase Order Tools
  • Sales Order Tools
• Usage Examples
• Error Handling

Overview

The JDE MCP Server allows Claude (or any MCP-compatible AI assistant) to interact with JD Edwards EnterpriseOne data in natural language. Currently supported modules:

• Purchase Orders — List pending POs, review details, approve or reject them.
• Sales Orders — Query customer credit and financial exposure information.

Architecture

User (Claude.ai / Claude Desktop)
      │
      ▼
Claude AI (MCP Client)
      │  MCP over Streamable HTTP
      ▼
JDE MCP Server (this application, port 8080)
      │  REST API calls
      ├──────────────────────────────┐
      ▼                              ▼
Mulesoft Purchase API           Mulesoft Sales Order API
(port 8081)                     (port 8083)
      │                              │
      ▼                              ▼
JD Edwards EnterpriseOne        JD Edwards EnterpriseOne

Prerequisites

Configuration

Adding the MCP Server to Claude.ai

1. Open Claude.ai and go to Settings → Integrations (or the Connectors section).
2. Click Add MCP Server.
3. Enter the server details:

4. Save and confirm the connection is active.

Local development with ngrok:
If running the server locally, expose it with:

ngrok http 8080

Then use the generated https://<random>.ngrok-free.app/mcp/message as the URL.

Adding the MCP Server to Claude Desktop

1. Open Claude Desktop and go to Settings → Developer → Edit Config.
2. This opens the file claude_desktop_config.json. Add the MCP server under mcpServers:

{
  "mcpServers": {
    "jde-atina": {
      "url": "http://localhost:8080/mcp"
    }
  }
}

If the server is remote or exposed via ngrok, replace the URL accordingly:

{
  "mcpServers": {
    "jde-atina": {
      "url": "https://<your-host>/mcp"
    }
  }
}

3. Save the file and restart Claude Desktop.
4. You should see the MCP tools (hammer icon) available in the chat input.

Pre-authenticated token (skip login)

To avoid calling jde_login on every conversation, you can pass a JDE token directly in the Claude Desktop config using the headers field. The server will pick it up automatically:

{
  "mcpServers": {
    "jde-atina": {
      "url": "http://localhost:8080/mcp",
      "headers": {
        "Authorization": "Bearer <your-jde-token>"
      }
    }
  }
}

With this configuration, all MCP tools work immediately without calling jde_login first. The server reads the Authorization header, stores the token for the session, and reuses it for all subsequen

... View full README on GitHub