@zudello/mcp 1.1.2

package/README.md

@@ -0,0 +1,66 @@
+# Zudello MCP Server
+
+MCP server exposing 106 Zudello ERP automation tools for Claude Desktop and Claude Code.
+
+## Usage
+
+```bash
+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`):
+
+```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](./TOOL_CATALOG.md) for full reference.
+
+## Development
+
+```bash
+npm install
+npm run build
+npm run typecheck
+```
+
+See [CLAUDE.md](./CLAUDE.md) for architecture and patterns.
+
+## Publishing
+
+Auto-published to npm on push to `main` via GitHub Actions.