Tana Local MCP

塔纳当地MCP

英语 | 简体中文

将Codex连接到Tana Desktop本地API/MCP，以实现节点、标签和字段上的安全读/写工作流。

这项技能有什么作用

• 指南设置 tana-local MCP(add + login)
• 验证与本地健康检查脚本的连接
• 建议先阅读工作流(list_tags, search_nodes, read_node)
• 涵盖写入工作流程(edit_node, set_field_content, tag等等）

可用工具

阅读

• list_workspaces --列出可用工作区
• search_nodes --使用结构化查询进行搜索
• read_node --将节点内容作为标记读取
• get_children --获取节点的分页子节点
• list_tags --列出工作区中的标签
• get_tag_schema --获取标记的字段定义

突变

• import_tana_paste --导入分层内容
• tag --在节点中添加/删除标签
• set_field_option --设置下拉字段值
• set_field_content --设置文本/数字/日期字段值
• create_tag --创建新标签
• add_field_to_tag --向标签添加字段
• set_tag_checkbox --配置复选框行为
• check_node / uncheck_node --标记节点已完成/未完成
• trash_node --将节点移动到回收站
• get_or_create_calendar_node --获取/创建日历节点
• edit_node --使用搜索和替换编辑节点的名称和/或描述

安装

1. 将技能文件夹复制到Codex技能目录中，例如：

cp -R skills/tana "$CODEX_HOME/skills/tana"

1. 在项目中添加技能条目 AGENTS.md （名称、描述、文件路径）。

通过技能安装程序（GitHub）安装

如果您使用内置 skill-installer，直接从此仓库安装：

# Example: install from GitHub repo path
# Use the skill-installer workflow in Codex and provide:
/tana-local-mcp + path `skills/tana`

先决条件

1. Tana桌面正在运行
2. Local API/MCP server (Alpha) 在Tana Labs中启用
3. MCP服务器已配置：

codex mcp add tana-local --url http://localhost:8262/mcp

1. OAuth登录已完成：

codex mcp login tana-local

快速检查

scripts/check_tana_local_api.sh

预期：JSON格式 "status":"ok".

默认保存行为

• 当用户要求将内容保存到Tana或通过Tana记录笔记时，默认为工作区的每日笔记日节点：call get_or_create_calendar_node (granularity: "day")并通过写入 import_tana_paste 到那个节点。
• 仅当用户明确指定具体目录和标记时，才覆盖此默认值。

在提示中使用

• 使用 / 从技能面板中选择Tana本地MCP命令以执行Tana操作。
• 如果 /Tana Local MCP 未在新线程中显示，请使用 $Tana Local MCP 明确地。

存储库布局

• skills/tana/SKILL.md
• skills/tana/agents/openai.yaml
• skills/tana/references/tana-local-mcp-ops.md
• skills/tana/scripts/check_tana_local_api.sh

许可证

麻省理工学院