Skip to main content
Unlisted page
This page is unlisted. Search engines will not index it, and only users having a direct link can access it.
Version: 11.3.0

Connectors

A connector is how HYPR AgentPass™ reaches a target on behalf of your agents. Every request to that target picks up the same identity, policy, approval and audit controls as the rest of your agent traffic.

Playbook

Give a Team Governed Coding Agents walks through the connectors a coding-agent rollout needs.

The Five Kinds​

Connectors come in five kinds, one for each type of target.

KindWhat it brings under the gatewayGuide
AI providersLLM traffic from desktop and cloud agents, with policy and visibilityAnthropic · OpenAI · AWS Bedrock · AWS Bedrock Mantle · Custom AI Provider
MCP serversAn MCP server proxied through the gateway, with identity and governanceMCP Servers · One-Click MCP Servers
REST APIsREST endpoints, exposed to agents as MCP toolsREST APIs
Cloud agentsCloud-hosted agents, made accessible through the Agent PortalCloud Agent Connectors
ChannelsChat surfaces that route conversations to one of your agents, such as a Slack workspaceSlack Agent

You create every kind from Add Connector.

Claude Code and Codex channels use your Anthropic and OpenAI connectors, and you enable them through Managed Desktop Tools. See Claude and Codex Channels.

Find Your Connectors​

The navigation's Connectors group lists All Connectors, one collapsible group for each kind that has at least one connector, and Add Connector. Each group shows how many connectors it holds.

All Connectors opens the Connectors page. It shows your connector count, a search box that matches a connector's name, template or URL, and one section per kind. Each section lists its connectors in these columns.

ColumnWhat it shows
StatusWhether the connector is Enabled or Disabled
ConnectorThe connector's display name. Click it to open the connector
UsageAn agent count, for AI provider and cloud agent connectors
OnboardingThe connector's onboarding mode

A kind with no connectors shows an Add one → link.

Add a Connector​

  1. In the navigation, click Add Connector. The catalog lists the five kinds as collapsed rows.
  2. Click a kind to expand it, or type in Search all connectors to find a target by name or description.
  3. Click the target's card, such as Anthropic under AI Providers or Microsoft 365 Copilot under Cloud Agents. Its form opens.
  4. Complete the form. Each guide lists the fields its target needs, and what to prepare on the provider side first.
The Add connector page listing the connector kinds

Hover over a card to read what the connector does. Click Cancel in a form to return to the catalog.

A connector's onboarding mode decides what happens to an agent's first request through it, such as holding it for a supervisor or only recording it. On an AI provider form, you choose the mode on the last step, before you click Create Connector.

Reading a Connector​

Click a connector in the navigation to open its detail page. Every connector has these tabs.

TabWhat it showsCovered in
OverviewName, Enabled, endpoint, the target's credentials, Onboarding Mode, and the routes the gateway forwardsThe guide for that kind
Policies (N)Every policy that governs this connector, scoped or global, and the decisions they made on its traffic. Also Author policy with AIPolicy
ConnectionsActive sessions, requests and errors over 24 hours, authentication status, recent events and connected clientsThe Connections Tab
Recent RequestsStored request and response samples, redacted, and capped per tool or modelThe Recent Requests Tab

Other tabs depend on the connector.

TabConnectors that show itCovered in
Agents (N)Anthropic, OpenAI, AWS Bedrock AgentCore, Anthropic Managed AgentsAgent identity
Session watchAnthropic, OpenAI, AWS Bedrock, for people who can view Session WatchSession Watch
Recent SessionsAnthropic, OpenAI, AWS BedrockAgent Session Forensics
Tool calls, ToolsMCP server and REST API connectorsMCP Servers · REST APIs
Connection, TestREST API connectorsREST APIs
Copilot Studio agents, Portal brandingMicrosoft 365 CopilotConnecting Microsoft 365 Copilot

Custom AI provider and Slack Agent connectors have only the shared tabs.

The Connections Tab​

