Astravue MCP

Astravue MCP 服务

点击图片下载完整演示（含音频）。

Astravue MCP 服务是一个基于云的桥接服务，可连接你的 Astravue 工作区与兼容的 AI 工具。完成配置后，这些工具即可实时访问你的空间、项目、任务、工时记录和自定义字段。所有操作均通过 OAuth 2.0 进行身份验证，并遵循用户现有的访问控制设置。

借助 Astravue MCP 服务，你可以：

• 搜索和浏览空间、项目和任务，无需切换工具。
• 通过自然语言创建和更新任务、子任务、检查清单和评论。
• 使用实时计时器或手动记录追踪工时，并生成工时表报告。
• 管理自定义字段，包括下拉列表、日期、货币等。
• 自动化工作流，例如冲刺规划、状态报告和批量更新任务。

该服务面向项目经理、开发者和团队，适用于使用 AI 驱动的 IDE 或助手、希望无需切换上下文即可管理工作的用户。

完整的产品文档请访问 docs.astravue.com。

Astravue 已通过验证和审核，并收录于 Claude 连接器目录。

支持的客户端

所有客户端都连接到同一端点：https://api.astravue.com/mcp 首次连接时，系统会要求你在浏览器中登录 Astravue。

设置说明

Claude 连接器目录（推荐）

Astravue 已作为经过验证的连接器，在 Claude.ai、Claude Desktop、Claude Mobile、Claude Code 和 Cowork 中提供。

1. 在 Claude.ai 或 Claude Desktop 中，前往 Customize → Connectors。
2. 点击 +，浏览连接器目录并搜索 Astravue。
3. 选择 Astravue，点击 Connect，然后登录 Astravue 并批准访问权限。
4. 开始新对话，并从 + → Connectors 菜单中启用 Astravue。

当 Claude Code 使用 Claude.ai 订阅完成身份验证后，连接器会自动可用。运行 /mcp 确认连接状态。使用 API 密钥、Bedrock 或 Vertex 的 Claude Code 会话不会加载 Claude.ai 连接器；请改用下方的直接连接命令。

Claude Code

连接器目录提供经过验证的 MCP 连接。若还需要八个引导式项目管理工作流，请安装 Astravue 插件。对于 API 密钥、Bedrock、Vertex 和自定义配置，仍可使用直接 MCP 连接。

选项 A — 安装为 Claude Code 插件（推荐）

该插件将 MCP 服务与八个预构建技能打包在一起，可自动执行常见的项目管理工作流。它已列入 Anthropic 的社区插件市场。

在 Claude Code 中运行：

/plugin marketplace add anthropics/claude-plugins-community
/plugin install astravue@claude-community
/reload-plugins

也可以直接从此仓库安装：

/plugin marketplace add AstravueOrg/astravue-mcp-server
/plugin install astravue@astravue
/reload-plugins

安装后，运行 /mcp 确认 astravue 已连接，然后打开 /plugin 并切换到 Installed 选项卡，查看打包的技能。

有关安装范围（用户、项目、本地），请参阅 Anthropic 的插件发现文档。

选项 B — 仅安装 MCP 服务

如果你只想使用原始 MCP 服务，不需要打包的技能，请运行：

claude mcp add --transport http astravue https://api.astravue.com/mcp

浏览器会自动打开。使用你的 Astravue 账户登录，然后点击 Approve。

要确认连接，请在新的 Claude Code 会话中运行 /mcp。你应该会看到 astravue 列出为已连接状态，并显示绿色标记。

claude mcp add --transport http --scope project astravue https://api.astravue.com/mcp

Claude Desktop

1. 在 Claude Desktop 中前往 Customize → Connectors。
2. 点击 +，浏览目录并搜索 Astravue。
3. 选择 Astravue，点击 Connect，然后登录并批准访问。

{
  "mcpServers": {
    "astravue-mcp": {
      "type": "http",
      "url": "https://api.astravue.com/mcp"
    }
  }
}

Claude.ai（Web）

1. 前往 claude.ai → Customize → Connectors。
2. 点击 +，浏览目录并搜索 Astravue。
3. 选择 Astravue，点击 Connect，然后登录并批准访问。

Claude Mobile（iOS / Android）

Claude Mobile 使用与 Claude.ai 相同的连接器生态系统。你可以从移动端连接器目录连接 Astravue，或先在 Claude.ai 或 Claude Desktop 上连接，然后在移动设备上使用同一个 Claude 账户。

Cursor

1. 前往 Cursor Settings → Tools & MCP
2. 点击 New MCP Server — 这会打开你的 mcp.json 文件
3. 添加以下配置：

{
  "mcpServers": {
    "astravue-mcp": {
      "url": "https://api.astravue.com/mcp"
    }
  }
}

4. 保存文件。浏览器会打开 — 使用你的 Astravue 账户登录并点击 Approve。

VS Code

1. 在项目根目录中添加 .vscode/mcp.json 文件：

{
  "servers": {
    "astravue-mcp": {
      "type": "http",
      "url": "https://api.astravue.com/mcp"
    }
  }
}

2. 打开命令面板（macOS 上按 Cmd+Shift+P，Windows 上按 Ctrl+Shift+P），运行 MCP: List Servers，然后点击 astravue-mcp 旁边的 Start。
3. 在浏览器中使用你的 Astravue 账户进行身份验证。

