nginx-proxy-manager-mcp
Contents of the docs

nginx-proxy-manager-mcp · Docs

Connect to Claude

Add nginx-proxy-manager-mcp as a custom connector in Claude or as a remote MCP server in Claude Code, and test it.

On this page

Requirements

  • nginx-proxy-manager-mcp is running and reachable from the internet via HTTPS, e.g. at https://npm.mcp.example.com/mcp.
  • Access is restricted (see Security).

Important

Custom connectors in Claude connect from Anthropic's servers, not from your machine. A URL that only works in your home network is not enough.

Claude (web, desktop, mobile)

  1. Settings → Connectors → Add custom connector.
  2. Name: e.g. Nginx Proxy Manager.
  3. URL: https://npm.mcp.example.com/mcp
  4. Save.

Claude connectors cannot send custom headers, so no bearer token either. Restrict the endpoint at the reverse proxy instead, e.g. with an NPM access list containing Anthropic's outbound IP addresses.

With write mode enabled, you can set per tool in Claude's connector settings whether Claude has to ask first. That makes sense for delete_*, disable_* and update_*.

Claude Code

In Claude Code you can pass the bearer token directly:

claude mcp add --transport http nginx-proxy-manager https://npm.mcp.example.com/mcp \
  --header "Authorization: Bearer your-mcp-auth-token"

This requires MCP_AUTH_TOKEN to be set on the server.

Test

Ask Claude for example:

  • "Which proxy hosts exist in Nginx Proxy Manager?"
  • "Which certificates expire in the next 30 days?"
  • "Which hosts use the access list 'Internal'?"

Claude should call list_proxy_hosts, list_certificates or list_access_lists for that.

Troubleshooting

Symptom Cause
Connector does not connect Server not publicly reachable, or the access list blocks Anthropic's IPs.
401 Unauthorized MCP_AUTH_TOKEN is set but the client sends no or a wrong token.
405 Method not allowed Expected for GET. The server is stateless and only accepts POST.
Tools are missing MCP_READ_ONLY or the allow/deny lists filter them out.
Tool reports a login error NPM_EMAIL/NPM_PASSWORD wrong, or 2FA is enabled for the user.
Tool reports 403 The NPM user lacks permissions (e.g. View Only instead of Manage).

After changing the tool set, disconnect and reconnect the connector in Claude once so it loads the new tool list.