MCP Connection

Live Server

Property	Value
SSE Endpoint	https://arifos.arif-fazil.com/sse
Messages	https://arifos.arif-fazil.com/messages
Health	https://arifos.arif-fazil.com/health
Transport	Server-Sent Events (SSE)

Claude Desktop

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "arifOS": {
      "url": "https://arifos.arif-fazil.com/sse"
    }
  }
}

Restart Claude Desktop after editing.

Claude Code (VS Code Extension)

Create .mcp.json in your project root:

{
  "mcpServers": {
    "arifOS-Remote": {
      "url": "https://arifos.arif-fazil.com/sse"
    },
    "arifOS-Local": {
      "command": "python",
      "args": ["-m", "arifos.mcp"],
      "env": {
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}

Cursor IDE

Create .cursor/mcp.json in your project:

{
  "mcpServers": {
    "arifOS": {
      "url": "https://arifos.arif-fazil.com/sse"
    }
  }
}

Local Server

Start the Server

# Install
pip install arifos

# Run SSE server
python -m arifos.mcp sse

# Or run stdio server (for local clients)
python -m arifos.mcp

Local Config

{
  "mcpServers": {
    "arifOS-Local": {
      "url": "http://localhost:8000/sse"
    }
  }
}

Environment Variables

Variable	Default	Description
PORT	8000	Server port
HOST	0.0.0.0	Bind address

Health Check

curl https://arifos.arif-fazil.com/health

Expected response:

{
  "status": "healthy",
  "version": "v52.5.1-SEAL",
  "motto": "DITEMPA BUKAN DIBERI",
  "endpoints": {
    "sse": "/sse",
    "messages": "/messages",
    "health": "/health",
    "docs": "/docs",
    "dashboard": "/dashboard",
    "metrics": "/metrics/json"
  }
}

Troubleshooting

Issue	Solution
Connection refused	Check if server is running
404 on /sse	Verify URL doesn't have trailing slash
Tools not showing	Restart client after config change
Timeout	Check firewall/network settings