proxmox/docs/04-configuration/FINALIZE_TOKEN.md

# Final Step: Create API Token

**Last Updated:** 2026-01-31  
**Document Version:** 1.0  
**Status:** Active Documentation

---

Your `.env` file is configured with your Proxmox connection details. You now need to create the API token and add it to the `.env` file.

## Quick Steps

### Option 1: Via Proxmox Web UI (Recommended - 2 minutes)

1. **Open Proxmox Web Interface**:
   ```
   https://192.168.11.10:8006
   ```

2. **Login** with:
   - User: `root`
   - Password: `L@kers2010`

3. **Navigate to API Tokens**:
   - Click **Datacenter** (left sidebar)
   - Click **Permissions** 
   - Click **API Tokens**

4. **Create Token**:
   - Click **Add** button
   - **User**: Select `root@pam`
   - **Token ID**: Enter `mcp-server`
   - **Privilege Separation**: Leave unchecked (for full permissions)
   - Click **Add**

5. **Copy the Secret**:
   - ⚠️ **IMPORTANT**: The secret is shown only once!
   - Copy the entire secret value

6. **Update .env file**:
   ```bash
   nano ~/.env
   ```
   
   Replace this line:
   ```
   PROXMOX_TOKEN_VALUE=your-token-secret-here
   ```
   
   With:
   ```
   PROXMOX_TOKEN_VALUE=<paste-the-secret-here>
   ```

7. **Save and verify**:
   ```bash
   ./scripts/verify-setup.sh
   ```

### Option 2: Delete Existing Token First (if it exists)

If the token `mcp-server` already exists:

1. In Proxmox UI: Datacenter → Permissions → API Tokens
2. Find `root@pam!mcp-server`
3. Click **Remove** to delete it
4. Then create it again using Option 1 above

## After Token is Configured

Test the connection:
```bash
# Verify setup
./scripts/verify-setup.sh

# Test MCP server
pnpm test:basic
```

---

**Your Current Configuration**:
- Host: 192.168.11.10 (ml110.sankofa.nexus)
- User: root@pam
- Token Name: mcp-server
- Status: ⚠️ Token value needed