TaskFlow: ein MCP-Server, der auf dem Appwrite-OAuth2-Server basiert

TaskFlow ist ein kleiner Aufgabenmanager, der auf Appwrite basiert. Er enthält einen entfernten MCP-Server, der als Appwrite-Funktion gehostet wird, sodass KI-Tools wie Claude Desktop mit Erlaubnis des Benutzers dessen Aufgaben lesen und verwalten können.

Das Interessante daran ist die Authentifizierung. Das Appwrite-Projekt von TaskFlow fungiert als OAuth2-Server: KI-Clients registrieren sich selbst, Benutzer genehmigen den Zugriff auf einem von TaskFlow gehosteten Zustimmungsbildschirm, und der MCP-Server verifiziert die vom Projekt ausgestellten Token. Es werden keine API-Schlüssel ausgegeben, und Benutzer können ein Tool jederzeit trennen.

Begleit-Repository für das Appwrite-Blog-Tutorial „Verwandeln Sie Ihre App in einen MCP-Server".

Layout

apps/taskflow          The TaskFlow web app (TanStack Start): tasks, sign-in,
                       the OAuth2 consent screen, and a connected apps page.
functions/taskflow-mcp The MCP server, deployed as an Appwrite Function.
scripts                One-time database provisioning.

Related MCP server: Motion MCP Server

Einrichtung

1. Erstellen Sie ein Appwrite-Projekt und kopieren Sie .env.example in .env mit Ihrem Endpunkt, Ihrer Projekt-ID, einem API-Schlüssel (Scopes: sessions.write, users.read, apps.read, databases.read, databases.write, tables.read, tables.write) und einem zufälligen Session-Secret.

2. Installieren und provisionieren Sie die Datenbank:

   pnpm install
   pnpm provision

3. Öffnen Sie in der Konsole Auth > OAuth2-Server, aktivieren Sie den Server, setzen Sie die Autorisierungs-URL auf http://localhost:4100/oauth/consent und fügen Sie die Scopes tasks.read und tasks.write hinzu.

4. Stellen Sie die Web-App und den MCP-Server bereit (verwendet die Appwrite-CLI) und setzen Sie dann die Site-Variablen in der Konsole (gleiche Werte wie in .env):

   appwrite login
   appwrite push site --site-id taskflow
   appwrite push function --function-id taskflow-mcp --activate

5. Aktualisieren Sie die Autorisierungs-URL des OAuth2-Servers auf https://<SITE_DOMAIN>/oauth/consent.

6. Verbinden Sie sich mit Claude Code und verwenden Sie die Domain der Funktion aus der Bereitstellungsausgabe:

   claude mcp add --transport http taskflow https://<FUNCTION_DOMAIN>/mcp

   Führen Sie /mcp in Claude Code aus und wählen Sie Authenticate. Melden Sie sich als TaskFlow-Benutzer an, genehmigen Sie den Zugriff und fragen Sie Claude nach Ihren Aufgaben.

Live-Demo

Das bereitgestellte Ergebnis dieses Repository: die App unter taskflow.appwrite.network und der MCP-Server unter https://taskflow-mcp.appwrite.network/mcp. Erstellen Sie ein Konto, verbinden Sie Claude Code mit dem obigen Befehl und verwalten Sie Ihre Aufgaben aus dem Gespräch.