Integrations
AI Runtime connects to the model providers and MCP servers you protect, to your identity provider, and to the tools your security team already uses. This page lists each integration and what it needs from the network when the gateway is self-hosted.
At a Glance
| Integration | Connected by | Self-hosted: the connection goes from |
|---|---|---|
| Model providers | The gateway, in gateway mode | Your gateway to the provider |
| Managed agents | The gateway, in gateway mode | Your gateway to the agent platform |
| MCP servers | The gateway | Your gateway to the MCP server |
| Identity providers for MCP | The gateway | Your gateway to your identity provider |
| Console sign-in | The ByteHide platform | Your team's browsers to ByteHide |
| Alert channels and SIEMs | The ByteHide platform | Your gateway to ByteHide, then ByteHide to the destination |
| Tracing | The gateway | Your gateway to your OpenTelemetry collector |
| SDKs | Your applications | Your applications to your gateway |
Model Providers
In gateway mode, the gateway forwards to the providers you add as integrations: OpenAI, Anthropic, Google Gemini, Google Vertex AI, Azure OpenAI, Amazon Bedrock, Mistral AI, Groq, xAI, DeepSeek, Cohere, Together AI, OpenRouter, Perplexity, Fireworks AI, Cerebras, NVIDIA NIM, and a Custom Backend for your own OpenAI-compatible service or Ollama host.
On a self-hosted gateway:
- Allow outbound HTTPS from the gateway to the providers you actually use, and nothing else. In a fully in-app deployment the gateway needs no route to providers at all.
- Provider keys are stored on the integration, encrypted at rest in your own PostgreSQL, and never returned by the API.
- A Custom Backend inside your network is reached over your internal network.
Managed Agents
The gateway also fronts the providers' managed agent platforms: Amazon Bedrock AgentCore, Amazon Bedrock Agent, Azure AI Foundry Agent and Vertex AI Agent Engine. They connect the same way as model providers. See Integrations.
MCP Servers
The gateway sits between your agents and the MCP servers they use, and speaks Streamable HTTP to both. Servers that only offer stdio or the legacy HTTP+SSE transport cannot be connected. See Connect an MCP Server.
| Server | How a self-hosted gateway reaches it |
|---|---|
| Third-party server on the internet | Outbound HTTPS from the gateway. Allow-list the gateway's egress addresses if the server filters by source |
| Server in your cloud network | Over your internal network, once its private range is declared on the gateway (see below). MCP traffic to it does not cross the internet |
| Server in your data center | Over the private link that already joins your cloud and your data center: Direct Connect, ExpressRoute, Cloud Interconnect or a site-to-site VPN. The gateway's subnet needs a route to it, your firewall must allow its port, and its range must be declared on the gateway (see below). Alternatively, run the gateway on a virtual machine in the data center itself |
Private addresses must be declared
The gateway resolves each MCP server's name and checks every address it resolves to. By default it only connects to public addresses. To reach MCP servers on private addresses, the gateway's operator lists the private networks they live in, as CIDR ranges such as 10.20.0.0/16, in the gateway setting MCP_UPSTREAM_PRIVATE_ALLOWLIST: ByteHide does it on a dedicated gateway, your team on a self-hosted one. The list applies only to MCP servers and the OAuth endpoints discovered from them. Ranges broader than /8 are rejected, and loopback, link-local and cloud metadata addresses are refused even inside a declared range. The SaaS gateway only connects to MCP servers on public addresses.
On a dedicated gateway, private MCP servers are reached through the private connection to your network: ByteHide resolves their hostnames to their addresses inside the tunnel and declares those addresses on the gateway.
Use Approved MCP servers in Settings to restrict connections further.
Upstream Authentication
Servers that use OAuth sign-in send your browser back to the gateway's /mcp-oauth/callback. Make that path reachable from the browsers of the people who authorize servers. See MCP Authentication.
Identity Providers
For MCP Routes
People calling MCP routes can authenticate with your own identity provider, such as Okta, Microsoft Entra ID or Auth0, instead of a pasted token. You configure it in Settings with its issuer URL. See MCP Authentication.
On a self-hosted gateway:
- The gateway validates tokens against your provider's published keys, so it needs outbound access to your provider's issuer.
- The issuer and its keys URL must resolve to public addresses. Declaring private MCP networks does not extend to identity providers.
- On-behalf-of exchanges each caller's token at your provider's token endpoint on every call.
- Sign in through the gateway registers the gateway's own callbacks as redirect URIs at your provider, so those callbacks must be reachable from your users' browsers.
For the Console
Your team signs in to the console through ByteHide, with TOTP multi-factor authentication, or with Microsoft Entra ID single sign-on over OpenID Connect, set up in your organization's security settings. The console then calls your gateway's control API with the member's session, and your gateway verifies it with the ByteHide platform.
Without the ByteHide platform
If your gateway cannot reach the ByteHide platform, members cannot sign in to it from the console. The control API is then usable only with a service admin key from your private network.
Alert Channels and SIEM
Alerts and Playbooks deliver through the ByteHide platform:
- Notification channels: email and webhooks out of the box, and Slack, Microsoft Teams, Telegram, Discord, WhatsApp and more once connected in your organization's Integrations.
- SIEM destinations: Splunk, Microsoft Sentinel, Elastic, IBM QRadar, Google SecOps (Chronicle), Datadog, Sumo Logic, Wazuh, Grafana Loki, New Relic, Amazon Security Lake, OpenTelemetry, Exabeam, LogRhythm, Logz.io, Cribl Stream and Syslog CEF, configured in your organization's Integrations. Use the Forward to SIEM playbook step to send matching incidences.
SIEM events carry the verdict, detections, identifiers and request context. They never contain prompt or response text, on any destination.
On a self-hosted gateway, alerts are evaluated by your gateway and delivered by the ByteHide platform, so the gateway needs its outbound path to ByteHide. If you close it, alerts are still evaluated and recorded in your database, but nothing is delivered.
Tracing
The gateway exports traces over OTLP and propagates the W3C traceparent header, so its spans join your existing APM traces. Configure it with the standard OpenTelemetry environment variables; without an endpoint, nothing is exported. Each response also carries an x-bytehide-request-id header to match a client-side error to its incidence.
SDKs
| Mode | SDKs | Guide |
|---|---|---|
| Gateway mode | Your existing provider SDKs, unchanged apart from the base URL and key: OpenAI, Anthropic, Azure OpenAI, boto3 and the AWS SDKs, or any HTTP client | Gateway Mode |
| In-app mode | The App runtime SDK (formerly App runtime) for .NET, JavaScript and Python | .NET, JavaScript, Python |
| MCP | Any MCP client with HTTP transport | MCP Protection |
On a self-hosted gateway, your applications call your gateway's URL instead of the SaaS one, and in-app applications must reach its verdict endpoints. See Requirements.
Next Steps
Requirements
Ports, exposed paths and outbound connections
Architecture
Components, request paths and failure modes
LLM Integrations
Add a model provider or managed agent