mcp: promote MCPRoute API to v1beta1 (#2090)

**Description**

Upgrade the `MCPRoute` api to `v1beta1`.

**Related Issues/PRs (if applicable)**

Related to: #2083

**Special notes for reviewers (if applicable)**

N/A

---------

Signed-off-by: Ignasi Barrera <nacx@apache.org>

Author: nacx

api/v1alpha1/mcp_route.go

@@ -21,6 +21,7 @@ import (
 // +kubebuilder:object:root=true
 // +kubebuilder:subresource:status
 // +kubebuilder:printcolumn:name="Status",type=string,JSONPath=`.status.conditions[-1:].type`
+// +kubebuilder:deprecatedversion:warning="aigateway.envoyproxy.io/v1alpha1 is deprecated; use aigateway.envoyproxy.io/v1beta1 instead"
 type MCPRoute struct {
 	metav1.TypeMeta   `json:",inline"`
 	metav1.ObjectMeta `json:"metadata,omitempty"`
@@ -97,7 +98,7 @@ type MCPRouteSpec struct {
 type MCPRouteBackendRef struct {
 	gwapiv1.BackendObjectReference `json:",inline"`
 
-	// Path is the HTTP endpoint path of the baackend MCP server.
+	// Path is the HTTP endpoint path of the backend MCP server.
 	// If not specified, the default is "/mcp".
 	//
 	// +kubebuilder:validation:Optional
@@ -190,7 +191,7 @@ type MCPToolFilter struct {
 	ExcludeRegex []string `json:"excludeRegex,omitempty"`
 }
 
-// MCPBackendSecurityPolicy defines the security policy for a sp
+// MCPBackendSecurityPolicy defines the security policy for a backend MCP server.
 type MCPBackendSecurityPolicy struct {
 	// APIKey is a mechanism to access a backend. The API key will be injected into the request headers.
 	// +optional