SuperAPI AI 工具集

notis-mcp

智能体与模型

查看项目

更新于 10-16 01:16

技能介绍

用途:当智能体通过托管的通用 Notis MCP 服务器访问 Notis、且没有 shell 或 Notis CLI 权限时,使用本指南完成工具发现、校验与执行。

主要能力与工作流:调用 notis_list_toolkits 了解哪些集成已连接或可连接;用完整任务描述调用 notis_search_tools,并严格使用返回的目标工具名。若结果含 required_resource_uri,先读取该 MCP Resource 再构造调用;客户端无法读取 Resource 时改用 notis_fetch 传入同一 URI。搜索结果含糊或需要最新完整 JSON Schema 时调用 notis_describe_tools;执行前调用 notis_validate_calls。读取类目标工具只能用 notis_execute_read,写入类只能用 notis_execute_write。每次写入调用需提供各自稳定的 idempotency_key,仅在重试同一预期变更时复用该键。效果分类由服务端判定,不得凭工具名推断为只读。

技能指南:Notis 以 notis://docs/* MCP Resource 发布复杂操作契约,内容由规范技能直接生成。主要指南包括 notis://docs/notis-query(结构化原生数据库查询与生成的数据库 upsert)、notis://docs/notis-automation(提醒与自动化变更)、notis://docs/notis-apps(显式安装 Store 应用)、notis://docs/notis-cli(对比通用 MCP 与本地 CLI 工作流)。应优先使用所选工具返回的 URI,而非猜测适用指南。

连接:所需云工具包未连接时调用 notis_connect_toolkit,把授权 URL 返回给用户,等待其完成提供方流程后再重试发现。本地桌面 MCP 服务器、凭据、shell 工具与桌面控制无法通过托管 MCP 配置;包含 Local MCP 的 Your Computer 套件在所有方案(含 Free)均可用,需先在 Notis Desktop 中配置。

安全边界:执行任何变更前先校验;不得编造目标工具名或参数;除非目标工具明确要求,不得在搜索查询或工具参数中放置密钥;游标与标识符视为不透明;遵守服务端返回的执行通道与云支持状态。本地应用源码/构建/部署命令、本地文件、本地 shell、调试覆盖与凭据获取在托管 MCP 中不可用。技能管理在所有方案(含 Free)可用,个别精选技能可能声明额外付费权益,此时安装或执行会返回标准的需升级结果。