Only this pageAll pages
Powered by GitBook
1 of 19

MCP Server

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Connect using OAuth

You can connect Make MCP server to clients using OAuth. This method uses a universal URL that doesn't require an MCP token.

Connection URL

To connect Make MCP server using OAuth, use the following URL:

If you experience connection issues, use an MCP token URL instead.

Access control

When you connect Make MCP server with an MCP client, you select the organization and scopes in the OAuth consent screen. Scopes determine the tools available to the MCP client.

Consent screen example:

The Run your scenarios scope gives AI access to all on-demand and active scenarios in an organization. To further limit access, you can upgrade to a Teams plan or higher to create user accounts assigned to specific teams.

To complete the connection, refer to the Usage page of your MCP client. For example, Usage with Claude.

Usage with Claude

This guide outlines how to connect Make MCP server to Claude using OAuth.

Prerequisites

  • Claude account

Connect to Claude

Make is a built-in connector on Claude. To connect Make MCP server to Claude:

  1. Open your Claude account.

  2. Go to Customize on the left sidebar.

  3. Click Connectors.

  4. Click Discover.

  5. Search for Make and click the + sign.

  6. In the OAuth consent screen, select an organization in Organization and its scopes.

  7. Click Allow to proceed.

You've now connected Make MCP server to Claude.

https://mcp.make.com

Usage with Cursor

This guide outlines how to connect Make MCP server to Cursor using OAuth.

Prerequisites

  • Cursor account (Desktop version)

Connect to Cursor

