MCPRemoteServer

MCPRemoteServer is the Schema for the mcpremoteservers API. It defines an MCP server accessible via HTTP or SSE at a remote URL.

Spec

Field	Description	Validation
`apiVersion` string	`mcp-gateway.ohcs.io/v1alpha1`
`kind` string	`MCPRemoteServer`
`metadata` ObjectMeta	Refer to Kubernetes API documentation for fields of `metadata`.
`spec` MCPRemoteServerSpec	spec defines the desired state of MCPRemoteServer.	Required
`status` MCPRemoteServerStatus	status defines the observed state of MCPRemoteServer.

MCPRemoteServerSpec

Field	Description	Default	Validation
`gatewayRef` GatewayRef	gatewayRef references the MCPGateway that will route traffic to this server.		Required
`path` string	path is the URL path on the gateway domain for this MCP server. Defaults to “/<name>” if not specified.
`url` string	url is the upstream URL of the remote MCP server.		Pattern: `^https?://.*$`, Required
`transport` Transport	transport specifies the transport protocol to use when communicating with the upstream.	sse	Enum: [http sse]
`headers` Header array	headers specifies headers to include in requests to the upstream server. Each header can have a static value or reference a secret.

MCPRemoteServerStatus

Field	Description	Default	Validation
`phase` string	phase represents the current phase of the MCPRemoteServer.
`conditions` Condition array	conditions represent the current state of the MCPRemoteServer resource.
`endpoint` string	endpoint is the full URL where this MCP server is accessible via the gateway (e.g., “https://mcp.example.com/cloudflare").
`ready` boolean	ready indicates whether the server is configured and ready to receive traffic.
`gatewayName` string	gatewayName is the name of the MCPGateway this server is attached to.

Supporting Types

GatewayRef

GatewayRef references an MCPGateway resource in the same namespace. Cross-namespace gateway references are not supported for security reasons.

Field	Description	Default	Validation
`name` string	name is the name of the MCPGateway resource in the same namespace.		MinLength: 1, Required

Header defines a header to include in requests to the upstream server. Similar to corev1.EnvVar, it supports both static values and values from secrets.

Field	Description	Validation
`name` string	name is the header name.	MinLength: 1, Required
`value` string	value is the static header value.
`valueFrom` HeaderValueSource	valueFrom specifies a source for the header value.

HeaderValueSource

HeaderValueSource defines a source for obtaining header values.

Field	Description	Default	Validation
`secretKeyRef` SecretKeySelector	secretKeyRef references a key in a Secret.

Transport

Transport defines the transport protocol for MCP communication.

Field	Description
`http`	TransportHTTP uses HTTP for MCP communication.
`sse`	TransportSSE uses Server-Sent Events for MCP communication.