Connect an AI assistant

Point your AI client at this relay's MCP endpoint and it can use the tools on every machine you've been granted. The endpoint is:

https://hpusa.mcp.darky.cc/mcp

You need an access token. Ask your relay administrator — they create it in the admin console and choose exactly what it may do on each machine. Replace <TOKEN> below with the token you were given, and give each client its own. Transport is Streamable HTTP.

Command-line & config-file clients

Claude Code direct

Anthropic's CLI (and the Claude Code built into the Claude desktop app).

claude mcp add --transport http relay https://hpusa.mcp.darky.cc/mcp \
  --header "Authorization: Bearer <TOKEN>"

Add --scope user to use it everywhere. Verify with /mcp. Tools appear like web_server_1__shell_exec.

OpenAI Codex CLI direct

Edit ~/.codex/config.toml:

[mcp_servers.relay]
url = "https://hpusa.mcp.darky.cc/mcp"
bearer_token_env_var = "RELAY_TOKEN"

…then export RELAY_TOKEN=<TOKEN>.

OpenCode direct

Add to opencode.json or ~/.config/opencode/opencode.json:

{
  "mcp": {
    "relay": {
      "type": "remote",
      "url": "https://hpusa.mcp.darky.cc/mcp",
      "enabled": true,
      "headers": { "Authorization": "Bearer <TOKEN>" }
    }
  }
}

Desktop & web apps

Claude desktop app OAuth

If your administrator has enabled the OAuth connector on this relay, it works directly in the graphical Add custom connector dialog: add https://hpusa.mcp.darky.cc/mcp as a custom connector (leave the OAuth fields blank — the relay registers itself), then sign in to your relay account and approve. Claude gets a revocable, permission-scoped token — no config files.

If OAuth is not enabled, the connector dialog is OAuth-only, so use the bundled Claude Code for a static token instead — open its terminal and run the Claude Code command above.

Claude.ai (web) beta

Settings → Connectors → Add custom connector: set the URL to https://hpusa.mcp.darky.cc/mcp, and under Request headers (Advanced) add Authorization = Bearer <TOKEN> (include the literal word Bearer).

Static-header auth is in beta. If only OAuth fields appear: when your administrator has enabled the OAuth connector here, just add https://hpusa.mcp.darky.cc/mcp and sign in to your relay account instead; otherwise your account doesn't have static-header support yet.

Once connected

Ask naturally, e.g. "using the relay, show diagnostics for web-server-1". What each token may do on each machine is set by your administrator — if tools don't appear, your token hasn't been granted access yet. Need help? See support.