作者 DAWNCR0W · DAWNCR0W/affine-mcp-server
将 Claude 连接到你的 AFFiNE 工作区 — 87 个工具覆盖文档、数据库、评论、Blob 存储、用户 — 支持 API token、cookie 或 email/password 认证。
affine-mcp-server 提供 87 个工具覆盖 AFFiNE 图谱：工作区、组织、文档、数据库、评论、历史、用户/token 和 Blob 存储。支持 AFFiNE Cloud（使用 API token）或自托管（也支持 email/password）。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"affine": {
"command": "npx",
"args": [
"-y",
"affine-mcp-server"
],
"_inferred": true
}
}
}打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。
{
"mcpServers": {
"affine": {
"command": "npx",
"args": [
"-y",
"affine-mcp-server"
],
"_inferred": true
}
}
}Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。
{
"mcpServers": {
"affine": {
"command": "npx",
"args": [
"-y",
"affine-mcp-server"
],
"_inferred": true
}
}
}点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。
{
"mcpServers": {
"affine": {
"command": "npx",
"args": [
"-y",
"affine-mcp-server"
],
"_inferred": true
}
}
}格式与 Claude Desktop 相同。重启 Windsurf 生效。
{
"mcpServers": [
{
"name": "affine",
"command": "npx",
"args": [
"-y",
"affine-mcp-server"
]
}
]
}Continue 使用服务器对象数组，而非映射。
{
"context_servers": {
"affine": {
"command": {
"path": "npx",
"args": [
"-y",
"affine-mcp-server"
]
}
}
}
}加入 context_servers。Zed 保存后热重载。
claude mcp add affine -- npx -y affine-mcp-server一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。
何时使用： 你在对话中想要将要点捕获到 AFFiNE，而不需要切换上下文。
结果： 不离开聊天就能将笔记保存到 AFFiNE。
何时使用： 你想让每个来自邮件的通讯订阅者都落地到你的「Contacts」AFFiNE 数据库。
结果： 由 LLM 驱动的轻量级 CRM AFFiNE。
何时使用： 你记得在某处写过 X，但记不得在哪里。
结果： 从你的笔记中浮现的知识
| 工具 | 输入参数 | 何时调用 | 成本 |
|---|---|---|---|
| list_workspaces | 浏览你的 AFFiNE 图谱 | 1 API call | |
| search_documents | workspace_id, query, limit? | 按文本查找文档 | 1 API call |
| create_document | workspace_id, title, content, parent_id? | 添加新文档 | 1 API call |
| update_document | doc_id, content | title | 编辑现有文档 | 1 API call |
| add_database_row | database_id, fields: obj | 结构化数据输入 | 1 API call |
search_documents 而不是在代码中列出和过滤。优先使用工作区范围的 API tokenAFFINE_API_TOKEN 环境变量；永远不要提交在共享机器上使用 Cookie 认证 — Cookie 相当于用户会话401 / token 无效在 Settings > Integrations > MCP Server 处重新生成。将新 token 粘贴到环境变量中。
找不到工作区服务器支持 vs 仅本地困惑。仅服务器支持的工作区可访问。
打开 AFFiNE UI；工作区是否已云同步？数据库行被拒绝 — 字段类型不匹配先获取架构，匹配类型。日期通常需要 ISO-8601 字符串。
| 替代方案 | 何时用它替代 | 权衡 |
|---|---|---|
| Notion MCP | 你使用 Notion 而不是 AFFiNE | 不同的产品；更成熟的生态 |
| Obsidian MCP | 你完全投入 Obsidian markdown 文件 | 本地优先；不同的理念 |