{
  "mcp": {
    "servers": {
      "astravue-mcp": {
        "type": "http",
        "url": "https://api.astravue.com/mcp"
      }
    }
  }
}

Windsurf

1. 打开 Windsurf MCP 配置文件：

   • macOS / Linux： ~/.codeium/mcp_config.json
   • Windows： C:\Users\[username]\.codeium\mcp_config.json
   • 或前往 Settings → Tools → Windsurf Settings → Add Server

2. 添加以下内容：

{
  "mcpServers": {
    "astravue-mcp": {
      "serverUrl": "https://api.astravue.com/mcp"
    }
  }
}

如果配置中已有其他服务，请在现有的 mcpServers 对象中添加 astravue-mcp — 不要替换整个文件。

3. 重新加载 Windsurf，并使用你的 Astravue 账户进行身份验证。

Cline

1. 点击 VS Code 侧边栏中的 Cline 图标 → 点击右上角的 菜单（⋮） → 选择 MCP Servers。
2. 前往 Remote Servers 选项卡并填写：
   • 服务名称： astravue-mcp
   • 服务 URL： https://api.astravue.com/mcp
   • 传输类型： Streamable HTTP
3. 点击 Add Server。浏览器会打开 — 登录并点击 Approve。

{
  "mcpServers": {
    "astravue-mcp": {
      "url": "https://api.astravue.com/mcp",
      "type": "streamableHttp"
    }
  }
}

JetBrains（IntelliJ、WebStorm、PyCharm 等）

1. 前往 Settings → Tools → AI Assistant → Model Context Protocol (MCP)
2. 点击 Add → 选择 Streamable HTTP → 粘贴：

{
  "mcpServers": {
    "astravue-mcp": {
      "url": "https://api.astravue.com/mcp"
    }
  }
}

3. 点击 OK，然后点击 Apply。在浏览器中使用你的 Astravue 账户登录。

Gemini CLI

将此仓库中的 gemini-extension.json 复制到 Gemini CLI 扩展目录，或将服务 URL 添加到 Gemini MCP 配置中。

其他 MCP 客户端

适用于任何支持 Streamable HTTP + OAuth 2.0 的客户端：

npx -y mcp-remote@latest https://api.astravue.com/mcp

工作原理

Astravue MCP 将工作区操作公开为 AI 助手可调用的工具。每个工具都会在你的 Astravue 工作区中执行特定操作，例如创建项目、管理任务、记录时间或获取报告。

AI 助手收到请求后，会根据用户的提示词选择合适的工具，并使用所需参数执行该工具。

身份验证： 所有工具都需要有效的已验证会话。如果工具调用因 401 Unauthorized 失败，请重新连接 AI 客户端以刷新会话。

破坏性操作： 某些工具会执行删除任务、项目或空间等破坏性操作。大多数 AI 客户端在执行这些操作前都需要确认。请务必先检查操作，再予以批准。

权限

Astravue MCP 遵循与 Astravue Web 应用相同的基于角色的访问控制。每次工具调用都会以你已验证的用户身份，并使用你现有的权限执行。你无法通过 MCP 访问或修改任何你在应用中无法访问的内容。

组织角色

空间级权限

项目级权限

任务级权限

如果工具调用返回 403 Access Denied，表示你的账户不具备执行该操作所需的角色。请联系工作区管理员更新你的权限。

工作流示例

用户向 AI 助手提出请求：

“创建一个名为 Sprint 5 的新冲刺，并添加登录、支付和 API 文档相关任务。”

AI 助手可能会执行以下工具：

1. astravue_create_project — 创建 Sprint 5 项目
2. astravue_bulk_create_tasks — 一次调用创建三个任务
3. astravue_update_task — 按需设置优先级或截止日期

这样就能通过一次对话完成复杂的项目设置。

可用工具

Astravue MCP Server 在以下类别中提供 87 个工具。

可用提示词

Astravue MCP Server 提供 15 个提示词——预先构建的工作流，可引导 AI 助手完成常见的项目管理任务。

可用资源

Astravue MCP Server 提供 6 项资源——AI 助手可将这些上下文数据附加到对话中，以获得更丰富、更准确的回复。

静态资源

资源模板

技能

此仓库包含可直接使用的技能，可自动化常见的项目管理工作流：

使用 Claude Code 或 Cursor 插件时，技能会自动提供。

数据与安全

• 所有流量均通过 HTTPS 和 TLS 1.2 或更高版本加密。
• 通过 OAuth 2.0 身份验证确保访问控制安全。
• 数据访问遵循您的工作区角色和项目级权限。
• MCP 服务绝不存储凭据——身份验证按会话处理。

详情请参阅 SECURITY.md。

速率限制

Astravue MCP 实施速率限制，以确保平台稳定。

如果超出限制，服务将返回 HTTP 429 Too Many Requests。请等待 60 秒后重试。

故障排除

常见问题

贡献

我们欢迎贡献。请参阅 CONTRIBUTING.md 了解相关指南。

行为准则

本项目遵循 Contributor Covenant。

许可证

本项目采用 Apache License 2.0 许可。

版权所有 2026 Astravue。

支持

• 在 GitHub 上提交问题
• 发送邮件至 [email protected]
• 访问 help.astravue.com