Skip to main content
Version: 11.5.0

Get Started as a Developer

Role: none for your AI tool. In the console, you usually have Supervisor, the default role.

Who This Is For​

You use an AI coding tool, such as Claude Code, Codex, Claude Desktop or Cursor, on a work computer, and its traffic runs through HYPR AgentPass™. You keep working as you did. This page covers what is new: approving your agent, signing in to your organization's tools, and what a block looks like.

What You Can Do​

You canWhere it is covered
Keep working in your tool as usual, through the gatewayRouting and Observation
Approve your own agent's first connection, as its supervisorApprove the First Connection
Sign in once to each MCP server your organization providesConnecting to a Gateway MCP Connector
Read your own agent's requestsViewing the Request Log
Answer your agent's requests and messages on your phoneApproving and Denying Agent Actions

Someone else does this: your IT team installs Endpoint Guard and chooses which tools it routes. An administrator decides which MCP tools your role's agents can use, and writes the policies.

How It Works for You​

On a managed computer, Endpoint Guard points your tool at your organization's gateway, and adds your organization's MCP servers to it. Your tool keeps its own sign-in. You do not set ANTHROPIC_BASE_URL, or add the gateway's MCP servers, yourself.

Your Computer Without Endpoint Guard

If your IT team has not installed Endpoint Guard, you point the tool at the gateway yourself. See Point Your Agent at the Gateway.

The agent on your computer acts under your identity, so you are its supervisor. Its first request is held until a supervisor approves it, and that is usually you. After that, the gateway applies your organization's policies to every request. When a policy steps in, the gateway puts a notice in your tool's reply.

Your First Hour​

  1. Once Endpoint Guard is installed, quit your AI tool and start it again, so it picks up the gateway settings. See What Users Notice on Windows, or What Endpoint Guard Changes on a Mac.
  2. Sign in to your tool as usual. See How a Routed Tool Authenticates.
  3. Send a first request. The tool says it is waiting for approval.
  4. Approve the connection on Approvals in the console, or in the HYPR app. See Approve the First Connection.
  5. Optional: set up the HYPR app and a passkey, so approvals reach your phone. See Setting Up Your Approval Passkey.
  6. In Claude Code, run /mcp, choose a gateway server, and select Authenticate. See Authorize the Connector.
  7. Sign in to the service behind the server, such as Jira, from Approvals. See Sign In to the Service Behind It.
  8. Find your requests in Activity → Request log. See Read the Page.

What a Block Looks Like​

The gateway writes its notices into your tool's reply. Each one says that your organization's gateway inserted it, so you can tell it from the AI's own words.

What you see in your toolWhat it meansWhat to do
A reply that starts with Blocked by policy, with the rule's name and reasonA policy stopped your request, or a step the AI was about to takeAsk again without the part the rule is about. If your work needs it, ask your administrator, with the notice's exact wording
The tool says it is waiting for a supervisor to approve access, or that it does not have access to this gateway yetYour agent's connection is waiting for approvalApprove it, or ask its supervisor to. Then send your message again if the tool did not wait
Sign-in required for a server, with a link to ApprovalsThe service behind an MCP server needs you to sign inOpen the request on Approvals, and click Authenticate
This agent is turned offA supervisor or administrator turned your agent offAsk the agent's owner or your administrator to turn it back on

On a Mac, the AgentPass app can also open an AI Agent Blocked window from the menu bar. It means a tool tried to reach its AI provider directly instead of through the gateway, usually because the tool was already running when your organization's settings were applied. The window names the tool, and says what to restart:

  • To restart only the tool, click its Quit button, such as Quit Claude Code, then start the tool again.
  • If the window says the terminal must restart too, quit your terminal app and open it again, then start the tool. A new tab in the same terminal is not enough.

When AgentPass routes a tool that is already open, the Mac shows that the tool is now routed through the HYPR gateway. Restart the tool to apply it.

For the same notices from the point of view of everyone in your organization, see When a Message Is Blocked.

Where to Go Next​

If you want toGo to
Message your agent while it worksHaving Conversations with Your Agent
Use a channel from Claude Code or CodexClaude and Codex Channels
See which tools Endpoint Guard sets upLocal Agents
Turn your agent offTurning an Agent Off