notis-mcp

Notis MCP

当当前 Agent 已连接托管式 Notis MCP，且没有 Shell 或 Notis CLI 访问权限时，请使用本指南。

核心工作流

1. 需要了解已连接或可连接的集成时，调用 notis_list_toolkits。
2. 使用对完整任务的具体描述调用 notis_search_tools。返回的目标工具名称必须原样使用。
3. 如果结果包含 required_resource_uri，请先读取该 MCP 资源，再构造目标调用。如果客户端无法读取 MCP 资源，请使用相同的 URI 调用 notis_fetch。
4. 搜索结果含糊不清，或需要当前完整的 JSON Schema 时，调用 notis_describe_tools。
5. 执行前调用 notis_validate_calls。
6. 仅对归类为 read 通道的目标工具使用 notis_execute_read。仅对归类为 write 通道的目标工具使用 notis_execute_write。
7. 为每个写入调用指定独立且稳定的 idempotency_key。只有在重试同一项预期变更时，才重复使用完全相同的密钥。

Notis 会在服务端对操作效果进行分类。切勿根据目标工具的名称推断其为只读。

由技能支持的操作指南

Notis 将复杂的操作约定发布为 notis://docs/* MCP 资源。其内容直接根据规范的 Notis 技能生成，因此资源会随着所属技能的变更而更新。

最重要的指南包括：

• notis://docs/notis-query：结构化原生数据库查询和生成的数据库 upsert
• notis://docs/notis-automation：提醒和自动化变更
• notis://docs/notis-spaces：显式安装 Store 应用
• notis://docs/notis-cli：比较通用 MCP 工作流与本地 CLI 工作流

请优先使用所选工具返回的 URI，而不要猜测适用的指南。

连接

如果所需的云工具包尚未连接，请调用 notis_connect_toolkit。将授权 URL 返回给用户，并等待用户完成服务提供商授权流程后，再重试发现操作。

无法通过托管式 MCP 配置本地桌面 MCP 服务、凭据、Shell 工具和桌面控件。完整的 Your Computer 套件（包括 Local MCP）适用于所有套餐，包括 Free；请先通过 Notis Desktop 进行配置，再从支持本地功能的 Agent 界面使用。

安全边界

• 执行任何变更前都要进行验证。
• 不要编造目标工具名称或参数。
• 除非目标工具明确要求，否则不要在搜索查询或工具参数中放入机密信息。
• 将返回的游标和标识符视为不透明值。
• 遵守服务端返回的执行通道和云端支持状态。
• 托管式 MCP 有意不提供本地应用源代码／构建／部署命令、本地文件、本地 Shell、调试覆盖项和凭据检索功能。原生 Store 和应用管理工具遵循服务端返回的功能范围及 PostHog 可见性策略。
• 所有套餐（包括 Free）均可使用技能管理功能。个别精选技能仍可能声明额外的付费权益；如有此类要求，安装或执行时会返回规范的升级要求结果。