作者 DAWNCR0W · DAWNCR0W/affine-mcp-server
將 Claude 連接至您的 AFFiNE 工作區——涵蓋文件、資料庫、留言、Blob、使用者等 87 項工具，支援 API 金鑰、Cookie 或帳號密碼驗證。
affine-mcp-server 提供 87 項工具，涵蓋 AFFiNE 整體架構：工作區、組織、文件、資料庫、留言、歷史記錄、使用者/金鑰及 Blob 儲存。支援 AFFiNE Cloud（使用 API 金鑰）或自架伺服器（亦支援帳號密碼登入）。
%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 驅動 AFFiNE 作為輕量級 CRM。
何時使用： 記得曾寫過某主題，但忘了存在哪裡。
結果： 從自己的筆記中挖掘出組織知識。
| 工具 | 輸入參數 | 何時呼叫 | 成本 |
|---|---|---|---|
| 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，避免先列出所有文件再於程式中過濾。Workspace-scoped API token where possibleAFFINE_API_TOKEN 環境變數；切勿提交至版本控制Cookie auth on a shared machine — cookies are user-session-equivalent401 / token invalid前往「設定 > 整合 > MCP Server」重新產生金鑰，並將新金鑰貼入環境變數。
Cannot find workspace請確認是伺服器同步工作區還是本地工作區——只有同步至伺服器的工作區才可存取。
開啟 AFFiNE 介面，確認該工作區是否已啟用雲端同步。DB row rejected — field type mismatch請先取得結構描述再進行比對，日期欄位通常需要 ISO-8601 格式字串。
| 替代方案 | 何時用它替代 | 權衡 |
|---|---|---|
| Notion MCP | 您使用 Notion 而非 AFFiNE | 不同產品；生態系較為成熟 |
| Obsidian MCP | 您全面採用 Obsidian Markdown 檔案 | 本地優先；設計理念不同 |