连接智能体

Schematic Planner 通过 HTTP 提供 MCP 服务。无需安装任何东西：在账号设置中打开智能体，创建一个密钥，然后把 URL 和密钥粘贴到你的客户端中。

密钥属于你本人，而不属于某一个工作区，所以一个密钥就能访问你所属的每一个工作区。在需要选择的地方，工具会接受一个工作区参数；如果要求创建某样东西却没有指定工作区，服务器会列出可选项，而不是替你猜。

{
  "mcpServers": {
    "schematic-planner": {
      "type": "http",
      "url": "https://your-instance.example/mcp",
      "headers": { "Authorization": "Bearer sp_..." }
    }
  }
}

工具

list_workspaces: 这个密钥可以操作的工作区。
list_projects: 它能访问的项目，范围可以是整个账号，也可以限定在某一个工作区。
list_plans: 按工作区、项目和文件夹分组的计划，每一份都附有打开它的链接。
search: 在这个密钥能访问的所有计划中查找词语——标题、标识符、标签和详情——并返回它们所在的计划。画新东西之前先用它：别人已经画过的系统再画一份，工作区就会乱成一堆。
trace: 沿着流向追踪计划中的某一部分：一个节点能到达哪里，或者哪些节点能到达它，逐跳列出，并附上每一跳由什么触发、传递什么。这是阅读计划的方式：它返回的是这条线索，而不是整篇文档；遇到循环会报告出来，而不是绕着它一直走下去。
get_plan: 一次取回整份计划。大纲、图的 JSON，或者完整的 Markdown。从不包含坐标。结果末尾附有项目所用的类型和状态，智能体由此知道可以使用哪些词。
read_nodes: 以 Markdown 返回指定节点的完整详情，并附上每个节点连着什么、被什么包含。
next_task: 计划进行到哪一步，以及现在可以开始哪些工作，每项都附上详情。它依据状态的含义而不是名称来判断：已经在进行的工作、受阻的工作，以及前序工作都已完成或放弃、可以马上开始的工作。
validate: 用适用于任何计划的规则检查计划：依赖循环、没有任何连接的节点、不在任何流程中的工作，以及项目未定义的类型或状态。它只读取；修正通过 apply_ops 完成。
plan_history: 谁改了什么，按时间从新到旧——无论是人还是智能体。
create_project: 新建一个用来绘图的项目。
create_plan: 开启一份空计划；给出文件夹路径，就会归档到那个文件夹里。它是第一个调用，而不是最后一个：返回一个 id、可以查看这份计划的地址，以及项目所用的类型和状态。
apply_ops: 此后计划靠它继续生长，这也是唯一的写入入口。批量、原子，以标识符为键，所以重试是安全的；而且每一批改动都会同时到达每一个打开着的画布，看着计划的人能看到它逐步变化，而不是直接拿到一张画好的图。类型和状态会对照项目检查：只要有一个是项目里没有的，整批改动都会被拒绝，并列出现有的值。
set_plan_sources: 说明这份计划是根据哪些计划写成的。重新读取计划时，会告诉你每个来源是否还在。
layout: 重新排列。人手动拖动过的节点保持原位。
export_plan: Markdown 文件包，外加 zip 的下载链接。
delete_plan: 把一份计划移入工作区的回收站，人可以从那里恢复它。需要重新输入它的标题作为确认，这样一个写错的 id 就不会删掉别人的成果。
list_folders: 项目中的文件夹，每个都以 Specs/Billing 这样的路径列出，并附上其中归档的计划数量。
create_folder: 新建文件夹。给出路径就会建在另一个文件夹里，路径上缺少的文件夹也会一并创建。如果要的文件夹已经存在，就直接返回它。
rename_folder: 重命名文件夹。文件夹和其中的内容都留在原处。
delete_folder: 把文件夹连同其中的文件夹和计划一起移入回收站，恢复时全部一起回来。需要重新输入文件夹的名称作为确认。
move_plan: 把计划移到别处：另一个文件夹、另一个项目，或另一个工作区中的项目；跨工作区移动会让它的分享链接失效。

文件夹用路径来指定

文件夹可以嵌套，所以接受文件夹参数的工具使用从项目顶层开始的路径，例如 Specs/Billing。如果项目里只有一个文件夹叫这个名字，只写名字也可以，所以文件夹能嵌套之前写好的提示词照样可用。两个文件夹同名时，服务器不会猜，而是列出两者的路径并拒绝。

类型和状态由项目定义

每个项目定义自己的类型和状态，项目中的所有计划都使用它们。智能体从 get_plan 或 create_plan 的结果中读到它们，并写入它们的 id；写名称也可以。没有人改动过的项目使用内置的一套：idea、planned、in_progress、blocked、done、dropped，以及 feature、task、decision、note、group。项目里没有的值会被拒绝，并附上现有值的列表。智能体可以使用这套词汇，但不能修改；修改要在项目设置中进行。

节点的详情在应用里用块编辑器编写，智能体则以 Markdown 读写。表格、折叠块和标注分别以 Markdown 表格、<details> 块和 Obsidian 标注的形式往来。

为什么智能体不设置位置

让语言模型给出坐标，画出来的图没人想看，还白白耗费你的上下文。所以这些工具没有位置字段。智能体只说明什么流向哪里；布局由服务器来做，连接上的文字也由它来摆放。人拖动过的任何东西都会被固定，自动布局再也不会动它。

导出包里有什么

流向会写进每个节点的 front matter，连同触发它的是什么、传递的是什么。包含连接变成目录嵌套。依赖连接经拓扑排序，变成每个文件名前的数字前缀。每个节点都带有自己的 frontmatter，因此这个文件包完整地描述了整张图，而不是渲染出它的一张图片。依赖出现循环并不会阻止导出：循环会以稳定的方式被断开，并在 README 中报告。