Skip to content
Railgrid Docs
Sections
Open console

Enter a topic to search documentation.

    railgrid mcp claude

    Add the workspace MCP server to Claude Code

    Synopsis

    Registers the workspace’s aggregate MCP server with Claude Code (claude mcp add –transport http), authenticated with the workspace’s long-lived MCP token. An existing entry with the same name is replaced.

    When the hub’s certificate is not publicly trusted, the command prints how to start Claude Code so it accepts it: with –ca-file, by trusting that CA (NODE_EXTRA_CA_CERTS); without it, by turning certificate verification off (NODE_TLS_REJECT_UNAUTHORIZED=0) for that session.

    Terminal
    railgrid mcp claude [flags]

    Examples

    Terminal
      # Publicly trusted hub
      railgrid mcp claude
    
      # Local hub from railgrid dev init
      railgrid mcp claude --ca-file railgrid-hub-ca.crt

    Options

    TEXT
          --ca-file string          PEM CA that signs the hub's certificate, for a hub whose certificate is not publicly trusted (railgrid dev init writes <cluster>-ca.crt)
          --dry-run                 Print the commands instead of running them
      -h, --help                    help for claude
          --mcpserver-name string   Aggregate MCPServer to connect (default "default")
          --name string             Server name in the client's configuration (default: railgrid-<mcpserver-name>)
          --scope string            Claude Code configuration scope: user (every project), local (this project, private) or project (.mcp.json) (default "user")

    Inherited options

    TEXT
          --insecure-skip-tls-verify   Skip TLS certificate verification when talking to the hub
          --kubeconfig string          Path to the kubeconfig file (default: $KUBECONFIG, then ~/.kube/config)

    See also

    • railgrid mcp — MCP endpoints for AI clients (Claude Code, Cursor, Codex)