From fb9a94172245f1b43b4a99477a0886994cbd18c3 Mon Sep 17 00:00:00 2001 From: Graham Neubig Date: Wed, 23 Jul 2025 21:40:35 -0400 Subject: [PATCH] docs: Add MCP Cloud availability note and improve document structure (#9801) Co-authored-by: openhands Co-authored-by: mamoodi --- docs/usage/mcp.mdx | 34 +++++++++++++++++++--------------- 1 file changed, 19 insertions(+), 15 deletions(-) diff --git a/docs/usage/mcp.mdx b/docs/usage/mcp.mdx index 2f0361049e..2f28ef0d16 100644 --- a/docs/usage/mcp.mdx +++ b/docs/usage/mcp.mdx @@ -10,6 +10,25 @@ Model Context Protocol (MCP) is a mechanism that allows OpenHands to communicate servers can provide additional functionality to the agent, such as specialized data processing, external API access, or custom tools. MCP is based on the open standard defined at [modelcontextprotocol.io](https://modelcontextprotocol.io). + +MCP is currently not available on OpenHands Cloud. This feature is only available when running OpenHands locally. + + +### How MCP Works + +When OpenHands starts, it: + +1. Reads the MCP configuration. +2. Connects to any configured SSE and SHTTP servers. +3. Starts any configured stdio servers. +4. Registers the tools provided by these servers with the agent. + +The agent can then use these tools just like any built-in tool. When the agent calls an MCP tool: + +1. OpenHands routes the call to the appropriate MCP server. +2. The server processes the request and returns a response. +3. OpenHands converts the response to an observation and presents it to the agent. + ## Configuration MCP configuration can be defined in: @@ -104,21 +123,6 @@ Stdio servers are configured using an object with the following properties: - Default: `{}` - Description: Environment variables to set for the server process -## How MCP Works - -When OpenHands starts, it: - -1. Reads the MCP configuration. -2. Connects to any configured SSE and SHTTP servers. -3. Starts any configured stdio servers. -4. Registers the tools provided by these servers with the agent. - -The agent can then use these tools just like any built-in tool. When the agent calls an MCP tool: - -1. OpenHands routes the call to the appropriate MCP server. -2. The server processes the request and returns a response. -3. OpenHands converts the response to an observation and presents it to the agent. - ## Transport Protocols OpenHands supports three different MCP transport protocols: