Journal Mandala MCP

Dies ist ein MCP-Server, um Tagebucheinträge direkt von Claude aus in Journal Mandala zu schreiben.

Verwenden Sie dies, wenn Sie Ihren „Gedankenfluss“ während eines Gesprächs in einem Mandala festhalten möchten.

Voraussetzungen

• Node.js 20+

• Claude Desktop (oder Claude Code)

• API-Schlüssel für Journal Mandala (siehe „API-Schlüssel abrufen“ für Anweisungen)

Installation

Installieren Sie es global mit npm:

npm install -g github:takezone/journal-mandala-mcp

Führen Sie denselben Befehl erneut aus, um Updates zu installieren.

Konfiguration von Claude Desktop

Bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

Betrieb mit einem Konto

{
  "mcpServers": {
    "journal-mandala": {
      "command": "journal-mandala-mcp",
      "env": {
        "JOURNAL_MANDALA_API_KEY": "jm_XXXXXXXXXXXXXXXXXXXXXXXX"
      }
    }
  }
}

Wenn Sie zwischen zwei Konten (privat / beruflich) wechseln möchten

{
  "mcpServers": {
    "journal-mandala-personal": {
      "command": "journal-mandala-mcp",
      "env": {
        "JOURNAL_MANDALA_API_KEY": "jm_PERSONAL_KEY"
      }
    },
    "journal-mandala-work": {
      "command": "journal-mandala-mcp",
      "env": {
        "JOURNAL_MANDALA_API_KEY": "jm_WORK_KEY"
      }
    }
  }
}

Beide werden in Claude als separate Tools angezeigt. Sie können per natürlicher Sprache zwischen ihnen wechseln, z. B. mit „Speichere das in work“.

Starten Sie nach der Konfiguration Claude Desktop neu.

API-Schlüssel abrufen

Derzeit müssen Sie dem Journal Mandala-Administrator (@takezone) Folgendes mitteilen, um einen Schlüssel zu erhalten:

1. Die E-Mail-Adresse Ihres Google-Kontos

2. Einen Label-Namen (z. B. alice-personal)

Sobald Sie den API-Schlüssel vom Administrator erhalten haben, kopieren Sie ihn in die oben genannte Einstellung JOURNAL_MANDALA_API_KEY.

Hinweis: In Zukunft wird eine automatische Ausstellung über den Browser möglich sein.

Verwendung

Wenn Sie Claude während eines Gesprächs bitten, z. B. „Notiere die heutigen Ereignisse im Journal“, wird das Tool add_journal_entry aufgerufen und der Eintrag zu Journal Mandala hinzugefügt.

Aufzeichenbare Felder:

• title Titel (optional)

• event Ereignis (was ist passiert)

• thought Gedanke (wie haben Sie sich gefühlt)

• entry_date Datum YYYY-MM-DD (Standard: JST heute)

• entry_time Uhrzeit HH:MM

• tags Array von Tags

• star_rating Bewertung von 1-5

Mindestens eines der Felder title, event oder thought ist erforderlich.

Optionale Umgebungsvariablen

• JOURNAL_MANDALA_API_URL — API-Endpunkt (Standard: https://journal-mandala.vercel.app)

Fehlerbehebung

• Tool wird in Claude nicht angezeigt → Möglicher JSON-Syntaxfehler in der Konfigurationsdatei. Überprüfen Sie die MCP-Protokolle im Entwicklermenü von Claude Desktop.

• API-Fehler 401 → JOURNAL_MANDALA_API_KEY ist ungültig. Bitten Sie den Administrator um eine Neuausstellung.

• Netzwerkfehler → Überprüfen Sie den Status von Vercel.

Lizenz

MIT