From a7533c15c9416ec67767f9fe5dcf2d161eac5b1e Mon Sep 17 00:00:00 2001 From: openhands Date: Wed, 16 Sep 2026 19:32:55 +0000 Subject: [PATCH] docs: update documentation for OpenHands v1.19.0 - Add release notes for v1.19.0 - Document MCP server scoping for agent profiles (mcp_server_refs) - Document automation disablement reason banner - Add note on Azure DevOps SSH remote URL support - Add cross-reference from MCP overview to agent profiles - Register v1.19.0 release notes in docs.json Co-authored-by: openhands --- docs.json | 1 + enterprise/integrations/azure-devops.mdx | 2 +- .../usage/agent-canvas/agent-profiles.mdx | 16 ++++++++++ .../agent-canvas/managing-automations.mdx | 9 ++++++ .../agent-canvas/release-notes/v1.19.0.mdx | 29 +++++++++++++++++++ overview/model-context-protocol.mdx | 1 + 6 files changed, 57 insertions(+), 1 deletion(-) create mode 100644 openhands/usage/agent-canvas/release-notes/v1.19.0.mdx diff --git a/docs.json b/docs.json index 133c95ce5..befd4e388 100644 --- a/docs.json +++ b/docs.json @@ -317,6 +317,7 @@ { "group": "Release Notes", "pages": [ + "openhands/usage/agent-canvas/release-notes/v1.19.0", "openhands/usage/agent-canvas/release-notes/v1.18.0", "openhands/usage/agent-canvas/release-notes/v1.17.0", "openhands/usage/agent-canvas/release-notes/v1.16.0", diff --git a/enterprise/integrations/azure-devops.mdx b/enterprise/integrations/azure-devops.mdx index 80e0ceeeb..3fe5e3490 100644 --- a/enterprise/integrations/azure-devops.mdx +++ b/enterprise/integrations/azure-devops.mdx @@ -156,7 +156,7 @@ After signing in, users can select Azure DevOps repositories from the OpenHands repository picker. OpenHands can: - List Azure DevOps projects and repositories available to the signed-in user. -- Clone Azure Repos using the signed-in user's OAuth token. +- Clone Azure Repos using the signed-in user's OAuth token. SSH remote URLs (`git@ssh.dev.azure.com:v3/...`) are also recognized. - Read branch and pull request context. - Create branches and pull requests. - Read and post Azure Repos pull request comments. diff --git a/openhands/usage/agent-canvas/agent-profiles.mdx b/openhands/usage/agent-canvas/agent-profiles.mdx index bb639cdce..c379b7a68 100644 --- a/openhands/usage/agent-canvas/agent-profiles.mdx +++ b/openhands/usage/agent-canvas/agent-profiles.mdx @@ -50,6 +50,22 @@ The OpenHands profile editor includes a **"Let the agent switch LLM profiles"** This toggle is version-gated: it appears only when the connected backend reports agent-server `1.31.0` or later. On older backends (for example, agent-server `1.29.0`–`1.30.x`) the toggle is hidden. +### Scope a Profile to Specific MCP Servers + +An agent profile can be scoped to a subset of configured MCP servers using **MCP server references** (`mcp_server_refs`). When a profile includes MCP server references, only the tools from the referenced MCP servers are available to the agent in conversations that use that profile. + +This is useful when you have multiple MCP servers configured but want a particular profile to access only a subset — for example, restricting a profile to a documentation search server while excluding servers with broader tool access. + +To scope a profile: + +1. Open `Settings > Agent` and edit the agent profile. +2. In the MCP server scoping section, select the MCP servers this profile should access. +3. Save the profile. + +When no MCP server references are set, the profile has access to all configured MCP servers. When references are set, only the selected servers' tools are registered with the agent. + +See also [Model Context Protocol](/overview/model-context-protocol) for an overview of MCP support across OpenHands platforms. + ## ACP Profiles Use an ACP profile when you want Agent Canvas to drive an external coding agent through the Agent Client Protocol. diff --git a/openhands/usage/agent-canvas/managing-automations.mdx b/openhands/usage/agent-canvas/managing-automations.mdx index d73a5aa1c..2671d84ac 100644 --- a/openhands/usage/agent-canvas/managing-automations.mdx +++ b/openhands/usage/agent-canvas/managing-automations.mdx @@ -38,6 +38,15 @@ Use the Activity Log export controls to download run data as CSV or JSON. Both f Toggle an automation on or off from the kebab menu (⋮) on the automation row, or from the detail view. Disabled automations do not fire on their scheduled trigger or in response to events, but their configuration is preserved. +### Disablement reasons + +When an automation is disabled, the detail page shows a banner with a human-readable disablement reason, structured detail, and a timestamp. This helps you understand why an automation stopped running. Common reasons include: + +- **Manually disabled** — A user turned the automation off from the kebab menu or detail view. +- **Permanent dispatch failure** — The automation backend reported a permanent failure that prevented the automation from running. + +The banner displays the reason, any additional structured detail provided by the backend, and the time the disablement occurred. To re-enable an automation, use the toggle in the kebab menu or detail view (cloud backends require manage permissions or that you are the automation's creator). + ## Edit an automation You can edit an automation's name, prompt, model, timeout, and schedule directly in Agent Canvas. On cloud backends, editing requires manage permissions or being the automation's creator. diff --git a/openhands/usage/agent-canvas/release-notes/v1.19.0.mdx b/openhands/usage/agent-canvas/release-notes/v1.19.0.mdx new file mode 100644 index 000000000..af0798374 --- /dev/null +++ b/openhands/usage/agent-canvas/release-notes/v1.19.0.mdx @@ -0,0 +1,29 @@ +--- +title: Agent Canvas 1.19.0 +description: Release notes for Agent Canvas version 1.19.0 +--- + +# Agent Canvas 1.19.0 + +Released September 16, 2026. + +[View the full release on GitHub](https://github.com/OpenHands/OpenHands/releases/tag/v1.19.0). + +## Highlights + +- **MCP server scoping for agent profiles** — Agent profiles can now be scoped to specific MCP servers using `mcp_server_refs`. When a profile is scoped, only the selected MCP servers' tools are available to the agent in that conversation. See [Agent Profiles](/openhands/usage/agent-canvas/agent-profiles). +- **Automation disablement reasons** — The automation detail page now shows a human-readable disablement reason with structured detail and a timestamp. This makes it easy to understand why an automation was disabled, whether manually or due to a permanent dispatch failure. See [Managing automations](/openhands/usage/agent-canvas/managing-automations). +- **GPT-6 Astra model support** — The Codex ACP model picker includes GPT-6 Astra. ACP agent model lists are sourced from the SDK registry, so no additional configuration is required. See [ACP Agents](/openhands/usage/agent-canvas/acp-agents). + +## Improvements and Fixes + +- Azure DevOps SSH remote URLs (`git@ssh.dev.azure.com:v3/...`) are now correctly parsed, so repositories cloned over SSH display the correct name and branch. +- The static server now HTML-escapes injected runtime configuration and sets `Cache-Control: no-store`, fixing an XSS vulnerability. +- The client ACP registry pin is now tied to the agent-server, ensuring ACP provider lists stay in sync. +- The automation bundle-source validator now accepts `plugins/` package directories in catalog bundles. +- SDK bumped to 1.48.0 and automation runtime bumped to 1.12.1. + +## Full Changelog + +- [GitHub release notes](https://github.com/OpenHands/OpenHands/releases/tag/v1.19.0) +- [Compare v1.18.0 to v1.19.0](https://github.com/OpenHands/OpenHands/compare/v1.18.0...v1.19.0) diff --git a/overview/model-context-protocol.mdx b/overview/model-context-protocol.mdx index eaebd4443..b98a19fc0 100644 --- a/overview/model-context-protocol.mdx +++ b/overview/model-context-protocol.mdx @@ -57,4 +57,5 @@ When OpenHands starts, it: - **For detailed configuration**: See [MCP Settings](/openhands/usage/settings/mcp-settings) - **For CLI usage**: See [CLI MCP Servers](/openhands/usage/cli/mcp-servers) - **For SDK integration**: See [SDK MCP Guide](/sdk/guides/mcp) +- **For scoping MCP servers to an agent profile in Agent Canvas**: See [Agent Profiles](/openhands/usage/agent-canvas/agent-profiles) - **For architecture details**: See [MCP Architecture](/sdk/arch/mcp) \ No newline at end of file