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