TaskFlow: un servidor MCP impulsado por el servidor OAuth2 de Appwrite

TaskFlow es un pequeño gestor de tareas construido sobre Appwrite. Incluye un servidor MCP remoto, alojado como una función de Appwrite, para que herramientas de IA como Claude Code puedan leer y gestionar las tareas de un usuario con su permiso.

La parte interesante es la autenticación. El proyecto de Appwrite de TaskFlow actúa como servidor OAuth2: los clientes de IA se registran, los usuarios aprueban el acceso en una pantalla de consentimiento que TaskFlow aloja, y el servidor MCP verifica los tokens que emite el proyecto. No se entregan claves API, y los usuarios pueden desconectar una herramienta en cualquier momento.

Repositorio complementario para la publicación del blog de Appwrite "Turn your app into an MCP server".

Estructura

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

Configuración

1. Crea un proyecto de Appwrite y copia .env.example a .env con tu endpoint, ID de proyecto, una clave API (ámbitos: sessions.write, users.read, apps.read, databases.read, databases.write, tables.read, tables.write) y un secreto de sesión aleatorio.

2. Instala y aprovisiona la base de datos:

   pnpm install
   pnpm provision

3. En la consola, abre Auth > OAuth2 server, habilita el servidor, establece la URL de autorización en http://localhost:4100/oauth/consent y añade los ámbitos tasks.read y tasks.write.

4. Despliega la aplicación web y el servidor MCP (usa la CLI de Appwrite), luego establece las variables del sitio en la consola (mismos valores que en .env):

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

5. Actualiza la URL de autorización del servidor OAuth2 a https://<SITE_DOMAIN>/oauth/consent.

6. Conéctate desde Claude Code, usando el dominio de la función de la salida del despliegue:

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

   Ejecuta /mcp dentro de Claude Code y elige Authenticate. Inicia sesión como usuario de TaskFlow, aprueba el acceso y pregunta a Claude sobre tus tareas.

Demo en vivo

El resultado desplegado de este repositorio: la aplicación en taskflow.appwrite.network y el servidor MCP en https://taskflow-mcp.appwrite.network/mcp. Crea una cuenta, conecta Claude Code con el comando anterior y gestiona tus tareas desde la conversación.