Skip to content

Commit ba906e4

Browse files
pdwarfcubic-dev-ai[bot]HumanistSerif
authored
initial docs for standalone mcp client node (#3975)
Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com> Co-authored-by: Kartik Balasubramanian <22399046+HumanistSerif@users.noreply.github.com>
1 parent 2ada2ee commit ba906e4

File tree

2 files changed

+53
-0
lines changed

2 files changed

+53
-0
lines changed
Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
---
2+
title: MCP Client node documentation
3+
description: Learn how to use the MCP Client node in n8n. Follow technical documentation to integrate MCP Client node into your workflows.
4+
contentType: [integration, reference]
5+
---
6+
7+
# MCP Client node
8+
9+
The MCP Client node is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) client that allows you to use the tools that are exposed by an external MCP server.
10+
11+
You can use the MCP Client node to use MCP tools as regular steps in a workflow.
12+
13+
If you want to use MCP tools as tools for an AI Agent, use the [MCP Client Tool node](/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.toolmcp.md) instead.
14+
15+
/// note | Credentials
16+
The MCP Client node supports [Bearer](/integrations/builtin/credentials/httprequest.md#using-bearer-auth), generic [header](/integrations/builtin/credentials/httprequest.md#using-header-auth), and [OAuth2](/integrations/builtin/credentials/httprequest.md#using-oauth2) authentication methods.
17+
///
18+
19+
## Node parameters
20+
21+
Configure the node with the following parameters.
22+
23+
* **Server Transport**: The transport protocol used by the MCP Server endpoint you want to connect to.
24+
* **MCP Endpoint URL**: The URL of the external MCP Server. For example, `https://mcp.notion.com/mcp`.
25+
* **Authentication**: The authentication method for authentication to your MCP server. The MCP Client node supports [bearer](/integrations/builtin/credentials/httprequest.md#using-bearer-auth), generic [header](/integrations/builtin/credentials/httprequest.md#using-header-auth), and [OAuth2](/integrations/builtin/credentials/httprequest.md#using-oauth2) authentication. Select **None** to attempt to connect without authentication.
26+
* **Tool**: Select the tool to use in the node. The list of tools is automatically fetched from the external MCP server.
27+
* **Input Mode**:
28+
* **Manual**: Specify each tool parameter manually.
29+
* **JSON**: Specify tool parameters as a JSON object. Use this mode for tools with nested parameters.
30+
31+
## Options
32+
33+
* **Convert to Binary**: Whether to convert images and audio to binary data. If false, images and audio are returned as base64 encoded strings.
34+
* **Timeout**: Time in milliseconds to wait for tool calls to finish.
35+
36+
## Templates and examples
37+
38+
<!-- see https://www.notion.so/n8n/Pull-in-templates-for-the-integrations-pages-37c716837b804d30a33b47475f6e3780 -->
39+
[[ templatesWidget(page.title, 'mcp-client') ]]
40+
41+
## Related resources
42+
43+
To use MCP tools with AI Agents, n8n has the [MCP Client Tool node](/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.toolmcp.md).
44+
45+
n8n also has an [MCP Server Trigger](/integrations/builtin/core-nodes/n8n-nodes-langchain.mcptrigger.md) node that allows you to expose n8n tools to external AI Agents.
46+
47+
Refer to the [MCP documentation](https://modelcontextprotocol.io/introduction) and [MCP specification](https://modelcontextprotocol.io/specification/) for more details about the protocol, servers, and clients.
48+
49+
--8<-- "_snippets/integrations/builtin/cluster-nodes/tools-link.md"
50+
51+
--8<-- "_snippets/integrations/builtin/cluster-nodes/langchain-overview-link.md"
52+

nav.yml

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -229,6 +229,7 @@ nav:
229229
- integrations/builtin/core-nodes/n8n-nodes-base.splitinbatches.md
230230
- Manual Trigger: integrations/builtin/core-nodes/n8n-nodes-base.manualworkflowtrigger.md
231231
- integrations/builtin/core-nodes/n8n-nodes-base.markdown.md
232+
- MCP Client: integrations/builtin/core-nodes/n8n-nodes-langchain.mcpClient.md
232233
- MCP Server Trigger: integrations/builtin/core-nodes/n8n-nodes-langchain.mcptrigger.md
233234
- integrations/builtin/core-nodes/n8n-nodes-base.merge.md
234235
- integrations/builtin/core-nodes/n8n-nodes-base.n8n.md

0 commit comments

Comments
 (0)