Skill

setup-relay-server

Use when you need to deploy the MCP relay server to a remote SSH host.

npx claudepluginhub danielrosehill/claude-code-plugins --plugin agent-relay

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Deploy the Claude Agent Relay server to a user-specified SSH host, configure it with systemd, and verify connectivity.

SKILL.md

Similar Skills

cache-components

139.3k

Guides Next.js Cache Components and Partial Prerendering (PPR): 'use cache' directives, cacheLife(), cacheTag(), revalidateTag() for caching, invalidation, static/dynamic optimization. Auto-activates on cacheComponents: true.

cache-components

mcp-builder

124.2k

Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).

9 files

anthropics-skills-13

Stats

Stars0

Forks0

Last CommitMay 3, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Setup Relay Server

Deploy the Claude Agent Relay server to a user-specified SSH host, configure it with systemd, and verify connectivity.

When to use

First-time relay server installation on a new host

Re-deploying the relay after code updates

Moving the relay to a different machine

Inputs to gather

SSH target host (e.g., user@ubuntuvm or 10.0.0.75)

Bind address for the relay (default: 127.0.0.1; use 0.0.0.0 for LAN access)

Port (default: 8844)

Optional shared bearer token for all clients (or empty to skip)

Procedure

Validate SSH connectivity to the target host.

Copy or clone the server/ directory to the host (e.g., /opt/claude-relay/).

On the host, create a Python venv and install: pip install -e .

Write /etc/claude-relay/config.toml with bind address, port, /var/lib/claude-relay/ data dir, and optional shared token.

Copy server/systemd/claude-relay.service to /etc/systemd/system/, adjust paths if needed.

Enable and start the service: systemctl enable --now claude-relay.

Test reachability: curl http://<bind>:<port>/mcp (should return status).

Print the relay URL and connection parameters the user needs for connect-as-client.

Output / side effects

Relay server running on the target host under systemd.

/var/lib/claude-relay/ created on the host for sessions, blobs, and state.

User receives: relay URL, port, recommended client_ids, and connection test result.

Safety / constraints

Do not hardcode the deployment target; accept any SSH host.

Server data lives on the relay host (/var/lib/claude-relay/), not in user data directories.

Shared token (if provided) is passed to the config but not logged; treat as sensitive.

Systemd unit runs as root; document port < 1024 restrictions if applicable.