Zona MCP

Ein MCP-Server, der Benachrichtigungen von einer KI-CLI an das Zona-Postfach sendet. Das Quellen-Token wird lokal gelesen und niemals ausgegeben.

Tools

Related MCP server: ntfy-mcp

Voraussetzungen

• Node.js 20+ (fetch, FormData und crypto.randomUUID).

Installation

cd mcp
npm ci

Konfiguration

Grok

[mcp_servers.zona]
command = "node"
args = ["/absolute/path/to/mcp/server.mjs"]
enabled = true

Unter Windows setze MSYS = "noglob" in [mcp_servers.zona.env], wenn du MSYS verwendest.

Claude / Cursor / andere stdio-Hosts

{
  "mcpServers": {
    "zona": {
      "command": "node",
      "args": ["/absolute/path/to/mcp/server.mjs"]
    }
  }
}

Starte die CLI nach der Änderung der MCP-Konfiguration neu.

Token

Öffne in der Zona-App Quellen, erstelle eine Quelle (oder einen neuen Schlüssel), kopiere das Token zona_live_... einmal und speichere es als eine einzelne Zeile in:

~/.zona/token

Unter Windows ist das %USERPROFILE%\.zona\token. Behandle es wie ein Passwort. Du kannst auch ZONA_SOURCE_TOKEN setzen.

HTTP (ohne MCP)

POST https://gerncrjtrdjtjvybvseb.supabase.co/functions/v1/notify
Authorization: Bearer zona_live_YOUR_SOURCE_TOKEN
Idempotency-Key: unique-event-id
Content-Type: application/json

{
  "title": "Build complete",
  "body": "The release finished.",
  "category": "build",
  "severity": "medium"
}

Bilder verwenden multipart/form-data und wiederholen den attachment-Teil einmal pro Datei (maximal fünf). Vollständige Anleitung zum Senden: Benachrichtigungen an Zona senden.

Agent-Skill

Die Datei SKILL.md in diesem Ordner ist der Prompt für KI-CLIs (/zona). Kopiere sie in das Skill-Verzeichnis des Hosts.

Lizenz

MIT