Atsign AI Architect MCP Server

什么是 Atsign AI Architect MCP Server？

Atsign AI Architect MCP Server 将 AI 编程助手连接到 Atsign AI Architect——一款用于设计安全优先（secure-by-design）应用和智能体系统的可视化工具，让助手能够构建、校验并导出架构蓝图。

AI Architect 由 Atsign 开发。团队用它在编写代码之前绘制应用蓝图：包括组件、AI 智能体、身份、权限、数据流和通信路径。随后，蓝图会被导出为 AI 编程助手可用的结构化上下文，由助手生成基于 Atsign Platform 的代码。Atsign Platform 是 Atsign 提供的基于身份的加密通信服务，默认不暴露任何入站端口。自 2026 年 6 月起，MCP 连接让 Claude、Cursor 等助手可以根据自然语言请求起草蓝图，之后再读取已批准的版本用于代码生成。

如何使用 Atsign AI Architect MCP Server？

该服务器是一个远程 Streamable HTTP 端点，接受匿名 MCP 客户端，因此连接时无需 API Key 或请求头：

https://aiarchitect.atsign.com/mcp

如需在可视化画布上查看蓝图，请在浏览器中打开 AI Architect（Atsign 在产品页上提供免费试用）。读写画布的工具 request_current_blueprint 和 push_blueprint 需要你当前浏览器会话的 stream session ID，助手会向你索取。

Claude Code

claude mcp add --transport http atsign-ai-architect https://aiarchitect.atsign.com/mcp

Claude Desktop 和 claude.ai

进入 Settings > Connectors，选择 Add custom connector，将 URL 填为 https://aiarchitect.atsign.com/mcp。

Cursor

添加到 ~/.cursor/mcp.json 或项目的 .cursor/mcp.json：

{
  "mcpServers": {
    "atsign-ai-architect": {
      "url": "https://aiarchitect.atsign.com/mcp"
    }
  }
}

VS Code

添加到 .vscode/mcp.json：

{
  "servers": {
    "atsign-ai-architect": {
      "type": "http",
      "url": "https://aiarchitect.atsign.com/mcp"
    }
  }
}

然后提出设计需求，例如：“构建一个包含客户工作流、分析管道和受限访问 AI 智能体的 CRM 平台”（这是 Atsign 公告中的示例提示词）。

Atsign AI Architect MCP Server 的主要功能

• Atsign AI Architect 的官方 MCP 连接，由 Atsign 于 2026 年 6 月发布。
• 脚手架工具生成符合 schema 的蓝图、节点和连线 JSON，助手无需手写格式。
• 提供允许的节点类型和连接类型目录，并附带判断某事物是否应成为节点的范围界定原则。
• schema 校验会在推送或导出之前返回错误和警告。
• 与浏览器画布双向联动：拉取你当前打开的蓝图，或推送经过校验的蓝图让画布即时更新。
• “导出用于实现”功能将蓝图与 Atsign Platform SDK 指南和节点角色打包，适合在 Cursor、Claude Code 等 IDE 中使用。

Atsign AI Architect MCP Server 工具

该服务器提供 22 个工具，可分为五组：

• 目录与规则：list_node_types、list_connection_types 和 canonical_edge_style（适用于 default、async、sync、notification、rpc、stream 和 tcp 等连接类型）告诉助手蓝图可以包含什么。get_implementation_rules 在蓝图校验通过后返回用于代码生成的 Atsign Platform 规则。
• 脚手架：scaffold_blueprint 创建只有一页的空蓝图；scaffold_node 和 scaffold_edge 生成带唯一 ID 的完整节点和连线 JSON；pick_edge_handles 选择连线的出入方向。
• 布局：suggest_grid_position、suggest_horizontal_position、suggest_vertical_position 和 get_layout_constants 计算间距合理的位置。
• 编辑：delete_node、delete_edge、update_node_position、update_node_label、update_node_notes 和 update_edge_notes 用于修正或完善蓝图；提供 session ID 时会把变更流式推送到界面。
• 校验、画布与导出：validate_blueprint 按 schema 校验 JSON；request_current_blueprint 请求读取你浏览器中已加载蓝图的权限；push_blueprint 用经过校验的蓝图替换画布；export_for_implementation 返回与网页应用中 “Export Prompt” 按钮相同的输出。

Atsign AI Architect MCP Server 的使用场景

• 从空白画布开始：“设计一个支持系统，包含分诊智能体、账单智能体和人工升级路径，然后推送到我的画布。”
• 改进现有设计：“加载我当前的蓝图，找出没有备注的节点并补上简短说明。”
• 修复校验错误：让助手运行 validate_blueprint，再删除或更新出错的节点和连线。
• 从设计到代码：在 Cursor 或 Claude Code 中对已批准的蓝图调用 export_for_implementation，并按照 Atsign Platform 实现规则生成代码。

Atsign AI Architect MCP Server 常见问题排查

• push_blueprint 或 request_current_blueprint 失败。两者都需要活动的 stream session。在浏览器中打开 AI Architect，并把 stream session ID 提供给助手。
• 编辑后画布没有变化。只有提供 session ID 时，编辑工具才会把更新流式推送到界面；否则只返回更新后的 JSON。
• 手动编辑 JSON 后出现校验错误。按照工具说明的建议，让助手用 scaffold_node 和 scaffold_edge 重新生成元素，而不是手写 JSON。