Quick Start Guide
Get up and running with MegaClaw V5 in under 5 minutes. Connect your first service and execute your first task via UI, REST API, Webhook, or MCP Server.
Prerequisites
Before you begin, make sure you have:
- ✓ A MegaClaw account (contact your Super Admin)
- ✓ Your tenant URL (e.g.
drx.megaclaw.de) - ✓ Your API key if using REST (format:
mc_xxxx)
Step 1 — Log in & explore
- 1
Open your tenant URL
Navigate to your company's MegaClaw URL and log in with your username and password. Demo:
demo / demo123 - 2
Choose your language
MegaClaw supports English 🇬🇧, German 🇩🇪, Arabic 🇸🇦, and French 🇫🇷 — select from the top navigation bar.
- 3
Go to Integrations or Service Catalog
Click Integrations in the sidebar. Or open Service Catalog for pre-built integrations — connect in 30 seconds with zero tokens.
Step 2 — Add an integration
Option A: Use Service Catalog (Recommended) — Pre-built integrations, no AI generation needed:
Open Service Catalog → Search for "Proxmox" → Click Connect → Enter credentials → Done in 30 seconds
Option B: Describe with AI — Click + New Integration and describe what you want to connect:
Connect to Proxmox VE API using API Token authentication Host: 192.168.1.50 Port: 8006 Node: pve
Step 3 — Run a task
Select your integration from the list, choose a task, and hit Run ▶. Or use REST API, Webhook, or MCP Server:
# Run node_status on Proxmox curl https://api.megaclaw.de/task/run \ -X POST \ -H "X-API-Key: mc_your_key" \ -H "Content-Type: application/json" \ -d '{"service_id":1,"task_id":"node_status","inputs":{}}'
# Same endpoint works from n8n, Zapier, Make, or any HTTP client POST https://api.megaclaw.de/webhook/trigger Header: X-API-Key: mc_your_key Body: {"service_id":1,"task_id":"node_status","inputs":{}}
# Configure Claude Desktop with: { "mcpServers": { "megaclaw": { "url": "mcp://mcp.megaclaw.de/mcp", "headers": { "X-API-Key": "mc_your_key" } } } } # Then ask Claude: "Show me Proxmox node status"
What's next?
→ Explore all new features (AI Providers, RAG Chat, Webhook, Audit Logs)
→ Full API Reference
→ Browse available integrations
→ Pricing & token system
Major Updates. Live Today.
Multi-AI Provider Support, Service Catalog, RAG Chat, Webhook, Audit Logs, and Flexible Scheduler.
🤖 Multi-AI Provider Support NEW
You now choose your AI engine — MegaClaw supports 4 providers:
📦 Service Catalog NEW
A curated library of pre-built integrations — ready to connect in seconds. No AI generation needed. No tokens consumed. Done in under 30 seconds.
💬 RAG Chat NEW
Most AI chatbots answer general questions. MegaClaw RAG Chat answers questions about YOUR systems. It reads your connected integrations in real time, then suggests exactly what to run — and executes it on your approval.
🧠 RAG AI Agent NEW
Stop searching through documents manually. Start asking questions — and getting real answers. Transform your documents into an intelligent knowledge base.
⚡ How it works:
✅ What makes it different:
- 🤖 Works with Claude, OpenRouter, Ollama, or Azure — your choice
- 🔒 100% self-hosted — your data never leaves your infrastructure
- 🏢 Multi-tenant architecture — each client has isolated data
- 🎯 No hallucinations — AI answers only from YOUR documents
- 📊 Tested on specialized medical & legal documents — accuracy is impressive
- 🆔 UUID accumulation — never overwrites old data, complete history
🔗 Webhook Support (n8n Integration) NEW
One endpoint. Unlimited automation. Trigger any MegaClaw task directly from n8n, Zapier, Make, or any HTTP client.
{ "service_id": 1, "task_id": "node_status", "inputs": {} }
{ "success": true, "output": "CPU: 4.47% · RAM: 61.6%" }
📋 Audit Logs NEW
Every action. Every user. Every timestamp. Nothing happens on MegaClaw without being recorded.
🔐 Security
- Login & Logout
- Password changes
- Role changes
- User activation/deactivation
⚡ Operations
- Connect service
- Delete integration
- Run task (with result & duration)
- Failed events filter
⏰ Scheduling
- Scheduled task added
- Scheduled task executed
- Schedule modified/deleted
⏰ Flexible Scheduler NEW
Schedule tasks the way you need:
API Reference
Full REST API + Webhook + MCP Server documentation. Base URL: https://api.megaclaw.de · Webhook: /webhook/trigger · MCP: mcp://mcp.megaclaw.de/mcp
Authentication
All requests must include your API key in the X-API-Key header.
X-API-Key: mc_your_api_key_here
drx cannot access data from sva.Rate Limits
Endpoints
Returns all connected services for the authenticated tenant.
Execute a task on a connected service. AI generates and runs the code automatically.
curl https://api.megaclaw.de/task/run -X POST -H "X-API-Key: mc_xxxx" -d '{"service_id":1,"task_id":"node_status"}'
Webhook endpoint for n8n, Zapier, Make, or any HTTP client. Same payload as /task/run. NEW
Get audit logs for your tenant (admin only). Filter by action type, date range, and user. NEW
Check current token balance for the authenticated tenant.
Get transaction history for token usage and recharge events.
Step 1 of the AI pipeline. Analyze a natural language request and get an execution plan.
Health check. Returns platform status and version. No auth required.
MCP Server Endpoint
Model Context Protocol endpoint for Claude Desktop, Claude Code, and MCP-compatible AI clients.
{ "mcpServers": { "megaclaw": { "url": "mcp://mcp.megaclaw.de/mcp", "headers": { "X-API-Key": "mc_your_api_key" } } } }
Error Codes
| Status | Meaning |
|---|---|
| 401 | Missing X-API-Key header |
| 403 | Invalid or inactive API key |
| 404 | Service or session not found |
| 429 | Rate limit exceeded (60/min per key or 100/min per IP) |
| 402 | Insufficient tokens — recharge required |
| 500 | Internal execution error |
Integrations Guide
Connect MegaClaw to your existing services. Each integration is added once and reused for unlimited tasks. All credentials are encrypted with AES-256.
🖥️ Proxmox VE
Manage VMs, containers, storage, and nodes via the Proxmox REST API with API Token authentication.
Required credentials
| Field | Description |
|---|---|
| proxmox_host | IP of your Proxmox node |
| proxmox_port | Always 8006 |
| api_token_id | Format: user@realm!tokenname |
| api_token_secret | Token secret UUID |
| node | Node name e.g. pve |
Available tasks
| task_id | Description |
|---|---|
| node_status | CPU, RAM, disk, uptime |
| list_vms | List all virtual machines |
| list_containers | List all LXC containers |
| start_vm / stop_vm | Start or stop a VM by VMID |
| restart_vm | Restart a VM |
| clone_vm | Clone a VM to new VMID |
| snapshot_vm | Create a snapshot |
| list_storage | List storage pools |
| next_vmid | Get next available VMID |
🔵 SAP BTP / HANA
Connect to SAP BTP APIs, SAP HANA on-premise via Cloud Connector, and SAP S/4HANA OData services.
🔄 n8n
Trigger and manage n8n workflows. List, execute, and monitor workflow status via REST API or Webhook.
🐘 PostgreSQL
Execute SQL queries, manage tables, and retrieve data from PostgreSQL databases.
🔒 SSH / Shell
Execute shell commands on remote Linux servers via SSH. Supports password and key-based auth.
🔍 LinkUp Search
Real-time web search. Returns structured results with titles, URLs, and summaries.
🎫 ServiceNow
Manage incidents, problems, change requests, and CMDB via natural language.
📋 Atlassian / Jira
Manage Jira issues and Confluence pages using natural language.
💬 Slack
Send messages, create channels, and manage Slack notifications directly from MegaClaw.
🗄️ Qdrant Vector DB
Perform semantic search, manage collections, and query vectors for AI-powered RAG applications.
🔐 OAuth2 Connect — One Click NEW
Connect any OAuth2 service in one click. No server configuration. No IT tickets. Customers connect themselves.
Supported out of the box:
How it works:
- 1
Settings → Connected Services
Customer opens settings and clicks "Connect New Service"
- 2
Enter Client ID + Secret
Credentials are stored encrypted with AES-256, per-tenant isolated
- 3
Click Connect
Browser OAuth2 login — customer approves access
- 4
Token saved — auto-refreshed forever
MegaClaw handles token refresh automatically. Always authenticated.
Then just type:
→ "Show my Google Calendar for today" → "List my GitHub repos" → "Send a Slack message to #general" → "Create a new email draft in Gmail"
Why this matters:
Every enterprise SaaS supports OAuth2. That means MegaClaw can now connect to virtually any business tool in existence — controlled entirely by the customer, without touching the server. This is self-service enterprise integration.
Full Automation Engine
Build complex automations with zero code. AI-native at every step. Competes with n8n and Zapier.
① Visual Workflow Builder
Build complex automations with zero code. Drag, drop, connect — no technical knowledge required.
② Full Control Flow
if/else on every step
auto-stop when conditions fail
reshape data between steps
wait before continuing
define and reuse values
iterate over full lists
halt at the right moment
fail gracefully with retry
③ AI Agent inside every Workflow
Every step can use Claude, OpenRouter, Ollama, or Azure. The AI reads the previous step's output and acts on it intelligently.
Step 1: HTTP Request → Fetch weather data Step 2: AI Agent (Claude) → "Write a professional Arabic weather report" Step 3: Telegram → Send the report
④ Real Example — Running Today
Set cities → Loop Damascus, Berlin, Paris → Fetch weather for each → Claude writes a professional Arabic report → Telegram delivers it → Every morning at 8AM automatically ☀️
⑤ Import / Export JSON
Share workflows across tenants in one file. The AI Chat builds the JSON for you — just ask.
⑥ Professional Run Logs
- Real duration — see exactly how long each run took
- Filter by status — success, failed, running
- Export CSV — download logs for analysis
- Delete old runs — keep your log clean
⑦ Retry + Timeout per step
The platform retries failed API calls automatically. Configure timeout per step for fine-grained control.
Plans, Tokens & Administration
MegaClaw uses a token-based model. Each AI task execution consumes tokens based on complexity. Bring Your Own Key (BYOK): Zero token deduction when using your own API key.
Plans
- 100,000 tokens/month
- Up to 5 integrations
- REST API + MCP + Webhook
- All AI providers + BYOK
- Service Catalog access
- RAG Chat
- Audit Logs (7 days)
- 500,000 tokens/month
- Up to 15 integrations
- REST API + MCP + Webhook
- All AI providers + BYOK
- Full Service Catalog
- RAG Chat + suggestions
- Audit Logs (30 days)
- Token dashboard
- 1,000,000 tokens/month
- Unlimited integrations
- REST API + MCP + Webhook
- All AI providers + BYOK
- Full Service Catalog
- RAG Chat + smart suggestions
- Audit Logs (90 days)
- Proxmox & SAP support
- Priority support
- Email + Telegram alerts
- Unlimited tokens
- Unlimited integrations
- Dedicated infrastructure
- On-premise deployment
- Custom integrations
- Unlimited audit log retention
- SLA + dedicated support
- Ollama private AI included
Token consumption
Tokens are consumed on each AI task execution. Viewing integrations or listing services is free.
Token Dashboard
Real-time usage tracking available in the Admin Panel:
- 📊 Current token balance
- 📈 Transaction history with timestamps
- 📧 Low-balance email alerts (automatically sent at 20%, 10%, and 5%)
- ✅ Recharge confirmation emails
API Key Management
Super Admins and Admins can manage API keys from the UI:
- 🔑 View all tenant API keys
- 🔄 Revoke compromised keys
- ✨ Generate new API keys
- 📝 Audit logging for key actions
Role-Based Access Control
MegaClaw supports four roles with granular permissions:
| Role | Permissions |
|---|---|
| Superadmin | Full system access, manage tenants, add tokens, view all data |
| Admin | Manage integrations, API keys, users within tenant |
| User | Execute tasks, view integrations, personal settings |
| Demo | Read-only access, cannot modify integrations or execute tasks |
Managing tokens (Admin)
Super Admins can add tokens from the Admin Panel:
Super Admin → Manage Tenants → Select Company → Add Tokens → Enter amount + plan → Save Token history records: amount, plan, added_by, timestamp System automatically sends: - Confirmation email to tenant admin - Low-balance alerts when threshold reached
FAQ
Can I buy tokens mid-month?
Yes. Contact your administrator or use the Super Admin panel. Unused tokens carry over.
What happens when tokens run out?
Task execution is paused. API calls return 402 Payment Required. Viewing services still works. Email alerts are sent automatically.
Is there a free trial?
New Starter accounts receive 1,000 tokens included. Contact alaa.alswedan@gmail.com to get started.
How do I use MCP with Claude?
Add the MCP server configuration to Claude Desktop. See the API Reference for configuration details.
Can I run AI locally?
Yes! MegaClaw supports Ollama for private, local AI execution with zero token consumption.