MCP Setup

Configure Claude Code or Claude Desktop to connect to your NeXuS MCP server.

Prerequisites

1. NeXuS MCP server running (nexus-mcp container)
2. Cloudflare Service Token credentials (for production)
3. Claude Code or Claude Desktop installed

Claude Code Configuration

Add to ~/.claude/mcp_servers.json:

{
  "nexus-mcp": {
    "url": "https://mcp.sebhosting.com/mcp",
    "headers": {
      "cf-access-client-id": "your-service-token-id",
      "cf-access-client-secret": "your-service-token-secret"
    }
  }
}

Claude Desktop Configuration

Add to your Claude Desktop MCP settings:

{
  "mcpServers": {
    "nexus-mcp": {
      "url": "https://mcp.sebhosting.com/mcp",
      "headers": {
        "cf-access-client-id": "your-service-token-id",
        "cf-access-client-secret": "your-service-token-secret"
      }
    }
  }
}

Local Development

For local development without Cloudflare, connect directly:

{
  "nexus-mcp": {
    "url": "http://localhost:5001/mcp"
  }
}

No authentication headers are needed when CF_SERVICE_TOKEN_ID and CF_SERVICE_TOKEN_SECRET are not set in the MCP server's environment.

Creating Cloudflare Service Tokens

1. Go to Cloudflare Zero Trust → Access → Service Auth
2. Create a new Service Token
3. Copy the Client ID and Client Secret
4. Add them to your NeXuS .env file:

CF_SERVICE_TOKEN_ID=your-client-id
CF_SERVICE_TOKEN_SECRET=your-client-secret

5. Restart the MCP server: docker compose restart mcp-server

Verifying the Connection

Once configured, ask Claude:

"Use nexus_health_check to check all services"

You should see a health check response listing all NeXuS services with their HTTP status codes.

Available Tools

After connecting, Claude will have access to 8 tools:

Tool	What it does
nexus_list_containers	List all containers with resource usage
nexus_container_stats	Detailed stats for one container
nexus_restart_container	Restart a service
nexus_stop_container	Stop a container (requires confirmation)
nexus_health_check	Ping all service endpoints
nexus_system_overview	System-wide resource summary
nexus_get_logs	Fetch container logs
nexus_search_logs	Search logs for patterns