Zum Hauptinhalt springen
Über den Pharen-MCP-Server können Codex und andere KI-Tools Aktionen in Pharen ausführen. Codex kann ein Dokument lesen und daraus Listeneinträge erstellen, wenn der Schlüssel beide Berechtigungen hat.

Workspace-API-Schlüssel erstellen

  1. Öffne in Pharen Einstellungen → Persönlich → API und wähle Neuer Schlüssel. Deine Workspace-Rolle muss API-Schlüssel erstellen dürfen.
  2. Wähle als Zielbereich Ganzer Workspace. MCP setzt einen Workspace-Schlüssel voraus. Schlüssel für Ausgewählte Teams werden abgelehnt.
  3. Wähle die Berechtigungen, die das KI-Tool braucht. Für das Beispiel unten genügt Lesen für Listen (lists:read).
  4. Kopiere den phk_-Schlüssel, sobald Pharen ihn anzeigt. MCP nutzt dieselben Pharen-API-Schlüssel wie die REST-API. Das Tool kann Aktionen ausführen, für die sowohl der Schlüssel als auch die Person, die ihn erstellt hat, berechtigt sind.

Codex einrichten

Verwende die Codex-CLI in Bash oder Zsh. Führe die folgenden Befehle aus und füge deinen Schlüssel ein, wenn das Terminal danach fragt. Die Eingabe bleibt dabei verdeckt.
Starte Codex aus dem Terminal, in dem PHAREN_MCP_TOKEN gesetzt ist. Für eine andere Pharen-Instanz findest du die Serveradresse in deren API-Einstellungen. Prüfe die Verbindung mit diesem Leseauftrag.
Zeig mir bis zu fünf Pharen-Listen, die ich mit diesem Schlüssel lesen kann.
Über search findet der Agent verfügbare Aktionen. Über execute ruft er sie auf und kann mehrere Aktionen in einem Aufruf verbinden.

Andere MCP-Clients verbinden

Füge einen MCP-Server mit dem Transport Streamable HTTP hinzu. Nutze https://pharen.app/api/mcp als Serveradresse und gib den Workspace-API-Schlüssel als Bearer-Token im Header Authorization an.