Add a server of your own by its web address to give Haruno extra tools. It is in the advanced view only, and scheduled tasks never use these servers.
Mac appAvailableAdvanced view only. Scheduled tasks never use these servers.
Windows appAvailableAdvanced view only. Works in the sandbox. Not used by scheduled tasks or hooks.
A custom MCP server is a service you or your company runs that offers Haruno extra tools. You add it by its web address. Haruno then lists the tools the server offers, and you choose which ones Haruno may use.
Where it is
The Custom MCP servers section is at the bottom of the Connectors window. It shows in the advanced view only. To see it, turn on Advanced view in Settings ▸ General. See Normal view and advanced view.
The section says: Connect the agent to your own MCP servers, by URL.
Add a server
Click Add server
A window opens with a Connection section.
Fill in the connection
Give the server a Name and its Server URL. A name is 1 to 64 letters, numbers, hyphens or single underscores. The window tells you if a name is reserved or already used. Under Authentication, choose None, Header or OAuth.
Add the sign in details
Header asks for a Header name and a Secret. OAuth asks for optional details: Client ID (optional), Client secret (optional), Callback port (optional) and Scopes (space-separated, optional).
Click Connect
Haruno contacts the server. With OAuth, the window says Complete sign-in in your browser…. When it works, a Tools list appears. If the server offers none, the window says so.
Choose a setting for each tool
Each tool has On, Confirm or Off. On lets Haruno use it. Confirm makes Haruno ask first. Off keeps Haruno from using it.
Click Save
The server joins the list.
If Connect fails, the window says why. For example, the server could not be reached, its certificate could not be verified, or the sign in was declined or timed out.
A server on your own Mac cannot be reached
Haruno works in an isolated space. A server at localhost is on your Mac, outside that space, so Haruno cannot reach it. The window warns you. Use a host name or a network address instead. Any port works. Haruno lets its isolated space reach the address you give.
Use and change a server
Each server has a row with its name and either the number of tools on, such as 3/5 tools, or its web address. A switch turns it on or off. The ⋯ menu has Edit… and Remove.
Edit… opens the same window. Reconnect refreshes the tool list from the live server.
Remove asks first. Haruno then stops using the server.
A row can show a warning when the saved secret is a problem: Credential missing — edit the server to re-enter it., Unlock your keychain to use this server. or Credential rejected — edit the server to enter a new one.
Scheduled tasks never use them
A scheduled task is never given a custom server. This holds for a task you allowed to send on its own, and for Try it…. Haruno cannot tell which tools of someone else's server reach other people, so it cannot hold them for your approval the way it holds an email. Use these servers in a chat, where you see each step.
A chat that belongs to a project does not use them either. See The Connectors window.
Who has it
The advanced view only. The normal view hides the section.
What to tell a customer
This is for people who run their own tools, usually with help from their IT team. They need the server's web address and, if it asks for one, a header secret or an OAuth sign in. Most customers never need it.