Skip to main content
Agent Canvas separates Customize from Settings.
  • Customize — teach the agent new things. Skills give it domain knowledge and specific instructions. MCP Servers connect it to external tools and data sources.
  • Settings — configure how the agent runs. Choose your LLM, store secrets, tune context handling, and set agent behavior. Settings are saved per backend.

​
Customize

Open the top-level Customize area to manage: Use the section navigation inside Customize to switch between these pages.
MCP Server configuration lives under Customize > MCP Servers, not under Settings.
When using an OpenHands Cloud backend, Skills becomes Skills and Plugins and opens the Cloud settings in a new tab. The local Plugins page is hidden, while MCP Servers remains in Agent Canvas. In Settings, Cloud becomes All Cloud Settings and an Integrations link opens the Cloud integrations page. Switching back to a local backend restores the local navigation.

​
Install Skills From Chat

You can install a skill from a conversation with /add-skill <github-url>. Because skills load when a conversation starts, Agent Canvas shows a banner after installation with Start new conversation with this skill. You will need to select it to start a conversation that includes the new skill. You can dismiss the banner. It appears again when you install another skill in the same session.

​
Check MCP Server Health

Installed MCP server cards check their connection and retain the resulting status: Server URLs and errors redact embedded secrets. Select Update credentials to edit a server; saving a corrected configuration refreshes its health status without reloading the page.

​
Settings

The Settings area currently includes the following sections: On local backends, the LLM page also includes an Available Profiles area for saved profiles. In Settings > Application, the Conversation titles setting selects the LLM profile used to generate conversation titles. Automatic uses the active local LLM profile; you can choose another saved profile, like a small, cheap LLM, when you want titles generated independently from the model selected for agent work. The same page shows the installed Agent Canvas version, update availability, and a Check for updates button. Use Settings > Agent to choose the active Agent Profile for new conversations. OpenHands profiles reference LLM profiles from Settings > LLM; ACP profiles use the external agent’s own model configuration.

​
Configuration Is Per Backend

Both Customize and Settings are tied to the active backend. That means:
  • Changing backends changes which configuration you are editing
  • Skills, MCP servers, secrets, and other settings saved for one backend do not automatically apply to every other backend
  • The available options can differ depending on backend capabilities

​
Practical Example

You might use this split like this:
  • Add a GitHub review skill in Customize > Skills
  • Add a Slack or fetch MCP server in Customize > MCP Servers
  • Save your preferred model in Settings > LLM
  • Store tokens in Settings > Secrets