MCP Server Settings Reference

Complete field reference for all six tabs on the MCP server edit page. For task-oriented walkthroughs, see Configure MCP Server Authentication and Manage Tools.

Open a server from Build > MCP Servers by clicking a row or selecting Edit from the row menu. The edit page header shows the server name and a draft or active status badge. A Publish button sits above the tabs and is always visible regardless of which tab is open — selecting it changes a draft server to active and makes it accessible through the gateway.

Overview tab

The Overview tab summarizes the MCP server and its runtime posture.

Area	Description
Name and description	Display name and short description shown in the dashboard.
Tools	Count and list of discovered tools synced from the upstream server.
Metric cards	Tool Calls, Users, Blocked Tool Calls, and Avg Response for this server.
Connected Groups	Groups whose members can access this server through the gateway. Select Edit to change assignments.
Active Guards	Runtime guards applied to this server. Manage opens guard configuration.
Recent Activity	Recent tool calls for this server. Logs opens the full log view.

MCP server Overview tab showing server name, tool list, Tool Calls / Users / Blocked Tool Calls / Avg Response metric cards, Connected Groups, Active Guards, and Recent Activity

Ownership and connected groups control dashboard responsibility and runtime access respectively. Admin permissions alone do not grant gateway access. See Identity and Permissions and Groups.

Setup tab

The Setup tab configures upstream authentication and connector-specific connection steps.

Field / area	Description
Authentication mode	Proxy OAuth, Proxy API Key, Proxy Passthrough, or None.
OAuth fields	Client ID, Client Secret, Discover OAuth Settings, and advanced endpoint metadata.
Setup keys	For Proxy API Key: user-facing instructions and named key identifiers.
Run / test area	Connector-specific area for validating configuration after save.

MCP server Setup tab showing Proxy OAuth selected with Client ID, Client Secret, and Advanced settings fields, and Proxy API Key, Proxy Passthrough, and None options below

See Configure MCP Server Authentication for setup instructions by auth type.

Tools tab

The Tools tab lists tools discovered from the upstream MCP server.

Control	Description
Search tools	Filter the tool list by name.
Sync Tools	Re-read tools from the upstream MCP server.
Re-assess Risk	Refresh risk scoring for tools on this server.
Enable All / Disable All	Bulk enable or disable tools for gateway access.
Per-tool toggle	Enable or disable an individual tool.
Row menu	Test Tool, Edit, Require approval, Re-assess risk, Reset to default, Remove.
Tool editor	Opens a full edit page. Form or JSON mode toggle at the top. Fields: Name, Description, Annotation (collapsible), Schema (step 1, Input Schema JSON editor), Mapping (step 2). Use Next to advance steps. ← Back and Save at the top.

MCP server Tools tab showing tools grouped by risk category with enable toggles, Sync Tools, Re-assess Risk, Enable All, and Disable All controls

See Manage Tools for task-oriented instructions.

Resources tab

The Resources tab shows MCP resources exposed through the Willow proxy.

Field	Description
Proxy Resources Status	Whether resources are enabled for this integration.
Available Resources	Table of resources discovered from the upstream server.
Settings → Proxy Configuration	Link to enable or disable resources in proxy settings.

If resources are enabled but the table is empty, the upstream server did not expose any resources.

MCP server Resources tab showing proxy resources status, available resources table, and Settings to Proxy Configuration action

Prompts tab

The Prompts tab mirrors Resources for MCP prompts and conversation templates.

Field	Description
Proxy Prompts Status	Whether prompts are enabled for this integration.
Available Prompts	Table of prompts discovered from the upstream server.
Settings → Proxy Configuration	Link to enable or disable prompts in proxy settings.

MCP server Prompts tab showing proxy prompts status, available prompts table, and Settings to Proxy Configuration action

Settings tab

The Settings tab is split into collapsible sections.

General Settings

Field	Description
Name	Display name shown in the MCP Servers table and edit page header.
Description	Optional description of the server's purpose.
Slug	URL-friendly identifier used in MCP URLs and API references.
Logo URL	Optional image URL. A preview renders when the URL is valid.
Owners	Admins responsible for this server. Select Edit to search and assign owners.
Save Changes	Saves general settings.

Edit Owners modal with search field, owner checkbox list, Cancel and Done actions

MCP Configuration

JSON editor for the upstream MCP server configuration.

Control	Description
Vault syntax	Reference secrets as `{{vault.SECRET_NAME}}`. Vault references are resolved securely at runtime and never exposed in plaintext.
Open Vault	Opens the vault to manage secrets.
Insert Secret	Search and insert a vault placeholder into the JSON editor.
Stdio Example / HTTP Example	Insert sample configuration snippets.
Lint / Validate	Toolbar actions to check configuration syntax.
Save Changes	Saves the MCP configuration.

MCP Configuration section showing vault secrets info banner, JSON editor with HTTP config, and Open Vault, Insert Secret, Stdio Example, HTTP Example toolbar buttons

See Vault for secret management.

Proxy Configuration

Controls which MCP capabilities Willow proxies for this server.

Toggle	Description
Tools	Enable MCP tools for this integration.
Resources	Enable MCP resources for this integration.
Prompts	Enable MCP prompts for this integration.
Auto Sync Tools	Automatically add new tools when the upstream server is updated.
Local MCP	When enabled with STDIO transport, MCP runs locally and its configuration is visible to the client.

MCP server Proxy Configuration settings showing toggles for Tools, Resources, Prompts, Auto Sync Tools, and Local MCP

Request Settings

Advanced HTTP request configuration for the proxy.

Field	Description
Override base URL	When enabled, replaces the base URL used for upstream requests.
Base URL	Shown when override is enabled. Default is empty.
Headers	Key-value header pairs added to every upstream request. Use Add Header for multiple entries. In header values, use `{{headers.<name>}}` to dynamically reference an incoming request header (for example, `{{headers.authorization}}`).
Save Changes	Saves request settings.

Request Settings section showing Override base URL toggle, Base URL field, Headers key-value inputs with Add Header button, and Save Changes

Metadata

Custom key-value metadata for the MCP server. Accepts strings, numbers, booleans, arrays, and objects in a JSON-style editor.

Danger Zone

Action	Description
Delete MCP	Permanently deletes the MCP server. The label reads "Once you delete an mcp, there is no going back. Please be certain." This action cannot be undone.

Deleting from the list page row menu opens a separate confirmation dialog titled Delete Integration.