Zudello MCP Server

MCP server exposing 106 Zudello ERP automation tools for Claude Desktop and Claude Code.

Usage

npx @zudello/mcp

Configuration

Add to Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json) or Claude Code (~/.config/claude-code/mcp_servers.json):

{
  "mcpServers": {
    "zudello": {
      "command": "npx",
      "args": ["@zudello/mcp"],
      "env": {
        "ZUDELLO_TOKEN": "your_jwt_token",
        "ZUDELLO_ORGANIZATION": "your_org_uuid",
        "ZUDELLO_TEAM": "your_team_uuid",
        "ZUDELLO_CLUSTER_URL": "api.1.eur1.zudello.io",
        "AUTHENTICATION_API_BASE": "api.1.global.zudello.io"
      }
    }
  }
}

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | ZUDELLO_TOKEN | Yes | JWT token (starts with "eyJ") | | ZUDELLO_ORGANIZATION | Yes | Organization UUID | | ZUDELLO_TEAM | Yes | Team UUID | | ZUDELLO_CLUSTER_URL | No | API cluster (default: api.1.eur1.zudello.io) | | AUTHENTICATION_API_BASE | No | Org-level API (default: api.1.global.zudello.io) | | LOG_LEVEL | No | debug, info, warn, error (default: info) | | ZUDELLO_MCP_ALLOWED_TOOLS | No | Comma-separated tool whitelist |

Tools

106 tools across categories: core operations, model discovery, config management, automation, connections, admin, documents, org admin, and more.

• 65 read-only tools
• 41 write tools with approval metadata (low/medium/high risk)

See TOOL_CATALOG.md for full reference.

Development

npm install
npm run build
npm run typecheck

See CLAUDE.md for architecture and patterns.

Publishing

Auto-published to npm on push to main via GitHub Actions.