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 can | Where it is covered |
|---|---|
| Keep working in your tool as usual, through the gateway | Routing and Observation |
| Approve your own agent's first connection, as its supervisor | Approve the First Connection |
| Sign in once to each MCP server your organization provides | Connecting to a Gateway MCP Connector |
| Read your own agent's requests | Viewing the Request Log |
| Answer your agent's requests and messages on your phone | Approving 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.
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
- 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.
- Sign in to your tool as usual. See How a Routed Tool Authenticates.
- Send a first request. The tool says it is waiting for approval.
- Approve the connection on Approvals in the console, or in the HYPR app. See Approve the First Connection.
- Optional: set up the HYPR app and a passkey, so approvals reach your phone. See Setting Up Your Approval Passkey.
- In Claude Code, run
/mcp, choose a gateway server, and select Authenticate. See Authorize the Connector. - Sign in to the service behind the server, such as Jira, from Approvals. See Sign In to the Service Behind It.
- 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 tool | What it means | What to do |
|---|---|---|
| A reply that starts with Blocked by policy, with the rule's name and reason | A policy stopped your request, or a step the AI was about to take | Ask 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 yet | Your agent's connection is waiting for approval | Approve 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 Approvals | The service behind an MCP server needs you to sign in | Open the request on Approvals, and click Authenticate |
| This agent is turned off | A supervisor or administrator turned your agent off | Ask 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 to | Go to |
|---|---|
| Message your agent while it works | Having Conversations with Your Agent |
| Use a channel from Claude Code or Codex | Claude and Codex Channels |
| See which tools Endpoint Guard sets up | Local Agents |
| Turn your agent off | Turning an Agent Off |
Related
- Get Started as a Supervisor — the console role you hold as your agent's supervisor
- Onboarding Your Agent — point a tool at the gateway by hand, and approve it
- Using AI Tools with HYPR AgentPass — the plain-language guide for everyone in your organization