Properties
headers
Optional
Optional HTTP headers sent with each request to the MCP server. The
primary mechanism for authenticating against an MCP server — see the
worked examples on the mcps field for Bearer-token and API-key
conventions.
string
A unique name to identify this MCP server. Used in tool names
(mcp__<name>__<tool>) and in approval-rule patterns
(mcp__<name>__*).
tools
Optional
string[]
Optional allow-list of tool names to expose from this server. When omitted, every tool the server advertises is available to the agent.
Example
tools: ['search', 'fetch']
string
The HTTP(S) endpoint URL for the MCP server, as a string.
Example
url: 'https://api.example.com/mcp'
Configuration for one HTTP/HTTPS Model Context Protocol (MCP) server the AI Agent should connect to.
HTTP is the only supported MCP transport — see AIAssistant.AgentConfiguration.mcps for worked authentication examples.