The Connections tab shows how the connector is being used right now. It refreshes on its own. Click Refresh to update it now.

  • Summary. Active sessions, Requests · 24h, Errors · 24h and Auth status.
  • OAuth Authentication. On MCP server and REST API connectors where the gateway holds each person's token, one row per supervisor, with the token's status and expiry.
  • Pending authentications. Sign-ins that are waiting for a supervisor.
  • Events. Recent events on the connector's traffic, such as policy decisions. Click one to open it.
  • Connected Clients. The agent sessions the connector tracks. Revoking a session makes that agent onboard again on its next request.
  • Recent Activity. The latest requests. Click Older → to page back.

The Recent Requests Tab​

The Recent Requests tab keeps real example payloads for the connector, grouped by MCP tool or by model. AgentPass redacts authorization headers, cookies, and password, token, secret and API key fields before storage. Filter by a tool or model name, and expand a row to see its request and response. The number of samples kept per tool is set on Gateway Settings.

Manage a Connector​

A connector's detail page has Edit and Delete Connector in its header, and an Enabled switch on its Overview tab.

Edit a Connector​

  1. Open the connector.
  2. Click Edit. A drawer opens with the fields that connector's kind uses.
  3. Change the fields you need. Secrets are write-only. Leave a secret field blank to keep the stored value.
  4. Click Save.

The Change link on the Overview tab's Endpoint row opens the same drawer. A REST API connector's credentials are edited on its Connection tab instead. See REST APIs.

Allow a Private Network Address​

A connector refuses an upstream on a private network address by default. To reach an internal API or MCP server you control:

  1. Open the connector, and click Edit.
  2. Turn on Allow private network addresses.
  3. Click Save.

Cloud metadata addresses stay blocked, even with the switch on. A connector with the switch on carries a Private network tag in the connectors list, and Private network access only filters the list to those connectors.

Your organization must allow it

The switch takes effect only when private network access is enabled for your organization. Otherwise the switch is unavailable, or reads On, but not in effect. On HYPR-hosted AgentPass, ask HYPR support to enable it.

The console's identity provider, the SMTP relay and the HYPR tenant each have the same switch on their settings. When the gateway refuses an outbound call because of its destination, it records an enforcement event that names the destination host and the connector.

Turn a Connector On or Off​

The switch beside the connector's name turns it on or off, with no confirmation. A disabled connector receives no traffic: the gateway skips it when it routes a request, and a disabled Slack Agent connector does not answer. The connector grays out in the navigation and on the Connectors page. Author policy with AI is unavailable while the connector is off.

Delete a Connector​

  1. Open the connector.
  2. Click Delete Connector.
  3. In Delete this connector?, click OK. The connector list opens.
Deleting removes more than the connector

Deleting a connector also removes:

  • The OAuth tokens it stored for supervisors
  • The agents it imported, such as AgentCore runtimes, and their links to supervisors
  • The Slack conversation threads a Slack Agent connector was carrying

Cloud agents imported from an Anthropic Managed Agents connector are archived. They still exist on your Anthropic account. To pause a connector without losing any of this, turn it off instead.

Who Can Do What​

Connector tasks need these permissions. AgentPassAdmin holds all of them, and AgentPassOperator can view connectors. See Permissions by Role.

TaskPermission
See connectors and their detail pages, download setup scripts and manifests, and run Test connectionconnectors:view
Add, edit, turn on or off, change the onboarding mode, and reset or revoke connectionsconnectors:edit
Delete a connectorconnectors:delete
Sync agents from the provideragents:sync
Author policy with AIpolicies:add
Open the Session watch tab, or change its rulessession-watch:view, session-watch:manage
Manage the Copilot Studio agents tabcloud-agents:view, cloud-agents:manage
Delete a pending authenticationapprovals:delete
  • Onboarding Mode — what a connector does with an agent it has not seen before
  • Policy — allow, block or hold a connector's traffic
  • Service Agents — give an unattended caller a bounded set of connectors