To connect Make MCP server to Cursor:

  1. Open your Cursor account.

  2. In the top-right corner, click the gear icon to open the Cursor Settings dialog.

  3. In the left sidebar, click Tools & Integrations (or Tools, if you're on the Free Plan).

  4. Under MCP Tools, click Add Custom MCP to open the editor for the mcp.json file.

  1. In the editor, add the configuration, using the following URL:

Configuration example:

  1. In MCP Tools, you'll see Make added as an MCP tool. Click Needs login.

  1. In the dialog, click Open, which opens an OAuth consent screen.

  2. In the Organization dropdown, select the organization that can access the server.

  3. Select its granted scopes.

  4. Click Allow, then Open Cursor.

You've now connected Make MCP server to Cursor.

Click Open to allow the extension to open the URI.

If you experience connection issues, use an MCP token URL instead.

https://mcp.make.com
{
  "mcpServers": {
    "make": {
      "url": "https://mcp.make.com"
    }
  }
}

Usage with OpenAI

This guide outlines how to connect Make MCP server to OpenAI using an MCP token.

Prerequisites

  • OpenAI Platform account

  • MCP token

Connect to OpenAI

To connect Make MCP server to OpenAI:

  1. In OpenAI's Playground, sign in to your OpenAI account.

  2. Navigate to Prompts.

  3. In Tools, click the + button.

  4. Select MCP Server.

  5. In the dialog, click Add new to display the form below.

  1. In URL, add the following URL:

Replace <MAKE_ZONE> with your actual values.

  • MAKE_ZONE : The zone your organization is hosted in. For example, eu2.make.com.

  1. In Label, name your Make MCP server.

  2. In Authentication, select Access token / API key.

  3. Add your MCP token to the field that requires an access token.

  4. Click Connect.

You've now connected Make MCP server to OpenAI.

Scenarios as tools access control

By default, the mcp:use scope of your MCP token allows AI systems to access all active and on-demand scenarios across all of your Make organizations.

To restrict access, add query parameters to the connection URL according to these levels:

  • Organization

  • Team

  • Scenario

https://<MAKE_ZONE>/mcp/u/<MCP_TOKEN>?organizationId=<id>

AI has access to all scenarios in the specified organization.

https://<MAKE_ZONE>/mcp/u/<MCP_TOKEN>?teamId=<id>

AI has access to all scenarios in the specified team.

https://<MAKE_ZONE>/mcp/u/<MCP_TOKEN>?scenarioId=<id>

AI has access to the specified scenario.

Make MCP Server

Make MCP server allows AI systems, such as large language models (LLMs), to run scenarios and manage your Make account. Model Context Protocol (MCP) is a communication standard between AI and external systems that enables safe interactions by defining endpoints and providing authentication.

AI systems like Claude and ChatGPT act as MCP clients of Make MCP server. The server gives them access to MCP tools that:

  • Run active and on-demand scenarios.

  • View and modify scenarios and their related entities, such as connections, webhooks, and data stores.

Connect using MCP token

You can connect Make MCP server to clients using a connection URL with an MCP token, a unique API token that you create in Make.

To obtain an MCP token:

  1. In the top-right corner of your Make account, click your name.

  2. Click Profile.

  3. Navigate to the API access tab.

Usage with OpenAI API

This guide outlines how to connect Make MCP server to the OpenAI API.

  • account and API key

To connect Make MCP server to the OpenAI API:

  1. Use the following configuration:

Usage with ChatGPT

This guide outlines how to connect Make MCP server with ChatGPT using an MCP token.

  • account (paid subscription)

To connect Make MCP server to ChatGPT:

  1. Open the web version of ChatGPT.

Usage with Claude Desktop

This guide outlines how to connect Make MCP server to Claude Desktop using an MCP token.

  • account

To connect Make MCP server to Claude Desktop:

  1. Open your Claude Desktop account.

Usage with Claude Code

This guide outlines how to connect Make MCP server to Claude Code using OAuth.

  • account

To connect Make MCP server to Claude Code:

  1. In your terminal, open a new tab.

Usage with Warp

This guide outlines how to connect Make MCP server to Warp using OAuth.

To connect Make MCP server to Warp:

  1. In Warp Drive, go to MCP Servers under Personal.

  2. Click

Usage with Gemini CLI

This guide outlines how to connect Make MCP server to Gemini CLI using OAuth.

To connect Make MCP server to Gemini CLI:

  1. In your terminal, run the following command:

The following information applies to scenario tools only and excludes management tools.

Organization level

Team level

Scenario level

Optionally, specify multiple values for any of the URLs using the following syntax: ?scenarioId[]=<id1>&scenarioId[]=<id2>

You can't combine multiple levels, as levels are mutually exclusive.

  • Replace <MAKE_ZONE> and <MCP_TOKEN> with actual values.

    • MAKE_ZONE : The zone your organization is hosted in. For example, eu2.make.com.

    • MCP_TOKEN: Your MCP token.

    You've now connected Make MCP server to the OpenAI API.

    Prerequisites

    Connect to OpenAI API

    OpenAI Platform
    MCP token
  • Run the Gemini command to start Gemini.

  • Run /mcp list to check if Make is among your configured MCP servers.

  • Run /mcp auth make to initiate authentication.

  • In the OAuth consent screen, select your organization and scopes, then click Allow.

  • You've now connected Make MCP server to Gemini CLI.

    Prerequisites

    Connect to Gemini CLI

    If you experience connection issues, use an MCP token URL instead.

    Gemini CLI
    Node.js

    Click on your profile name on the left sidebar.

  • Click Settings.

  • Go to Plugins and click Developer mode.

  • Toggle on Developer mode.

  • Go back to Plugins and click Browse plugins.

  • In the top-right corner, click the plus sign next to Search plugins.

  • In the dialog, name your MCP server.

  • In Connection, enter the following URL:

  • Replace <MAKE_ZONE> and <MCP_TOKEN> with your actual values.

    • MAKE_ZONE : The zone your organization is hosted in. For example, eu2.make.com.

    • MCP_TOKEN : Your MCP token.

    1. In Authentication, select No Auth.

    2. Agree to continue.

    3. Click Create.

    4. In the dialog, click Connect.

    You've now connected Make MCP server to ChatGPT.

    You can use the Make plugin to describe, build, run, and review scenarios without leaving ChatGPT. Install it from the ChatGPT plugin directory.

    Prerequisites

    Connect to ChatGPT

    ChatGPT
    MCP token

    Click your profile name on the left sidebar, then Settings.

  • In Settings, navigate to Connectors.

  • Click Add custom connector.

  • In the URL field, add the following URL:

    1. Replace <MAKE_ZONE> and <MCP_TOKEN> with your actual values.

    • MAKE_ZONE : The zone your organization is hosted in. For example, eu2.make.com.

    • MCP_TOKEN : Your MCP token.

    1. Click Add.

    You've now connected Make MCP server to Claude Desktop.

    Prerequisites

    Connect to Claude Desktop

    Claude Desktop
    MCP token
    https://<MAKE_ZONE>/mcp
    curl https://api.openai.com/v1/responses \
      -H "Content-Type: application/json" \
      -H "Authorization: Bearer $OPENAI_API_KEY" \
      -d '{
        "model": "gpt-4.1",
        "input": "List all available tools.",
        "tools": [
          {
            "type": "mcp",
            "server_label": "make",
            "server_url": "https://<MAKE_ZONE>/mcp",
            "headers": {
              "Authorization": "Bearer <MCP_TOKEN>"
            }
          }
        ]
      }'
    gemini mcp add make --scope user --transport http https://mcp.make.com
    https://<MAKE_ZONE>/mcp/u/<MCP_TOKEN>
     https://<MAKE_ZONE>/mcp/u/<MCP_TOKEN>

    View and modify teams and organizations.

    Scopes determine the tools available. Scenario run tools are available to all plans, and management tools are available to paid plans. You select scopes when you connect Make MCP server to an MCP client.

    Make Skills are Markdown files with instructions on building scenarios, configuring modules, and connecting to Make MCP server or third-party services.

    You can install them in MCP clients to connect to Make MCP server without setting up the connection manually and help clients reliably perform Make-specific tasks.

    For installation instructions, see Make Skills.

    Make MCP server is a Make-hosted, cloud-based server that runs via stateless Streamable HTTP.

    Connect it to MCP clients using OAuth or an MCP token. Alternatively, install Make Skills, which include connection details for Make MCP server.

    Use the following connection URL:

    For more information, see Connect using OAuth.

    The URL you use depends on whether your client supports adding the MCP token in Authorization headers.

    MCP token in URL

    Use the following connection URL, and replace <MAKE_ZONE> and <MCP_TOKEN> with actual values:

    • MAKE_ZONE: The zone your organization is hosted in. For example, eu2.make.com.

    • MCP_TOKEN: Your MCP token. To obtain one, see Connect using an MCP token.

    Optionally, append the following query parameter to the URL to set the tool name length:

    • ?maxToolNameLength=<length>: Generated tool names have a maximum length of 56 characters by default, to be compatible with most AI systems. Use this parameter to set a different maximum length. The allowed range is 32 to 160 characters.

    MCP token in header

    If you add the MCP token in an Authorization header, use the following URL:

    Specify the MCP token in the Authorization header:

    MCP tools are functions on Make MCP server that MCP clients call to interact with Make, such as running scenarios or updating data stores.

    You can view the tools on Make MCP server in a few ways:

    Method
    Action
    Shown

    MCP client settings

    In your MCP client's connector settings, select Make MCP server.

    Tool names, and in some clients, descriptions and categories

    MCP client command

    In your MCP client, run its MCP command, for example /mcp in Claude Code, then select Make MCP server and a tool.

    Tool calls from MCP clients to Make MCP server have a timeout for returning output. Limits depend on the tool type and connection method.

    Scenario run tools

    • https://mcp.make.com (OAuth): 25 seconds

    • https://<MAKE_ZONE>/mcp/u/<MCP_TOKEN> (MCP token): 40 seconds

    Management tools

    • https://mcp.make.com (OAuth): 30 seconds

    • https://<MAKE_ZONE>/mcp/u/<MCP_TOKEN> (MCP token): 60 seconds

    Retrieve outputs after timeout

    If a scenario run tool call times out, the scenario continues running in Make for up to 40 minutes. The timeout response includes an executionId that an MCP client can use to get the output after the scenario finishes.

    Example response:

    Select the scenarios:read scope to allow an MCP client to retrieve outputs after a timeout once a scenario run finishes.

    When an MCP client uses a scenario as a tool, it refers to the scenario's inputs and outputs to know what data to send and what it gets back:

    • Inputs are parameters that an MCP client fills with data when the scenario runs.

    • Outputs are data the scenario returns to the MCP client.

    Make MCP server

    How Make MCP server works

    https://mcp.make.com
    https://<MAKE_ZONE>/mcp/u/<MCP_TOKEN>
    https://<MAKE_ZONE>/mcp
    Authorization: Bearer <MCP_TOKEN>
    {
        instruction: 'The Tool execution has started, but did not complete yet. Use a corresponding Tool for getting Execution Results to check for the result asynchronously.',
        executionId: '4eb841b3fe3d48a5b2b59e2eed3f55be',
        scenarioId: 1,
    },

    Make Skills

    Connection methods

    OAuth

    MCP token

    Optionally, to control which scenarios are available as tools through your MCP token, see Scenarios as tools access control.

    MCP tools

    View available tools

    Tool call timeout limits

    Scenario inputs and outputs

    Write detailed scenario descriptions to help MCP clients understand what each scenario does and get more reliable results.

    In Tokens, click Add token, which opens a dialog.

    1. Select your desired scopes, including the mcp:use scope if you want to make your scenarios available as tools.

    2. In Label, name your API token.

    3. Click Add.

    You've now obtained an MCP token for your client. Include this token in the connection URL.

    To complete the connection, refer to the Usage page of your MCP client. For example, Usage with Cursor.

    To control which scenarios are available as tools through your MCP token, see Scenarios as tools access control.

    Obtain an MCP token

    An MCP token is a secret key. Treat it as sensitive information and share it only with trusted parties.

    Access control

    Run the following command:

    1. Run the command Claude.

    2. Run /mcp to connect to available MCP servers.

    3. In the OAuth consent screen in the new browser window, select your organization and scopes.

    4. The response indicates whether your Make server connected successfully.

    You've now connected Make MCP server to Claude Code.

    Prerequisites

    Connect to Claude Code

    Claude Code
    Node.js
    claude mcp add --transport http make https://mcp.make.com

    If you experience connection issues, use an instead.

    Add.
  • Enter the following configuration:

    1. Click Save and wait for Make MCP server to connect.

    2. In the OAuth consent screen, select your organization and scopes, then click Allow.

    You've now connected Make MCP server to Warp.

    Prerequisites

    Connect to Warp

    Warp
    {
      "make": {
        "url": "https://mcp.make.com"
      }
    }

    If you experience connection issues, use an instead.

    Usage with ChatGPT

    This guide outlines how to connect Make MCP server to ChatGPT using OAuth.

    You can use the Make plugin to describe, build, run, and review scenarios without leaving ChatGPT. Install it from the .

    Prerequisites

    • ChatGPT account

    Connect to ChatGPT

    To connect Make MCP server to ChatGPT:

    1. Open the web version of ChatGPT.

    2. Click on your profile name on the left sidebar.

    3. Click Settings.

    4. Go to Plugins and click Developer mode.

    5. Toggle on Developer mode.

    6. Go back to Plugins and click Browse plugins.

    7. Click the plus sign next to Search plugins in the top-right corner.

    8. In the dialog, name your MCP server.

    9. In Connection, enter the following URL:

    1. In Authentication, select OAuth.

    2. Agree to continue.

    3. Click Create.

    4. Click the sign-in button.

    You've now connected Make MCP server to ChatGPT.

    Usage with Vapi

    This guide outlines how to connect Make MCP server to Vapi.

    Prerequisites

    • Vapi account

    • MCP token

    Connect to Vapi

    To connect Make MCP server to Vapi:

    1. Open your Vapi account.

    2. Navigate to Tools on the left sidebar.

    3. Click the Create Tool button, then select MCP.

    4. Configure the tool name and describe when to use the tool.

    5. In Server URL, add the following URL:

    1. Replace <MAKE_ZONE> and <MCP_TOKEN> with your actual values.

    • MAKE_ZONE : The zone your organization is hosted in. For example, eu2.make.com.

    • MCP_TOKEN : Your MCP token.

    1. In Timeout, enter an appropriate timeout for your use case.

    2. In MCP Settings, select Streamable HTTP.

    3. Click Save.

    You've now connected Make MCP server to Vapi.

    Usage with Cursor

    This guide outlines how to connect Make MCP server to Cursor using an MCP token.

    Prerequisites

    • Cursor account (Desktop version)

    • MCP token

    Connect to Cursor

    To connect Make MCP server to Cursor:

    1. Open your Cursor account.

    2. In the top right, click the gear icon to open the Cursor Settings dialog.

    3. In the left sidebar, click Tools & Integrations (or Tools, if you're on the Free Plan).

    4. Under MCP Tools, click Add Custom MCP to open the editor for the mcp.json file.

    5. In the editor, add the configuration.

    Use the following URL:

    Configuration example:

    1. Replace <MAKE_ZONE> and <MCP_TOKEN> with actual values.

    • MAKE_ZONE : The zone your organization is hosted in. For example, eu2.make.com.

    • MCP_TOKEN : Your MCP token.

    You've now connected Make MCP server to Cursor.

    Usage with Kiro

    This guide outlines how to connect Make MCP server to Kiro using OAuth.

    To connect Make MCP server to Kiro:

    1. In Kiro, click the ghost icon on the left sidebar.

    Usage with Windsurf

    This guide outlines how to connect Make MCP server to Windsurf using OAuth.

    • account

    To connect Make MCP server to Windsurf:

    1. In Windsurf, click the Settings icon in the top-right corner, and select

    Tool names, descriptions, and schemas

    MCP Inspector

    In a terminal, run npx @modelcontextprotocol/inspector --cli https://<MAKE_ZONE>/mcp --transport http --header "Authorization: Bearer <MCP_TOKEN>".

    Tool names, descriptions, and schemas

    tools/list request

    In your app or agent's code, send a tools/list request to Make MCP server, or use an SDK method, such as list_tools() (Python) or listTools() (TypeScript).

    Tool names, descriptions, and schemas

    Prompt in AI assistant

    In your MCP client's chat, ask something like "What tools do you have from Make MCP server?"

    Tool names and descriptions

    MCP token URL
    MCP token URL

    In the OAuth consent screen, select your organization and its scopes.

  • Click Allow.

  • If you experience connection issues, use an MCP token URL instead.

    ChatGPT plugin directory

    MCP tool calls from Vapi Assistants may exceed Make API rate limits and result in errors. To check the Make API rate limit defined in your plan, see Make API rate limits.

    https://mcp.make.com
    https://<MAKE_ZONE>/mcp/u/<MCP_TOKEN>
    https://<MAKE_ZONE>/mcp
    {
      "mcpServers": {
        "make": {
          "url": "https://<MAKE_ZONE>/mcp",
          "headers": {
            "Authorization": "Bearer ${env:MCP_TOKEN}"
        }
      }
    }
    Hover over the MCP servers section and click the Open MCP Config icon.
  • In the mcp.json configuration, add the following:

    1. Enter Ctrl + S (Windows) or Cmd + S (Mac) to save. The OAuth consent screen opens in a new browser window.

    2. In the consent screen, select your organization and scopes, then click Allow.

    3. Go back to the MCP servers section to check whether Make MCP server connected successfully.

    You've now connected Make MCP server to Kiro.

    Prerequisites

    Connect to Kiro

    Kiro
    {
      "mcpServers": {
        "make": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://mcp.make.com"
          ]
        }
      }
    }

    If you experience connection issues, use an instead.

    Windsurf Settings
    .
  • In Cascade, click the Open MCP Marketplace link next to MCP Servers.

  • In Installed MCPs, click the Settings icon to open the mcp.config.json configuration file.

  • Add the following configuration:

    1. Enter Ctrl + S (Windows) or Cmd + S (Mac) to save. The OAuth consent screen opens in a new browser window.

    2. In the consent screen, select your organization and scopes, then click Allow.

    3. Return to the Installed MCPs section to check whether Make MCP server connected successfully.

    You've now connected Make MCP server to Windsurf.

    Prerequisites

    Connect to Windsurf

    Windsurf
    Node.js
    {
      "mcpServers": {
        "make": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://mcp.make.com"
          ]
        }
      }
    }

    If you experience connection issues, use an instead.

    Usage with Mistral AI

    This guide outlines how to connect Make MCP server to Mistral AI's Le Chat using OAuth.

    Prerequisites

    • Mistral AI account

    Connect to Mistral AI

    To connect Make MCP server to Mistral AI:

    1. Open Mistral AI and go to Le Chat.

    2. Click Intelligence in the left sidebar and select Connectors.

    3. Click Add Connector on the right side.

    4. Go to the Custom MCP Connector tab.

    5. In Connector Name, name your MCP server to identify it later, for example, "Make."

    6. In Connector Server, enter the following URL:

    1. In Authentication Method, select OAuth2.1 from the dropdown.

    2. Click Connect.

    3. In the OAuth consent screen, select the organization in Organization and its scopes.

    4. Click Allow to proceed.

    You've now connected Make MCP server to Mistral AI.

    MCP token URL
    MCP token URL
    https://mcp.make.com

    If you experience connection issues, use an instead.

    MCP token URL