De MCP Gateway is de beschermlaag tussen gebruikers/AI-assistenten en het onderliggende .asd framework. Dit document beschrijft het doel, de werking en beschikbare commands.
De MCP-ASD Gateway fungeert als een gecontroleerde toegangspoort tot het .asd framework. Het framework bevat kritieke infrastructuur zoals tunnel credentials, netwerk configuratie en service orchestratie.
graph LR
subgraph "Gebruikers"
U["User/Claude"]
end
subgraph "MCP Layer"
GW["MCP Gateway"]
VAL["Validatie"]
PROT["Protection"]
end
subgraph ".asd Framework"
CLI[".asd/cli.ts"]
CRED["Credentials"]
NET["Network Config"]
TUN["Tunnel Config"]
end
U --> GW
GW --> VAL
VAL --> PROT
PROT --> CLI
CLI --> CRED
CLI --> NET
CLI --> TUN
style U fill:#2563eb,color:#fff
style GW fill:#059669,color:#fff
style VAL fill:#059669,color:#fff
style PROT fill:#059669,color:#fff
style CLI fill:#7b2cbf,color:#fff
style CRED fill:#d97706,color:#fff
style NET fill:#d97706,color:#fff
style TUN fill:#d97706,color:#fff
Het .asd framework bevat permanente gwkh (Gateway Key Hash) credentials die nooit overschreven mogen worden. Directe aanroepen kunnen:
- Credentials corrumperen - Overschrijven van tunnel keys
- Services verstoren - Verkeerde netwerk configuratie
- Data verlies - Onbedoeld wissen van configuraties
De MCP Gateway biedt:
| Aspect |
Beschrijving |
| Validatie |
Controleert parameters voor uitvoering |
| Protection |
Blokkeert destructieve operaties |
| Logging |
Audit trail van alle operaties |
| Abstractie |
Stabiele interface onafhankelijk van .asd internals |
flowchart TB
subgraph "Interface Layer"
J["just mcp-asd cmd"]
end
subgraph "Gateway Logic"
M["mcp-asd.just"]
H["Help System"]
V["Validators"]
end
subgraph "Protected Operations"
TUN["tunnel"]
STAT["status"]
VER["verify"]
NET["net / net-reset"]
end
subgraph ".asd Framework"
CLI["bun .asd/cli.ts"]
GWKH["gwkh credentials"]
end
J --> M
M --> H
M --> V
V --> TUN
V --> STAT
V --> VER
V --> NET
TUN --> CLI
STAT --> CLI
VER --> CLI
NET --> CLI
CLI --> GWKH
style J fill:#2563eb,color:#fff
style M fill:#059669,color:#fff
style H fill:#059669,color:#fff
style V fill:#059669,color:#fff
style TUN fill:#1a5f7a,color:#fff
style STAT fill:#1a5f7a,color:#fff
style VER fill:#1a5f7a,color:#fff
style NET fill:#1a5f7a,color:#fff
style CLI fill:#7b2cbf,color:#fff
style GWKH fill:#d97706,color:#fff
¶ Command Reference
¶ Beschikbare Commands
| Command |
Beschrijving |
Gebruik |
| help |
Toon beschikbare commands |
just mcp-asd help |
| tunnel |
Tunnel configuratie beheer |
just mcp-asd tunnel |
| status |
Credential status |
just mcp-asd status |
| verify |
Valideer credentials |
just mcp-asd verify |
| net |
Netwerk status (TUI) |
just mcp-asd net |
| net-reset |
Reset unhealthy services |
just mcp-asd net-reset |
¶ Command Details
# Bekijk en herstel tunnel configuratie
just mcp-asd tunnel
Gebruik voor:
- Tunnel problemen diagnosticeren
- Credentials herstellen na storing
- Configuratie valideren
# Bekijk credential status
just mcp-asd status
Output bevat:
- GWKH credential staat
- Tunnel endpoint status
- Laatste sync timestamp
# Valideer alle credentials
just mcp-asd verify
Controleert:
- Credential integriteit
- Endpoint bereikbaarheid
- Configuratie consistentie
# Gebruik altijd de gateway
just mcp-asd tunnel
just mcp-asd status
just mcp-asd verify
# NOOIT direct .asd aanroepen
bun .asd/cli.ts tunnel # FOUT