Atono

Atono MCP 服务

为你的 AI 编码工具提供团队的产品背景信息。

你的 AI 工具速度快、信心十足，却只能猜测产品的实际运作方式。它们只能根据能够获取的背景信息采取行动，因此产出的工作看起来正确、通过评审、成功发布，却在几周后失败。

Atono MCP 服务可将 Claude Code、Claude Desktop、Cursor、VS Code、Copilot、Windsurf 和 Codex 直接连接到 Atono 工作区。提供 41 个工具，用于读取和编写故事、缺陷、史诗、子任务、验收标准和时间盒；还提供两项真正能改变输出质量的功能：工作区的产品概念词汇表，以及各条目的 AI 背景信息（设计决策、调查、摘要）。

Agent 不再需要在每次会话中重新学习你的领域知识。

快速开始

前置条件

1. Docker Desktop v27.0 或更高版本，并在后台运行
2. Atono API 密钥——工作区设置 → 管理 API 密钥
3. 支持 MCP 的工具

Claude Code

claude mcp add --transport stdio atono \
  --env X_API_KEY=YOUR_ATONO_API_KEY \
  -- docker run --pull=always -i --rm -e X_API_KEY atonoai/atono-mcp-server:latest

运行 /mcp，确认 Atono 已显示。

Claude Desktop

claude_desktop_config.json：

{
  "mcpServers": {
    "atono": {
      "command": "docker",
      "args": [
        "run", "--pull=always", "-i", "--rm",
        "-e", "X_API_KEY=YOUR_ATONO_API_KEY",
        "atonoai/atono-mcp-server:latest"
      ]
    }
  }
}

Cursor

通过 Cursor MCP 目录 一步安装，
或添加到 mcp.json：

{
  "mcpServers": {
    "atono-mcp-server": {
      "command": "docker",
      "args": [
        "run", "--pull=always", "-i", "--rm",
        "-e", "X_API_KEY=YOUR_ATONO_API_KEY",
        "atonoai/atono-mcp-server:latest"
      ]
    }
  }
}

VS Code（GitHub Copilot）

Copilot Chat → 配置工具 → 添加 MCP 服务 → Docker Image → atonoai/atono-mcp-server:latest，
然后在 .vscode/mcp.json 中使用相同的 JSON，并重启服务。

Windsurf

在 mcp_config.json 中使用与 Cursor 相同的 JSON。重启 Windsurf。

OpenAI Codex

~/.codex/config.toml：

[mcp_servers.atono]
command = "docker"
args = ["run", "--pull=always", "-i", "--rm", "-e", "X_API_KEY", "atonoai/atono-mcp-server:latest"]

[mcp_servers.atono.env]
X_API_KEY = "YOUR_ATONO_API_KEY"

**验证：**询问你的助手 “有哪些 Atono MCP 工具可用？”

**更新：**无需操作。重启时，--pull=always 会获取最新映像。

41 个工具

设置与背景信息（5 个） atono_configuration · atono_list_users · atono_list_teams · atono_get_team_workflow · atono_get_glossary

故事（10 个） atono_get_story · atono_list_story_personas · atono_create_story · atono_update_story_title · atono_update_story_content · atono_update_story_ac · atono_update_story_additional_content · atono_update_story_team · atono_update_story_step · atono_update_story_assignee

缺陷（7 个） atono_list_environments · atono_get_bug · atono_create_bug · atono_update_bug · atono_update_bug_step · atono_update_bug_assignee · atono_document_bug_fix

史诗（7 个） atono_create_epic · atono_get_epic · atono_update_epic_title · atono_update_epic_description · atono_update_epic_user_stories · atono_add_story_to_epic · atono_remove_story_from_epic

子任务（4 个） atono_get_subtasks · atono_create_subtask · atono_update_subtask · atono_delete_subtask

附件（3 个） atono_upload_file_url · atono_create_attachment · atono_get_attachment

时间盒（2 个） atono_list_timeboxes · atono_list_timebox_items

关联条目（1 个） atono_link_bugs_or_stories

AI 背景信息（2 个） atono_get_ai_context · atono_update_ai_context

完整参考：docs.atono.io/docs/atono-mcp-tools

Agent 注意事项

• 始终先调用 atono_get_ai_context，再调用 atono_update_ai_context。
• 某些写入操作会替换内容，而不是追加。 atono_update_story_ac 和
  atono_update_epic_user_stories 会替换所有标准／陈述。atono_update_epic_description 和 atono_update_story_additional_content 也一样。
  请先读取。
• 服务只能访问 API 密钥所认证的工作区。它只开放 Atono 中已定义的操作，不提供其他功能。
• 将 API 密钥视为密码。切勿提交它们。
• Agent 的操作会标明执行者且可审计——通过 MCP 执行的更改会在 Activities 中显示“由 MCP 服务执行”，而实际操作的人员仍会作为署名作者。

套餐

MCP 服务适用于 Atono 的所有套餐，包括 Free 套餐（最多 25 位用户）。

有一点值得提前了解：Glossary 和 AI Context 在 Free 套餐中提供 30 天试用期。试用期结束后，如果将 Agent 连接到 Free 工作区，你会发现工具仍然存在，但它们获取的上下文为空。这是许可状态导致的，并非错误——这是最常见的意外情况，所以我们宁愿在这里说明。

	Free	Starter	Growth
MCP 服务和全部 41 个工具	✓	✓	✓
产品知识（Glossary + AI Context）	30 天试用期	✓	✓
价格	$0，最多 25 位用户	$19/用户/月	$39/用户/月

atono.io/pricing

关于 Atono

Atono 是一个产品工程平台，能让产品上下文与工作保持关联，帮助你的团队及其 AI Agent 构建真正符合预期的产品，而不只是看起来正确的产品。

在 Atono 中，一个故事包含其验收标准、控制发布的功能标志、证明是否奏效的使用数据，以及 Agent 读取的 AI 上下文——所有内容都集中在一个对象中。在传统技术栈中，这四项内容分散在四种产品中，而上下文会在每个衔接处丢失。

atono.io · 文档 · MCP 服务文档