For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.

Connect via HTTPS

Configure agentgateway to connect to an MCP server over HTTPS for encrypted transport.

Configure your agentgateway proxy to connect to an MCP server by using the HTTPS protocol.

About this guide

In this guide, you configure your agentgateway proxy to connect to the remote GitHub MCP server by using the HTTPS protocol. The server allows you to interact with GitHub repositories, issues, pull requests, and more. All connections to the server must be secured via HTTPS and a GitHub access token must be provided for authentication.

Before you begin

1. Follow the Get started guide to install agentgateway.

2. Follow the Sample app guide to create a gateway proxy with an HTTP listener and deploy the httpbin sample app.

3. Get the external address of the gateway and save it in an environment variable.

   Cloud Provider LoadBalancerPort-forward for local testing

   Tip

   Kind cluster? Kind does not support LoadBalancer services by default. To use this option with a Kind cluster, install and run cloud-provider-kind.

   export INGRESS_GW_ADDRESS=$(kubectl get svc -n agentgateway-system agentgateway-proxy -o jsonpath="{.status.loadBalancer.ingress[0]['hostname','ip']}")
   echo $INGRESS_GW_ADDRESS  

   kubectl port-forward deployment/agentgateway-proxy -n agentgateway-system 8080:80

Connect to the MCP server

1. Create a personal access token in GitHub and save it in an environment variable. For more information, see the GitHub docs.

   export GH_PAT=<personal-access-token>

2. Create the agentgateway-system for the remote GitHub MCP server. The server requires you to connect to it by using the HTTPS protocol. Because of that, you set the mcp.targets.static.port field to 443.

   kubectl apply -f- <<EOF
   apiVersion: agentgateway.dev/v1alpha1
   kind: AgentgatewayBackend
   metadata:
     name: github-mcp-backend
     namespace: agentgateway-system
   spec:
     mcp:
       targets:
       - name: mcp-target
         static:
           host: api.githubcopilot.com
           port: 443
           path: /mcp/
           policies:  
             tls:
               sni: api.githubcopilot.com       
   EOF

3. Create an HTTPRoute that routes traffic to the GitHub MCP server along the /mcp-github path. To properly connect to the MCP server, you must allow traffic from http://localhost:8080, which is the domain and port you expose your agentgateway proxy on later. If you expose the proxy under a different domain, make sure to add this domain to the allowed origins. Because the MCP server also requires a GitHub access token to connect, you set the Authorization header to the token that you created earlier.

   kubectl apply -f- <<EOF
   apiVersion: gateway.networking.k8s.io/v1
   kind: HTTPRoute
   metadata:
     name: mcp-github
     namespace: agentgateway-system
   spec:
     parentRefs:
     - name: agentgateway-proxy
       namespace: agentgateway-system
     rules:
       - matches:
           - path:
               type: PathPrefix
               value: /mcp-github
         filters:
           - type: CORS
             cors:
               allowHeaders:
                 - "*"               
               allowMethods:            
                 - "*"              
               allowOrigins:
                 - "http://localhost:8080"
           - type: RequestHeaderModifier
             requestHeaderModifier:
               set: 
                 - name: Authorization
                   value: "Bearer ${GH_PAT}"
         backendRefs:
         - name: github-mcp-backend
           group: agentgateway.dev
           kind: AgentgatewayBackend
   EOF

Verify the connection

Use the MCP Inspector tool to verify that you can connect to your sample MCP server through agentgateway.

1. Get the agentgateway address.

   Cloud Provider LoadBalancerPort-forward for local testing

   export INGRESS_GW_ADDRESS=$(kubectl get gateway agentgateway-proxy -n agentgateway-system -o=jsonpath="{.status.addresses[0].value}")
   echo $INGRESS_GW_ADDRESS

   kubectl port-forward deployment/agentgateway-proxy 8080:80 -n agentgateway-system

2. From your terminal, run the MCP Inspector command to open the MCP Inspector in your browser. If the MCP inspector tool does not open automatically, run mcp-inspector.

   npx @modelcontextprotocol/inspector@0.21.2

3. From the MCP Inspector menu, connect to your agentgateway address as follows:

   • Transport Type: Select Streamable HTTP.
   • URL: Enter the agentgateway address, port, and the /mcp-github path. If your agentgateway proxy is exposed with a LoadBalancer server, use http://<lb-address>/mcp-github. In local test setups where you port-forwarded the agentgateway proxy on your local machine, use http://localhost:8080/mcp-github.
   • Click Connect.

4. From the menu bar, click the Tools tab. Then from the Tools pane, click List Tools and select the get_me tool.

5. Click Run Tool.

6. Verify that you get back information about your username.

   

   

Cleanup

kubectl delete AgentgatewayBackend github-mcp-backend -n agentgateway-system
kubectl delete HTTPRoute mcp-github -n agentgateway-system