In your terminal, run the following command, depending on your transport method:
Streamable HTTP
If you experience connection issues, you can add /stateless or /stream to the end of your connection URL.
Server-Sent Events (SSE)
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.
You have now connected Make MCP server to Gemini CLI.
Call tools on Gemini CLI
You can call Make MCP tools in Gemini CLI:
Enter a question related to your connected Make MCP tools.
Grant permission for the suggested tool.
Gemini CLI calls the relevant tool and responds to your question.
Usage with Claude Desktop
This guide outlines how to connect Make MCP server with Claude Desktop using OAuth.
Prerequisites
Claude Desktop account (paid subscription)
Usage with Windsurf
This guide outlines how to connect Make MCP server with Windsurf using OAuth.
Prerequisites
Usage with Cursor
This guide outlines how to connect Make MCP server with Cursor using OAuth.
Prerequisites
Cursor account (Desktop version)
Installation
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
Installation
Connect using OAuth
You can connect Make MCP server to MCP clients using OAuth.
OAuth is recommended due to its simple and secure setup, with a universal URL that eliminates the need to configure the URL with an MCP token.
Connection URL
To connect Make MCP server using OAuth, use this URL for Stateless HTTP Streamable:
Connect using MCP token
You can connect Make MCP server to a client using an MCP token in the connection URL. An MCP token is an API token that you create in Make for adding Make MCP server to an MCP client.
Obtain MCP token
To obtain an MCP token:
In the OAuth consent screen, select your organization and scopes, then click Allow.
To connect Make MCP server to Mistral AI:
Open Mistral AI and go to Le Chat.
Click Intelligence in the left sidebar and select Connectors.
Click Add Connector on the right side.
Go to the Custom MCP Connector tab.
In Connector Name, name your MCP server to identify it later, for example, "Make."
In Connector Server, add the following URL:
If you experience connection issues, you can add /stateless or /stream to the end of your connection URL. For SSE, add /sse instead.
In Authentication Method, select OAuth2.1 from the dropdown.
Click Connect.
In the OAuth consent screen, select the organization in Organization and its granted scopes.
Click Allow to proceed.
You've now connected Make MCP server to Mistral AI.
To use it in a chat, click your Make MCP server in the Connectors section, then click New Chat.
gemini mcp add make --scope user --transport http https://mcp.make.com
gemini mcp add make --scope user --transport sse https://mcp.make.com/sse
https://mcp.make.com
Installation
To connect Make MCP server to Claude Desktop:
Open your Claude Desktop account.
Click your profile name on the left sidebar, then Settings.
In Settings, navigate to Connectors.
Click Add custom connector, which opens a dialog.
In the URL field, add the following URL:
If you experience connection issues, you can add /stateless or /stream to the end of your connection URL. For SSE, add /sse instead.
In Connectors, find Make and click Connect.
In the OAuth consent screen, select the organization in Organization and its granted scopes.
Click Allow to proceed.
You've now connected Make MCP server to Claude Desktop.
Installation
To connect Make MCP server to Windsurf:
In Windsurf, click the Settings icon in the top-right corner, and select 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:
If you experience connection issues, you can add /stateless or /stream to the end of the connection URL.
Enter Ctrl + S (Windows) or Cmd + S (Mac) to save. The OAuth consent screen opens in a new browser window.
In the consent screen, select your organization and scopes, then click Allow.
Return to the Installed MCPs section to check whether Make MCP server connected successfully.
You have now connected Make MCP server to Windsurf.
Call tools on Windsurf
You can call Make MCP tools in the chat:
Click the Toggle Cascade Side Bar icon in the top-right corner, or enter Ctrl+Alt+B (Windows) or Cmd+Option+B (Mac).
Enter a question related to your connected Make MCP tools.
Windsurf calls the relevant tool and responds to your question.
On the upper right-hand side, click the gear icon to open the Cursor Settings dialog.
In the left sidebar, click Tools & Integrations (or Tools, if you're on the Free Plan).
Under MCP Tools, click Add Custom MCP to open the editor for the mcp.json file.
In the editor, add the configuration.
Use the following URL:
Configuration example:
If you experience connection issues, you can add /stateless or /stream to the end of your connection URL. For SSE, add /sse instead.
In MCP Tools, you'll see Make added as an MCP tool. Click Needs login.
In the dialog, click Open, which opens an OAuth consent screen.
In the Organization dropdown, select the organization that can access the server.
Select its granted scopes.
Click Allow, then Open Cursor.
Click Open to allow the extension to open the URI.
You have now connected Make MCP server to Cursor.
If you experience connection issues, you can add /stateless or /stream to the end of the URL. If your client only supports SSE, add /sse instead.
Access control
While connecting Make MCP server with an MCP client, you will select the organization and granted scopes in the OAuth consent screen. Scopes determine the tools available to the MCP client.
Consent screen example:
The Run your scenarios scope provides access to all on-demand and active scenarios within a specific organization.
For more granular control, a Teams plan or higher allows you to limit scenario access to specific teams in your organization, as you can create user accounts that have access only to particular teams.
To complete the connection, refer to the Usage page of your MCP client (e.g., Usage with Cursor).
In the top-right corner of your Make account, click your name.
Click Profile.
Navigate to the API access tab.
In Tokens, click Add token, which opens a dialog.
Select your desired scopes, including the mcp:use scope if you want to make your scenarios available as tools.
In Label, name your API token.
Click Add.
You have now generated an MCP token for your MCP client. Include this token in the connection URL. To complete the connection, refer to the Usage page of your MCP client (e.g., Usage with Cursor).
An MCP token is a secret key. Treat it as sensitive information and share it only with trusted parties.
On the upper right-hand side, click the gear icon to open the Cursor Settings dialog.
In the left sidebar, click Tools & Integrations (or Tools, if you're on the Free Plan).
Use the following URL, with your zone embedded in the URL:
Configuration example:
If you experience connection issues, you can add /stream instead of /stateless to the end of your connection URL. For SSE, add /sse instead.
Replace <MAKE_ZONE> and <MCP_TOKEN> with your actual values.
MAKE_ZONE - The zone your organization is hosted in (e.g., eu2.make.com).
MCP_TOKEN - You can generate your MCP token in your Make profile.
You have now connected Make MCP server to Cursor.
Make MCP Server
Make MCP server allows AI systems, such as large language models (LLMs), to run scenarios and manage the contents of your Make account. Model Context Protocol (MCP) is a communication standard between AI and external systems. It enables safe interactions by defining endpoints and providing authentication.
Benefits
Creates bidirectional communication between AI and Make
Allows AI to access and manage elements of your Make account
Usage with ChatGPT
This guide outlines how to connect Make MCP server with ChatGPT using an MCP token.
Prerequisites
ChatGPT account (paid subscription)
https://<MAKE_ZONE>/mcp/stateless
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. If you want to restrict access, append query parameters to the connection URL according to these levels:
Organization
Team
Scenario
Scenarios must be active with on-demand scheduling to be discoverable as MCP tools.
The following applies only to scenario tools, and excludes management tools and other tool types.
Turns your active and on-demand scenarios into callable tools for AI
How Make MCP server works
AI systems like Claude and ChatGPT act as MCP clients of Make MCP server. The server provides them access to scenario run and management tools that enable the following actions:
Run active and on-demand scenarios
View and modify scenarios and their related entities (e.g., connections, webhooks, and data stores)
View and modify teams and organizations
When you connect Make MCP server to an MCP client, your selected scopes determine the callable tools available on the server.
Scenario run (Run your scenarios) toolsare available to all plans, and management (View and modify...) tools are available to paid plans.
Scenario inputs and outputs
When using scenarios as MCP tools, define scenario inputs and outputs to help AI understand what data to receive and send:
Inputs: parameters that AI fills with data when the scenario runs
Outputs: data returned from the scenario to your AI
Detailed scenario descriptions are strongly recommended. They help your AI understand the purpose of the scenario and improve the reliability of your prompts.
Available transport methods
Make MCP server is a cloud-based server hosted by Make, running via Streamable HTTP and Server-Sent Events (SSE).
Clients with Stateless Streamable HTTP support
Stateless Streamable HTTP is Make's default transport method due to its connection reliability. It is recommended when connecting to MCP clients that support Streamable HTTP.
Use the following connection URLs, depending on your connection type:
OAuth
MCP token
In the above configuration, replace <MAKE_ZONE> and <MCP_TOKEN> with your actual values.
MAKE_ZONE - The zone your organization is hosted in (e.g., eu2.make.com).
MCP_TOKEN - You can generate your MCP token in your Make profile.
To control which scenarios are available as tools through your MCP token, see .
Optionally, you can append the following advanced query parameters to the URL for a more customized experience:
?maxToolNameLength=<length> - By default, generated tool names are cropped to a maximum of 56 characters to ensure compatibility with most AI systems. You can customize this behavior by specifying the maximum generated tool name length using this parameter. The allowed range is 32 to 160 characters.
Authorization in headers support
If your client supports sending authorization in HTTP headers, you can use the following URL:
Specify the MCP token in the Authorization header as follows:
Clients with Streamable HTTP support
If your MCP client supports Streamable HTTP, you can use /stream at the end of the connection URL specified for your chosen connection type (OAuth or MCP token).
Clients with Server-Sent Events (SSE) support
If your MCP client supports SSE, use the following connection URLs, depending on your connection type:
OAuth
MCP token
In the above configuration, replace <MAKE_ZONE> and <MCP_TOKEN> with your actual values.
MAKE_ZONE - The zone your organization is hosted in (e.g., eu2.make.com).
MCP_TOKEN - You can generate your MCP token in your Make profile.
To control which scenarios are available as tools through your MCP token, see .
Optionally, you can append the following advanced query parameters to the URL for a more customized experience:
?maxToolNameLength=<length> - By default, generated tool names are cropped to a maximum of 56 characters to ensure compatibility with most AI systems. You can customize this behavior by specifying the maximum generated tool name length using this parameter. The allowed range is 32 to 160 characters.
Authorization in headers support
If your client supports sending authorization in HTTP headers, you can use the following URL:
Specify the MCP token in the Authorization header as follows:
Clients without SSE support
If your MCP client does not support SSE, use the Cloudflare mcp-remote proxy for compatibility. Refer to Cloudflare's MCP Remote Proxy Guide for more details.
OAuth
Configuration example:
MCP token
Configuration example:
Timeouts for tool calls
Calls from MCP clients to tools on Make MCP server have timeout limits for returning output. Timeouts vary depending on the tool type called and the authorization and transport method used.
Even after a scenario run tool call times out, the called scenario continues running in Make for up to 40 minutes, and you can retrieve the output after the scenario finishes its run.
The call returns a timeout response that includes the executionId , which the MCP client can use to retrieve the output, once ready, with the corresponding tool.
Example response:
Select the scenarios:read scope to enable MCP clients to retrieve outputs after timeout once a scenario run finishes.
Management tool timeout limits
https://mcp.make.com (OAuth): 30 seconds
https://<MAKE_ZONE>/mcp/<TRANSPORT> (MCP token, direct OAuth):
Management tool calls are typically fast and rarely time out. If you still experience timeouts when using https://mcp.make.com, switch to a https://<MAKE_ZONE>/mcp/<TRANSPORT> URL for longer timeouts.
Installation
To connect Make MCP server to ChatGPT:
Open the web version of ChatGPT.
Click on your profile name on the left sidebar.
Click Settings to open the settings dialog.
Navigate to the Connectors section, then to Advanced settings.
In Advanced settings, enable Developer mode.
Return to Connectors, and click the Create button that is now visible in the top-right corner.
In the New Connector dialog, name your MCP server.
In the MCP Server URL field, add the following URL:
If you experience connection issues, you can add /stream instead of /stateless to the end of your connection URL. For SSE, add /sse instead.
Replace <MAKE_ZONE> and <MCP_TOKEN> with your actual values.
MAKE_ZONE - The zone your organization is hosted in (e.g., eu2.make.com).
MCP_TOKEN - You can generate your MCP API token in your Make profile.
In the Authentication dropdown, select No authentication.
Select the I trust this application checkbox.
Click the Create button.
You have now connected Make MCP server to ChatGPT. In Connectors, youcan click on it to expand its details and select which tools ChatGPT can use.
Enable in chat
After adding Make MCP server, you can enable it in the chat:
Open a new chat in ChatGPT.
In the left-hand corner of the message bar, click the + sign to open a dropdown.
If you experience connection issues, you can add /stream instead of /stateless to the end of your connection URL. For SSE, add /sse instead.
Replace <MAKE_ZONE> and <MCP_TOKEN> with your actual values.
MAKE_ZONE - The zone your organization is hosted in (e.g., eu2.make.com).
MCP_TOKEN - You can generate your MCP token in your Make profile.
Optionally, to control which scenarios are available as tools, you can further configure the URL according to the levels outlined in.
In Timeout, enter an appropriate timeout for your use case.
In MCP Settings, select Streamable HTTP or Server-Sent Events (SSE).
Click Save.
You have now connected Make MCP server to Vapi.
MCP Tool calls from Vapi Assistants may exceed Make API rate limits, resulting in rate limit errors. Check your Make API rate limit, as defined in your plan, in .
Usage with OpenAI API
This guide outlines how to connect Make MCP server with the OpenAI API.
{
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,
},
