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 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.

Obtain an MCP token

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.

  4. 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, .

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

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

Access control

Usage with Cursor
Scenarios as tools access control

Make MCP Server

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.

How Make MCP server works

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.

  • View and modify teams and organizations.

Scopes determine the . Scenario run tools are available to all plans, and management tools are available to paid plans. You select scopes when you .

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 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 .

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 .

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

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 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.

https://mcp.make.com
https://<MAKE_ZONE>/mcp/u/<MCP_TOKEN>
https://<MAKE_ZONE>/mcp
Authorization: Bearer <MCP_TOKEN>

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.

{
    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.

tools available
connect Make MCP server to an MCP client
Make Skills
Connect using OAuth
Connect using an MCP token
inputs and outputs

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

Usage with Kiro

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

Prerequisites

  • Kiro

Connect to Kiro

To connect Make MCP server to Kiro:

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

  1. Hover over the MCP servers section and click the Open MCP Config icon.

  2. 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

You've now connected Make MCP server to Kiro.

section to check whether Make MCP server connected successfully.
{
  "mcpServers": {
    "make": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.make.com"
      ]
    }
  }
}

If you experience connection issues, use an instead.

MCP token URL

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.

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

If you experience connection issues, use an instead.

MCP token URL

Usage with Claude Code

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

Prerequisites

  • Claude Code account

  • Node.js

Connect to Claude Code

To connect Make MCP server to Claude Code:

  1. In your terminal, open a new tab.

  2. 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.

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

The response indicates whether your Make server connected successfully.
claude mcp add --transport http make https://mcp.make.com

If you experience connection issues, use an instead.

MCP token URL

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.

https://<MAKE_ZONE>/mcp

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.

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.

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.

https://<MAKE_ZONE>/mcp
{
  "mcpServers": {
    "make": {
      "url": "https://<MAKE_ZONE>/mcp",
      "headers": {
        "Authorization": "Bearer ${env:MCP_TOKEN}"
    }
  }
}

Usage with Warp

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

Prerequisites

  • Warp

Connect to Warp

To connect Make MCP server to Warp:

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

  2. Click Add.

  3. 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.

Usage with Gemini CLI

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

Prerequisites

  • Gemini CLI

  • Node.js

Connect to Gemini CLI

To connect Make MCP server to Gemini CLI:

  1. In your terminal, run the following command:

gemini mcp add make --scope user --transport http https://mcp.make.com

If you experience connection issues, use an instead.

  1. Run the Gemini command to start Gemini.

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

  3. Run /mcp auth make to initiate authentication.

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

Usage with ChatGPT

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

  • account

To connect Make MCP server to ChatGPT:

  1. Open the web version of ChatGPT.

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

In the OAuth consent screen, select your organization and scopes, then click Allow.
MCP token URL

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

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

Click Settings.

  • Go to Plugins and click Developer mode.

  • Toggle on Developer mode.

  • Go back to Plugins and click Browse plugins.

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

  • In the dialog, name your MCP server.

  • In Connection, enter the following URL:

    1. In Authentication, select OAuth.

    2. Agree to continue.

    3. Click Create.

    4. Click the sign-in button.

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

    6. Click Allow.

    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
    https://mcp.make.com

    If you experience connection issues, use an instead.

    MCP token URL

    Usage with ChatGPT

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

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

    Prerequisites

    • ChatGPT account (paid subscription)

    • MCP token

    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. In the top-right corner, click the plus sign next to Search plugins.

    8. In the dialog, name your MCP server.

    9. 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.

    Usage with Vapi

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

    • account

    To connect Make MCP server to Vapi:

    1. Open your Vapi account.

    Usage with Claude

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

    • account

    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.

    Click Connectors.

  • Click Discover.

  • Search for Make and click the + sign.

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

  • Click Allow to proceed.

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

    Prerequisites

    Connect to Claude

    Claude
    ChatGPT plugin directory
    https://<MAKE_ZONE>/mcp/u/<MCP_TOKEN>

    Navigate to Tools on the left sidebar.

  • Click the Create Tool button, then select MCP.

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

  • 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.

    Prerequisites

    Connect to Vapi

    Vapi
    MCP token
    https://<MAKE_ZONE>/mcp/u/<MCP_TOKEN>

    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

    Usage with OpenAI API

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

    Prerequisites

    • OpenAI Platform account and API key

    • MCP token

    Connect to OpenAI API

    To connect Make MCP server to the OpenAI API:

    1. Use the following configuration:

    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 the OpenAI API.

    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>"
            }
          }
        ]
      }'

    Usage with Windsurf

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

    Prerequisites

    • Windsurf account

    • Node.js

    Connect to Windsurf

    To connect Make MCP server to Windsurf:

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

    2. In Cascade, click the Open MCP Marketplace link next to MCP Servers.

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

    4. 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

    You've now connected Make MCP server to Windsurf.

    section to check whether Make MCP server connected successfully.
    {
      "mcpServers": {
        "make": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://mcp.make.com"
          ]
        }
      }
    }

    If you experience connection issues, use an instead.

    MCP token URL

    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.

    https://mcp.make.com

    If you experience connection issues, use an instead.

    MCP token URL

    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.

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

    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:

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

    https://mcp.make.com

    Connection URL

    If you experience connection issues, use an instead.

    Access control

    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 or higher to create user accounts assigned to specific teams.

    Usage with Claude
    MCP token URL
    Teams plan

    Usage with Claude Desktop

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

    Prerequisites

    • Claude Desktop account

    • MCP token

    Connect to Claude Desktop

    To connect Make MCP server to Claude Desktop:

    1. Open your Claude Desktop account.

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

    3. In Settings, navigate to Connectors.

    4. Click Add custom connector.

    5. 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.

     https://<MAKE_ZONE>/mcp/u/<MCP_TOKEN>