Troubleshooting

Fixes for the issues we see most. Can't find yours? Contact us and we'll help directly.

Claude Desktop

"Network access to 'github.com' is blocked by egress settings"

Adding the AgentGuards marketplace in Claude Desktop fails with a GitHub network error.

This message is coming from Claude Desktop's own network settings — it's blocking Desktop from reaching GitHub to fetch the plugin, before the request ever reaches AgentGuards. It isn't something wrong with the plugin itself.

If you're on a personal Claude plan:this is most likely a network restriction from your company's IT setup. Check with your IT team about allowing github.com for Claude Desktop.

If you're on a Team or Enterprise plan:whoever manages your organization's Claude account can check under Organization Settings → Capabilities → Network accessand confirm it isn't set to fully blocked.

Workaround — install from a terminal instead.This path doesn't go through the same restriction.

Step 1 — add and install the plugin:

Terminal

claude plugin marketplace add alelaguard/agentguards-plugins
claude plugin install agentguards-claude@agentguards

Step 2 — set your API key (find it on your dashboard under API Keys):

Mac / Linux

echo 'export AGENTGUARDS_API_KEY=your-key-here' | tee -a ~/.zshrc
export AGENTGUARDS_API_KEY=your-key-here

Use ~/.bashrc instead of ~/.zshrc on Linux.

Windows (PowerShell)

[System.Environment]::SetEnvironmentVariable("AGENTGUARDS_API_KEY", "your-key-here", "User")
$env:AGENTGUARDS_API_KEY = "your-key-here"

Both lines matter: the first one saves the key so it's still there next time you open a terminal; the second sets it in the window you already have open, since a saved value only takes effect in new windows. Run both, then restart your terminal (or Claude Desktop) once.