README.md•2.46 kB
# 🧩 MakeSync MCP Server
An advanced Model Context Protocol (MCP) server for Make.com, enabling intelligent patching, scenario management, and integration with automation workflows.
**Author**: Nadav Daniel
**License**: MIT
**Project Version**: 1.0.0
> 🧠 Originally inspired by Eduard Litau’s [`mcp-server-make-dot-com`](https://github.com/elitau/mcp-server-make-dot-com)
---
## 🧠 Project Overview
This server implements a powerful and extensible MCP interface for interacting with the [Make.com API](https://www.make.com/en/api-documentation). Unlike basic implementations, `MakeSync MCP Server` is **module-agnostic**, capable of reading and updating scenario blueprints based on their declared `metadata.parameters`, `interface`, and `expect` structure.
It supports:
- Reading scenarios and their structure.
- Smart, spec-compliant patching of any module.
- CLI and Claude Desktop usage.
- Safe blueprint patching using `confirm` logic.
- Configurable environment and TypeScript support.
---
## 🔧 Features
- ✅ Read live or draft blueprint of any scenario
- ✏️ Smart patching of module fields based on metadata spec
- 🛡 Confirm logic to safely update scenarios
- 🔍 Auto-wrap `{{...}}` mappers if missing
- 🧠 Agnostic patching across any module type
- 🧰 Compatible with Claude Desktop, local node, and GitHub workflows
---
## 📦 Tools
### `read_make_dot_com_scenario_blueprint`
- **Inputs**:
- `scenario_id` (number)
- `draft` (boolean, optional)
- **Output**: Full blueprint JSON
### `update_make_dot_com_scenario`
- **Inputs**:
- `scenario_id` (number)
- `name` / `description` (optional)
- `module_id` (optional): The module inside the flow to patch
- `operations` (optional): List of `{ path, value }` patch instructions
- `confirm` (boolean, default: `true`): Required for installing new apps
- **Behavior**:
- Applies all updates based on Make.com module structure
- Wraps `value` with `{{...}}` if appropriate
- Validates against module `interface` and `parameters` keys
---
## 🔑 Required API Key Scopes
Ensure your API key includes the following scopes:
agents:read apps:read connections:read datastores:read devices:read functions:read scenarios:read scenarios:run scenarios:write teams:read
## ⚙️ Configuration
### Option 1: Quick Setup with Claude Desktop
Run the provided setup script or use:
```bash
MAKE_DOT_COM_API_KEY=xxx npm install && npm run build
```