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