用途：把 AI 助手接入 AFFiNE 工作区、文档、数据库和协作 API，实现程序化读写与管理。
主要能力：覆盖 85+ 工具，分为工作区（列出、获取、创建、更新、删除）、文档（搜索、按标题获取、读取、创建、更新、删除、移入回收站、恢复）、模板（列出、检查结构、从模板建文档）、数据库（建库、加列、加行、改行、查看 schema）、集合（列出、创建、增删文档）、评论（列出、创建、更新、删除）。支持语义化页面组合、模板实例化、块级文档变更与结构化数据处理。
使用方式：全局安装 npm i -g affine-mcp-server，或用 npx -y -p affine-mcp-server affine-mcp 临时运行，也可用 Docker 镜像 ghcr.io/dawncr0w/affine-mcp-server:latest 部署。认证可用 affine-mcp login 交互式登录，或通过环境变量 AFFINE_BASE_URL、AFFINE_API_TOKEN（推荐）及 AFFINE_EMAIL/AFFINE_PASSWORD、AFFINE_COOKIE。客户端配置写入各 AI 工具的 mcpServers 配置，Codex CLI 用 codex mcp add affine -- affine-mcp。默认 stdio，HTTP 模式设置 MCP_TRANSPORT=http 与 MCP_HTTP_PORT。
适用场景：让 AI 助手在 AFFiNE 中自动创建项目结构、搜索并更新文档、按模板生成文档、构建任务或缺陷数据库。
限制：API 令牌需手动在 AFFiNE 设置中生成；自托管才可邮箱密码登录。已列出常见错误（认证失败、工作区不存在、工具未找到、连接被拒）的排查方向。原文末尾关于能力与保真度报告部分被截断，相关内容暂未完整提供。