TaskFlow: MCP-сервер на базе OAuth2-сервера Appwrite

TaskFlow — это небольшой менеджер задач, построенный на Appwrite. Он включает удалённый MCP-сервер, развёрнутый как Appwrite Function, чтобы ИИ-инструменты вроде Claude Code могли читать задачи пользователя и управлять ими с его разрешения.

Самое интересное — авторизация. Проект TaskFlow на Appwrite выступает в роли OAuth2-сервера: ИИ-клиенты регистрируются сами, пользователи предоставляют доступ на экране согласия, размещённом TaskFlow, а MCP-сервер проверяет токены, которые выпускает проект. Никакие API-ключи не выдаются, и пользователи могут в любой момент отключить инструмент.

Сопутствующий репозиторий для руководства из блога Appwrite "Turn your app into an MCP server".

Структура

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

Настройка

1. Создайте проект Appwrite и скопируйте .env.example в .env, указав эндпоинт API, идентификатор проекта, API-ключ (области доступа: sessions.write, users.read, apps.read, databases.read, databases.write, tables.read, tables.write) и случайный секрет сессии.

2. Установите и настройте базу данных:

   pnpm install
   pnpm provision

3. В консоли откройте раздел Auth > OAuth2, включите сервер, укажите URL авторизации http://localhost:4100/oauth/consent и добавьте области доступа tasks.read и tasks.write.

4. Разверните веб-приложение и MCP-сервер (с использованием Appwrite CLI), затем задайте переменные окружения сайта в консоли (те же значения, что и в .env):

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

5. Обновите URL авторизации OAuth2-сервера на https://<SITE_DOMAIN>/oauth/consent.

6. Подключитесь из Claude Desktop, используя домен функции из вывода развёртывания:

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

   Запустите /mcp в Claude Desktop и выберите Authenticate. Войдите как пользователь TaskFlow, предоставьте доступ и спросите Claude о своих задачах.

Живое демо

Развёрнутая версия этого репозитория: приложение на taskflow.appwrite.network и MCP-сервер по адресу https://taskflow-mcp.appwrite.network/mcp. Создайте аккаунт, подключите Claude Code с помощью команды выше и управляйте своими задачами прямо в диалоге.