make_mcp CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

This is a fork of the official Make.com MCP (Model Context Protocol) server. It exposes Make.com on-demand scenarios as callable tools for AI assistants. The goal of this fork is to extend capabilities beyond running scenarios to include full scenario lifecycle management (create, edit, delete).

Commands

npm install      # Install dependencies (also runs build via prepare script)
npm run build    # Compile TypeScript to build/
npm run watch    # Watch mode for development
npm test         # Run all tests
npm run inspector # Launch MCP Inspector for debugging

Run a single test:

npx jest test/server.spec.ts -t "Should get list of scenarios"

Architecture

Core Flow

index.ts (MCP Server)
    ↓
make.ts (Make API Client)
    ↓
Make.com REST API (https://{zone}/api/v2/...)

Source Files

• src/index.ts - MCP server entry point. Registers two handlers:

  • ListToolsRequestSchema - Returns static management tools + dynamic run_scenario_{id} tools
  • CallToolRequestSchema - Dispatches to appropriate scenario method based on tool name

• src/make.ts - Make API client with Scenarios class for API calls:

  • list(teamId) - Get all scenarios for a team
  • listOrganization(organizationId) - Get all scenarios for an organization
  • interface(scenarioId) - Get input/output schema for a scenario
  • run(scenarioId, body) - Execute scenario in responsive mode
  • get(scenarioId) - Get full scenario details
  • create(request) - Create a new scenario
  • update(scenarioId, request) - Update scenario metadata/blueprint
  • delete(scenarioId) - Delete a scenario (with confirmation)
  • clone(scenarioId, request) - Clone an existing scenario
  • activate(scenarioId) - Activate scenario via /start endpoint
  • deactivate(scenarioId) - Deactivate scenario via /stop endpoint
  • getBlueprint(scenarioId, options) - Get scenario blueprint
  • setInterface(scenarioId, request) - Set scenario input interface
  • getIncompleteExecutions(scenarioId) - Get DLQ entries