Skip to content
Latest (currently 2026.10.2) has the newest features, bug fixes, and CVE patches of Solo Enterprise for agentgateway.

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

Clients

Page as Markdown

Connect AI coding assistants to MCP servers exposed through agentgateway on Kubernetes

Connect AI coding assistants to MCP servers exposed through your agentgateway proxy running in Kubernetes.

Before you begin

  1. Set up an agentgateway proxy.
  2. Deploy an MCP server and expose it through agentgateway with an HTTPRoute.

Get the MCP endpoint URL

The MCP endpoint URL depends on how you exposed the MCP server through agentgateway.

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

echo "MCP URL: http://$INGRESS_GW_ADDRESS/mcp/mcp"
kubectl port-forward -n agentgateway-system svc/agentgateway-proxy 8080:80 &

The MCP endpoint is available at http://localhost:8080/mcp/mcp.

Note

The path /mcp/mcp assumes the default HTTPRoute path prefix of /mcp from the Static MCP guide. If you configured a different path in your HTTPRoute, adjust accordingly.

Connect your IDE

Use the MCP endpoint URL from the previous step to configure your IDE. Replace <MCP_URL> with your endpoint, such as http://localhost:8080/mcp/mcp for port-forward setups.

Note

Multiplexed tool names: If your agentgateway backend routes to more than one Virtual MCP target, agentgateway namespaces each tool and prompt name with its target name by default, for example mcp-server-everything_echo. When you add a second target, tools in your client’s tool list might get new names because of this prefixing. Control it with the prefixMode field on the MCP backend; see Virtual MCP for the available modes.

Authentication

If you configured MCP auth on your agentgateway proxy, include the required headers in your client configuration. The following example shows a Bearer token.

claude mcp add agentgateway --transport http <MCP_URL> \
  --header "Authorization: Bearer <your-token>"
{
  "mcpServers": {
    "agentgateway": {
      "url": "<MCP_URL>",
      "headers": {
        "Authorization": "Bearer <your-token>"
      }
    }
  }
}

Next steps