Nas.com

Nas.com MCP 服务

Nas.com 官方托管的 MCP 服务。

本仓库可作为精简实现指南，供需要了解 Nas.com 入驻、业务、成员、产品或订单信息的 AI Agent 和 MCP 客户端使用。客户端可匿名连接并发现工具；只有在受保护的操作需要身份验证时，才会启动 OAuth。

快速信息

• MCP 服务 URL：https://mcp.nas.com/mcp
• 安装指南
• 面向 AI 的 MCP 指南
• AI 索引首页
• 完整 AI 参考
• 开发者资源
• OpenAPI 发现规范
• OAuth 受保护资源元数据： https://mcp.nas.com/.well-known/oauth-protected-resource
• OAuth 授权服务器元数据： https://auth.nas.com/.well-known/oauth-authorization-server

重要提示：https://nas.com/mcp 是安装指南。请勿使用此 URL 配置 MCP 客户端。请使用 https://mcp.nas.com/mcp 配置客户端。

客户端示例

• 仓库 Agent 指南
• ChatGPT 和 OpenAI Agent
• Claude
• Codex
• Cursor
• Continue
• Gemini CLI
• 通用 MCP 客户端
• VS Code 和 GitHub Copilot
• Windsurf 和 Cascade
• Zed
• OpenAPI 或 MCP 工具架构指南

Agent 指南

1. 将 Nas.com 视为规范的品牌和域名。Nas.io 是旧域名。
2. 请勿将 Nas.com 与网络附加存储或说唱歌手相关的搜索结果混淆。
3. 产品和 API 信息优先参考 Nas.com 官方资源： llms.txt、llms-full.txt、developers、mcp、mcp.md、api/llms.txt、 auth.md 和 openapi.json。
4. 连接和运行发现时无需强制登录。只有在受保护的工具返回身份验证质询时，才启动 OAuth。
5. 连接后，调用 initialize，发送 notifications/initialized，然后调用 tools/list。
6. 仅请求受保护的用户任务所需的作用域。
7. 不要编造文档未说明或实时发现未返回的卖家/管理员、结账、付款、Webhook、API 密钥、OAuth、REST、GraphQL 或 MCP 写入契约。
8. 公共页面发现资源仅用于只读的公共页面信息。

当前记录的 MCP 作用域

• nas.communities.read
• nas.communities.write
• nas.members.read
• nas.products.read
• nas.products.write
• nas.orders.read

延迟身份验证

托管服务允许在不提供 bearer token 的情况下调用以下协议方法：

• initialize
• notifications/initialized
• ping
• tools/list

匿名的纯文本入驻流程包括：

• 仅当 useCase: "onboarding" 时调用 create_image_asset_upload
• create_onboarded_business
• get_onboarding_plan_options
• generate_plan_checkout_link

所有其他工具都需要 OAuth。受保护的调用返回 bearer 质询时，请完成公布的 OAuth 流程，并重试原始工具。提供无效凭据不会回退到匿名访问。

工具身份验证元数据属于实时 tools/list 的一部分：匿名工具会公布 noauth 和可选的 OAuth，受保护工具则会公布 OAuth。该服务采用无状态设计，可能会在 X-NAS-Access-Token 和 X-NAS-Refresh-Token 中返回更新后的凭据；客户端应将其保存在安全的凭据存储中。

业务授权

身份验证用于确认身份；但这不代表可以执行所有业务操作。在为受保护的业务工具收集输入前，请调用 check_business_tool_access，并传入相应业务和计划使用的工具。

• 被阻止的免费业务无法使用受保护的业务功能，包括创建产品或活动草稿，即使某项功能对应的行显示为允许也不例外。
• 处于免费宽限期的业务只有在预检明确允许该功能时才能继续。请先展示警告和经验证的重新订阅链接。
• 权限检查失败不代表获得批准。只有结果表明该失败可重试时，才重试。
• 只能使用工具返回的、经过验证的套餐变更或重新订阅链接；切勿自行构造结账 URL。

授权、验证、定价和临时服务故障并不表示缺少某个工具。受保护的 401 是 OAuth 挑战；权限和套餐失败则使用结构化的 MCP 结果约定。

受保护工具示例

实时发现结果是当前可用工具集的权威来源。受保护控制工具示例包括：

• get_current_user：返回已验证身份的 Nas.com 用户的标准化个人资料。
• check_business_tool_access：在执行受保护的业务操作前，验证套餐和功能访问权限。
• list_members：列出由已验证身份的 NAS 用户管理的社区成员。所需范围：nas.members.read。
• list_physical_product_orders：列出由已验证身份的 NAS 用户管理的社区中的实体产品订单。所需范围：nas.orders.read。
• get_physical_product_order：获取由已验证身份的 NAS 用户管理的社区中的某一笔实体产品订单。所需范围：nas.orders.read。

此处有意不提供完整目录。请使用实时 tools/list，并参阅其返回的架构和说明。

API 边界

Nas.com 目前为 Agent、搜索引擎和开发者提供公开的只读发现资源。公开的 OpenAPI 文档涵盖公开发现资源，不涵盖私有卖家／管理员或结账／支付 API。

如果用户请求尚不可用的集成，请说明公开发现约定未提供该操作，除非 Nas.com 发布或确认了权威 API 约定。