TaskFlow: Appwrite OAuth2 서버로 구동되는 MCP 서버

TaskFlow는 Appwrite로 구축된 작은 작업 관리자입니다. Appwrite Function으로 호스팅되는 원격 MCP 서버를 제공하여 Claude Code와 같은 AI 도구가 사용자의 허락을 받아 사용자의 작업을 읽고 관리할 수 있습니다.

흥미로운 부분은 인증입니다. TaskFlow의 Appwrite 프로젝트가 OAuth2 서버 역할을 합니다. AI 클라이언트가 스스로 등록하고, 사용자는 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로 복사하여 엔드포인트, 프로젝트 ID, API 키(범위: sessions.write, users.read, apps.read, databases.read, databases.write, tables.read, tables.write) 및 임의의 세션 시크릿을 입력합니다.

2. 데이터베이스를 설치하고 프로비저닝합니다:

   pnpm install
   pnpm provision

3. 콘솔에서 Auth > OAuth2 server를 열고 서버를 활성화하고 인증 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. OAuth2 서버의 인증 URL을 https://<SITE_DOMAIN>/oauth/consent로 업데이트합니다.

6. 배포 출력의 함수 도메인을 사용하여 Claude Code에서 연결합니다:

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

   Claude Code에서 /mcp를 실행하고 Authenticate를 선택합니다. TaskFlow 사용자로 로그인하고 액세스를 승인한 다음 Claude에게 작업에 대해 물어보세요.

라이브 데모

이 저장소의 배포 결과: 앱은 taskflow.appwrite.network에, MCP 서버는 https://taskflow-mcp.appwrite.network/mcp에 있습니다. 계정을 만들고 위 명령으로 Claude Code를 연결한 다음 대화에서 작업을 관리하세요.