ONE-MCP

MCP ONE

MCP server for the ONE Framework ERP — gives Claude autonomous access to explore your data model, run queries, and understand business logic.

Setup

1. Install dependencies

npm install

2. Configure

Copy .env.example to .env and fill in your instance details:

cp .env.example .env

ONE_URL=https://your-instance.oneerp.ro
ONE_API_KEY=your-api-key-here

3. Register with Claude Code (project-level)

The project already has a .mcp.json file. Update it with your credentials, then restart Claude Code.

Or manually add a project-level MCP server:

// .mcp.json (project root)
{
  "mcpServers": {
    "one": {
      "command": "npx",
      "args": ["tsx", "src/index.ts"],
      "cwd": "D:\\ONE-Projects\\MCP-ONE",
      "env": {
        "ONE_URL": "https://your-instance.oneerp.ro",
        "ONE_API_KEY": "your-api-key"
      }
    }
  }
}

Tools

Discovery & Reading

| Tool | Description | |------|-------------| | get_instance_info | Server version + authenticated user | | fetch_query | Execute FETCH queries (filter, link, aggregate) | | list_entities | Discover all entities in the system | | get_entity_schema | Full schema: properties + relationships | | get_entity_record | Read a single record by entity name + key |

Write Operations

| Tool | Description | |------|-------------| | create_entity_record | Create a new record ⚠️ | | update_entity_record | Update an existing record ⚠️ |

Workflows

| Tool | Description | |------|-------------| | list_workflows | Workflow definitions + event bindings | | get_workflow | Workflow source code + metadata | | execute_workflow | Run a workflow method with arguments |

Security

• No DELETE tool — the MCP does not expose a delete operation
• API key permissions are inherited from the associated user's roles — ensure the user has only View + Create/Update access in ONE
• All FETCH queries run under the security context of the authenticated user
• Create/Update tools require explicit user confirmation (MCP permission model)

Development

npm run dev        # Run with tsx (stdio transport)
npm run build      # Compile TypeScript
npm run typecheck  # Type checking only