From 7944ef2276c980e8db8af2750a0c055185d65e3c Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
<41898282+github-actions[bot]@users.noreply.github.com>
Date: Thu, 29 Jan 2026 17:41:56 +0000
Subject: [PATCH 1/2] Editorial: Structure - Added intro line explaining what
the reader will learn; expanded first paragraph to include context about why
this information is useful and when you'll need it
---
.../mcp-gateways/add-remote-servers/page.mdx | 14 ++++++++------
1 file changed, 8 insertions(+), 6 deletions(-)
diff --git a/app/en/guides/mcp-gateways/add-remote-servers/page.mdx b/app/en/guides/mcp-gateways/add-remote-servers/page.mdx
index 12e28b8a6..102d60703 100644
--- a/app/en/guides/mcp-gateways/add-remote-servers/page.mdx
+++ b/app/en/guides/mcp-gateways/add-remote-servers/page.mdx
@@ -12,7 +12,9 @@ export const REMOTE_SETUP_HEIGHT = 773 / 1.5;
# Add remote MCP servers
-Use this guide if you want to connect an existing MCP server that Arcade does not host. You will add the server to your Arcade project, expose its tools in MCP Gateways, and call those tools from Arcade SDKs.
+Register an existing MCP server that Arcade does not host and use its tools in gateways and SDKs.
+
+You will add the server to your Arcade project, expose its tools in MCP Gateways, and call those tools from Arcade SDKs. This guide covers connecting to external MCP servers that you want to proxy through Arcade's infrastructure for centralized tool management and filtering.
@@ -38,7 +40,7 @@ Register a remote MCP server and use its tools in gateways and SDKs.
-## Why use MCP Gateways for Remote MCP Servers
+## Why use MCP Gateways for remote MCP servers
MCP Gateways let you manage and filter tools in one place, so your agent or team uses a curated set of tools across clients. This is especially useful for remote MCP servers, where you may not have control over the tools available. By using MCP Gateways, you can select the tools you want to use and hide the ones you don't want to use.
@@ -74,7 +76,7 @@ Arcade requires two fields for remote MCP servers:
Create the server and confirm that Arcade lists the server tools in your project. If the remote MCP server requires authentication, Arcade will prompt you to complete the OAuth flow.
-Arcade pre-loads the list of tools available to the user who configures the remote MCP server so that you can filter them by your own criteria in your MCP Gateways. Be sure to connect as an 'admin' user who has access to the broadest selection of tools in the remote server. Arcade then re-load the list of tools for every user using your agent - if a tool is not available to the agent's end-user, it will not be available via the gateway.
+Arcade pre-loads the list of tools available to the user who configures the remote MCP server so that you can filter them by your own criteria in your MCP Gateways. Be sure to connect as an 'admin' user who has access to the broadest selection of tools in the remote server. Arcade then re-loads the list of tools for every user using your agent - if a tool is not available to the agent's end-user, it will not be available via the gateway.
@@ -85,13 +87,13 @@ Remote MCP servers often require more than a URL. Use **Advanced settings** to c
Common settings include:
- **Connection settings**: Configure timeout and retry values for tool calls.
-- **OAuth2 authorization (optional)**: Add client ID and client secret, and set an authorization URL if it differs from the MCP server URI. Use the provided redirect URI when configuring your OAuth app.
+- **OAuth 2.0 authorization (optional)**: Add client ID and client secret, and set an authorization URL if it differs from the MCP server URI. Use the provided redirect URI when configuring your OAuth app.
- **Custom headers**: Add headers such as `Authorization` or `X-API-Key` and reference secrets with `${secret:NAME}`.
- **Header secrets**: Store API tokens or passwords and reference them in headers.
## Use remote tools in MCP Gateways
-Once the server is registered, its tools show up in the Playground for this project, as well as in the MCP Gateway tool picker.
+Once you register the server, its tools show up in the Playground for this project, as well as in the MCP Gateway tool picker.
1. Create or edit an MCP Gateway in the [MCP Gateways dashboard](https://app.arcade.dev/mcp-gateways).
2. Open **Select tools** and filter by your remote server name.
@@ -153,4 +155,4 @@ console.log(result);
## Next steps
- [Create an MCP Gateway](/guides/mcp-gateways/create-via-dashboard)
-- [Connect to MCP clients](/get-started/mcp-clients)
+- [Connect to MCP clients](/get-started/mcp-clients)
\ No newline at end of file
From 3d13b5ac33c7fc4ab438e4ccdc4717fdff333d8d Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
<41898282+github-actions[bot]@users.noreply.github.com>
Date: Thu, 29 Jan 2026 17:41:57 +0000
Subject: [PATCH 2/2] Editorial: Structure - Added required intro line
explaining what the page covers
---
app/en/guides/mcp-gateways/page.mdx | 6 ++++--
1 file changed, 4 insertions(+), 2 deletions(-)
diff --git a/app/en/guides/mcp-gateways/page.mdx b/app/en/guides/mcp-gateways/page.mdx
index 39ad8408f..b61b9c21a 100644
--- a/app/en/guides/mcp-gateways/page.mdx
+++ b/app/en/guides/mcp-gateways/page.mdx
@@ -8,7 +8,9 @@ import { SignupLink } from "@/app/_components/analytics";
# MCP Gateways
-MCP Gateways are a way to connect multiple MCP Servers to your agent, application, or IDE. MCP Gateways allow you to federate the tools from multiple MCP Servers into a single collection for easier management, control, and access. You can mix and match tools from different MCP Servers in the same project.
+MCP Gateways connect multiple MCP servers to your agent, application, or IDE.
+
+MCP Gateways federate tools from multiple MCP servers into a single collection for easier management, control, and access. You can mix and match tools from different MCP servers in the same project.
## Why use MCP Gateways?
@@ -73,4 +75,4 @@ See [Create via Dashboard](/guides/mcp-gateways/create-via-dashboard) for detail
## Next Steps
- Create an Arcade account if you haven't already
-- [Browse available integrations](/resources/integrations) to see what tools you can add to your gateway
+- [Browse available integrations](/resources/integrations) to see what tools you can add to your gateway
\ No newline at end of file