Workspace-API-Schlüssel erstellen
- Öffne in Pharen Einstellungen → Persönlich → API und wähle Neuer Schlüssel. Deine Workspace-Rolle muss API-Schlüssel erstellen dürfen.
- Wähle als Zielbereich Ganzer Workspace. MCP setzt einen Workspace-Schlüssel voraus. Schlüssel für Ausgewählte Teams werden abgelehnt.
- Wähle die Berechtigungen, die das KI-Tool braucht. Für das Beispiel unten genügt Lesen für Listen (
lists:read). - 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.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. Nutzehttps://pharen.app/api/mcp als Serveradresse und gib den Workspace-API-Schlüssel als Bearer-Token im Header Authorization an.