Connect

Connect agentgov to the app you already use

Your people do it once, in a few minutes, from their invitation. IT can go further on company computers with the settings files agentgov writes.

For your people

Each person opens the link in their invitation; the join page shows the steps for their app and turns green once it is connected. The same steps are here. Sign in with your work email, the one IT invited.

Addresshttps://agentgov-mcp.adnan-c3a.workers.dev/mcp
Claudethe app or claude.ai
  1. Open Claude (the app or claude.ai) and go to Settings, then Connectors.
  2. Click Add custom connector.
  3. Type the name agentgov and paste the address below.
  4. Click Add, then Connect.
  5. Sign in with your work email: type it, then open the link we send you (or type the 6-digit code).
https://agentgov-mcp.adnan-c3a.workers.dev/mcp

On a Team or Enterprise plan an owner may have to add it for everyone first. No Add custom connector in your settings? Ask IT.

Steps not yet checked on every plan. If a menu is named differently, tell IT from your invitation page.

Then say company rules to your agent. For work that needs approval, say I have an idea for … and it asks IT for you.

For IT: your computers

On company computers with Claude Code, Codex or Cursor, IT can deploy settings files the way it deploys other settings. Then the app itself enforces some rules, and reports each session and tool by name, even when the agent forgets to.

1. A reporting key

Make one on the dashboard's Connect page; it is shown once. It can only write activity to your organisation: it cannot read anything, see people or rules, or touch another organisation. Someone who copies it from a computer could send activity under a false name, so retire it at once or with a week's overlap when a computer leaves.

2. The reporting script

agentgov-report.sh for macOS and Linux, agentgov-report.ps1 for Windows. The app runs it at each session start and before each tool. It reads the app's report on the computer, keeps only the names below and sends them in the background (on Windows it waits at most two seconds); it never stops the app.

3. The settings files

Generated from your rules: Claude Code's managed-settings.json, Codex's requirements.toml and hooks, Cursor's hooks.json. They hold no key. Download them from the dashboard after each rules change you want enforced.

What the script sends

  • the event: a session started or ended, a tool is about to run
  • the tool's name and its connector's name
  • the session's id and the permission mode
  • which app, and the person's email as the computer knows it (set per computer by IT)

What it never sends

  • prompts, answers or the chat
  • file contents or file names
  • commands and their details, tool inputs and outputs
  • anything else: our server refuses any other field, and keeps nothing for a person who has not joined

Where the files go

FilemacOSLinuxWindows
The reporting script/Library/Application Support/agentgov/agentgov-report.sh/opt/agentgov/agentgov-report.shC:\ProgramData\agentgov\agentgov-report.ps1
Claude Code managed-settings.json/Library/Application Support/ClaudeCode//etc/claude-code/C:\Program Files\ClaudeCode\
Codex requirements.tomlyour device management, or /etc/codex//etc/codex/%ProgramData%\OpenAI\Codex\
Cursor hooks.json/Library/Application Support/Cursor//etc/cursor/C:\ProgramData\Cursor\

Claude Code

Tested. The settings file adds agentgov for everyone, enforces the rules marked "enforced" and partly enforces those marked "partly", and reports every session and tool by name.

Codex

Requirements and hooks from Codex's documentation.

Not yet checked on a real account: the hook names and where managed hooks go.

Cursor

Hooks that only watch: session start and end, shell runs and connector calls after they ran, by name. They never block anything.

Not yet checked on a real account: the connector's name in each call.

Steps not yet checked on every plan for Codex and Cursor. Each person's email comes from the computer, set by IT, so a computer's report is shown with its key's label and a rule hit from a computer is marked "not confirmed".

What each app lets agentgov see

How much IT sees depends on the app, and on whether IT deployed the settings files.

Appagentgov seesagentgov never seesRules enforced by the app
Claude Code + IT's managed settingsevery session start and end; the name of every tool the agent uses (built-in and connectors) and its server; the permission mode; calls to agentgov; the agent's short reportsprompts, answers, file contents, commands, tool inputs and outputs — the reporting script reads the app's report on the computer, keeps only the names and sends nothing elsethe rules marked Enforced (allowed connectors, models, the skip-all-permissions mode, company-only settings); those marked Partly enforced in part (common forms of a command are stopped, other forms are not)
Codex + IT's requirements and hooks (not yet checked on a real account)session start and end; tool names; calls to agentgov; the agent's short reportsthe same as above; hosted tools such as web search are not covered by Codex hooksthe rules marked Enforced or Partly enforced for Codex (approval policies, sandbox modes, the allowed connectors)
Cursor + IT's hooks filesession start and end; shell runs and connector calls after they ran (names only); calls to agentgov; the agent's short reportsthe same as abovenone generated (agentgov's Cursor hooks only watch); settings in Cursor's admin console on Enterprise plans
claude.ai, Claude desktop, ChatGPTthe connection, every call to agentgov, the agent's short reportseverything else the agent does: other connectors, files, web search, the chatonly what the app's own admin console offers; agentgov shows the steps
VS Code, Windsurf and other appsthe connection, every call to agentgov, the agent's short reportseverything elsenone
Any app without agentgov connectednothing; the person shows as not connectedeverythingnone

The limit, plainly

The limit, plainly. Rules plus watching, not a lock. agentgov tells every agent the company rules and shows IT what happened. Where IT deploys our settings files, the app itself enforces some rules. A person can still open another chat, another app or another computer.