Loading...
Loading...
Expose an in-development MCP (Model Context Protocol) server for remote testing against AI model providers like Claude and OpenAI, with per-provider authentication and traffic inspection. Puts a cloud endpoint in front of your local MCP server, authenticates each provider with its own bearer token via Vaults, and forwards to your server kept off the public internet. Use when the user is building or testing an MCP server and needs a remote AI client to reach it. Use when the user says "test my MCP server", "expose my MCP server to Claude", "connect my MCP server to OpenAI", or "front door for my MCP server". Not for connecting ngrok's own MCP server - use ngrok-setup.
npx skill4agent add ngrok/skills run-mcp-gatewayngrok-setupforward-internalngrok-enginereferences/http-transport.tstraffic-policy.yamlMCP client (Claude/OpenAI) --Bearer token--> Cloud Endpoint (public, runs the policy)
--forward-internal--> Agent Endpoint (bound internal, e.g. https://mcp.internal)
--HTTP--> your MCP server (streamable HTTP transport)references/http-transport.tsawait runHttp(buildServer, port); // POST /mcp, bound to 127.0.0.1express@modelcontextprotocol/sdk{ host }.internalngrok http <port> --url https://mcp.internal --host-header=rewrite--host-header=rewriteforward-internalHost: mcp.internalngrok api vaults create --name "mcp-callers"
ngrok api secrets create --name "claude-key" --value "$(openssl rand -hex 32)" --vault-id "$VAULT_ID"ngrok-surfacesgw_create_vaultgw_create_secretgw_create_secretopenssl rand -hex 32references/traffic-policy.yamlforward-internalx-mcp-callerngrok-surfacesgw_create_cloud_endpointngrok apihttps://<your-cloud-endpoint>/mcpreferences/http-transport.tsx-mcp-caller/mcp/mcpexpose-localhostngrok-setuphttp-transport.tsbuildServer