allinkl-mcp

MCP-Server für die All-Inkl KAS-API — DNS, Domains, Subdomains, Mail-Postfächer, Mail-Weiterleitungen und Datenbanken verwalten, plus DB-Dump via SSH+mysqldump.

Die KAS-API kann Datenbanken nur anlegen/löschen — kein Dump. Deshalb läuft database_dump über SSH auf dem KAS-Paket.

Setup

cd ~/Projects/allinkl-mcp
pnpm install
cp .env.example .env      # dann .env ausfüllen
pnpm build

.env:

• KAS_LOGIN — Account-Nummer, z.B. wXXXXXX

• KAS_AUTH_DATA — API-Passwort (KAS → Tools → API, nicht das Login-Passwort)

• KAS_SSH_HOST — Host-Alias aus ~/.ssh/config, der auf die KAS-Shell führt (für database_dump)

Related MCP server: dynadot-mcp

Erstmal testen (ohne MCP)

pnpm kas get_databases
pnpm kas get_dns_settings '{"zone_host":"example.com"}'

Der erste Call ist der echte Test der SOAP-Signatur — falls KAS meckert, justieren wir src/kas/client.ts (Param-Name / Response-Unwrap).

In Claude Code einbinden

{
  "mcpServers": {
    "allinkl": {
      "command": "node",
      "args": ["/path/to/allinkl-mcp/dist/index.js"]
    }
  }
}

Sicherheit (wichtig — geteilter Produktiv-Account)

• Read-only per Default. add/update/delete sind gesperrt, bis KAS_ALLOW_WRITES=1 gesetzt ist (dann MCP neu starten). Reads + database_dump gehen immer.

• kas_raw: nur get_*-Actions ohne Flag; alles andere braucht Writes on.

• DB-Passwörter werden in database_list geschwärzt (opt-in via reveal_passwords: true).

• Calls werden serialisiert (kein Flood-Race), Flood-Fehler werden einmal automatisch wiederholt, SOAP-Calls haben Timeout.

Verifizierungs-Status der Schreib-Params:

• DNS add/update/delete — ✅ live verifiziert (add setzt automatisch den von KAS geforderten Trailing-Dot auf die Zone).

• Übrige Writes (subdomain / mail / database / ftp / cronjob / domain / ssl) — ⚠️ nicht live verifiziert. Feldnamen sind an hl9020/mcp-all-inkl ausgerichtet (s.u.), aber ungetestet. Vor erstem Einsatz an einem unkritischen Objekt prüfen.

Alle Listen-Tools akzeptieren optional pick (nur diese Felder) und filter (z.B. {"record_type":"MX"}) zum Token-Sparen.

Tools (50)

Credits

Param-Namen für die Write-Actions und die pick/filter-Idee sind hl9020/mcp-all-inkl (MIT) entlehnt. Dieser Server ergänzt das um eine Safety-Schicht (read-only-Default, Delete- Confirm, Zonen-Allowlist, Audit-Log, Passwort-Redaction) und den SSH-DB-Dump.