Stellary Project Management MCP Server

Stellary 项目管理 MCP 服务

通过 Model Context Protocol（MCP），将 AI 助手和编码 Agent 连接到实时 Stellary 项目。托管服务提供项目、看板、协作、驾驶舱和 Agent 任务工具，同时保留 Stellary 现有的权限。

• 端点： https://api.stellary.co/mcp
• 传输方式： Streamable HTTP
• 身份验证： OAuth 2.1（使用 PKCE 和刷新令牌轮换）；为保持兼容性，仍支持 bearer PAT

官方 MCP Registry 列表 · 文档 · 法语指南

可以执行的操作

• 发现项目、列、卡片、文档和驾驶舱状态。
• 创建和更新卡片、移动工作项、分配队友并添加评论。
• 检查迭代、优先级、Agent 状态和待处理提案。
• 根据工作区规则和审批策略运行受治理的 Agent 任务。
• 在符合条件的 Agent 会话中使用已安装的工作区集成。

OAuth 连接可以授权我本人、一个或多个活跃工作区 Agent，或两者。连接时会确定确切的工具列表，并在每次调用时再次检查所选身份。可用工具取决于 OAuth 作用域、项目访问权限、工作区配置，以及各 Agent 的工具和自主性策略。

三步完成连接

1. 将托管端点添加到支持 OAuth 的 MCP 客户端。
2. 在客户端打开的浏览器窗口中登录 Stellary。
3. 选择工作区并授权我本人、一个或多个活跃 Agent，或两者。

Claude Code

claude mcp add stellary \
  --transport streamable-http \
  https://api.stellary.co/mcp

Cursor 和基于 JSON 的客户端

{
  "mcpServers": {
    "stellary": {
      "url": "https://api.stellary.co/mcp"
    }
  }
}

可复用示例见 examples/mcp-client.json。下文介绍 Marketplace 安装和 PAT 备用方案所需的作用域。

从 Cursor Marketplace 安装

此仓库是托管 Streamable HTTP 端点的 Cursor Plugin 封装。它不会启动本地 stdio 或 npx 服务。

1. 在 Cursor 中打开自定义，并在列表上线后从 Cursor Marketplace 安装 Stellary（提交入口：发布表单）。
2. 完成 Stellary OAuth 窗口中的操作。选择工作区并授权我本人、一个或多个活跃 Agent，或两者。
3. 让 Cursor 列出你的 Stellary 项目。

在列表公开之前，请将此仓库符号链接到 ~/.cursor/plugins/local/stellary，或将相同的托管 URL 添加到 Cursor MCP 设置 / ~/.cursor/mcp.json：

{
  "mcpServers": {
    "stellary": {
      "url": "https://api.stellary.co/mcp"
    }
  }
}

Cursor 会从 Stellary 元数据中发现 OAuth。因此，Marketplace 软件包不会附带 Bearer 标头，也不会包含 ${STELLARY_TOKEN} 占位符。

兼容性 PAT（仅在 OAuth 无法完成时使用）

从账户设置 → API 令牌创建专用令牌。先使用 projects:read 和 pilotage:read。只有在客户端需要时才添加写入作用域。将密钥保存在用户 MCP 设置中，切勿放入此仓库：

{
  "mcpServers": {
    "stellary": {
      "url": "https://api.stellary.co/mcp",
      "headers": {
        "Authorization": "Bearer ${env:STELLARY_TOKEN}"
      }
    }
  }
}

面向 [email protected] / 发布表单的发布检查清单见 CURSOR_SUBMISSION.md。

建议的首次请求

请客户端列出你的 Stellary 项目。这可以在不更改数据的情况下确认身份验证和项目可见性。然后，请它检查一个项目的列和卡片，再启用写入权限范围。

安全

• 当客户端不应再拥有访问权限时，请前往 工作区设置 → MCP 连接 撤销 OAuth 连接。
• 将兼容性 PAT 视同密码，切勿将其提交到代码仓库。
• 从只读权限范围开始；需要 PAT 时，请设置过期日期。
• 所有请求仍受 Stellary 权限和速率限制约束。
• Stellary 绝不会向客户端发送附加到你的 Agent 的私有令牌。

如需报告漏洞，请参阅 SECURITY.md。如有设置问题，请发送邮件至 [email protected]。

Agent 目录清单

此代码仓库也是 Agent 插件目录的公开发现来源。支持 OAuth 的平台会指向托管的 Streamable HTTP 端点，不会嵌入密钥。对于无法完成远程 OAuth 的客户端，文档仍提供旧版 PAT 配置说明。所有配置均不会启动本地 stdio/npx 服务。

平台	文件
cursor.directory / Open Plugins	.mcp.json
Cursor Marketplace	.cursor-plugin/plugin.json、mcp.json、skills/stellary/SKILL.md、CURSOR_SUBMISSION.md
Claude Code Plugin Directory	.claude-plugin/plugin.json、.claude-plugin/marketplace.json、.mcp.json
Gemini CLI Extensions	gemini-extension.json
skills.sh / ClawHub	SKILL.md（npx skills add Anymfah/stellary-mcp）
Grok Build	.grok-plugin/plugin.json
GitHub Copilot / Agent Plugins	plugin.json
OpenAI Plugins / Codex	plugins/stellary/.codex-plugin/plugin.json、plugins/stellary/.mcp.json

仅当客户端无法使用 OAuth 时，才设置 STELLARY_TOKEN。切勿提交真实令牌。400×400 的目录图标位于 assets/logo-400.png。

关于此代码仓库

此公开代码仓库是 Stellary 托管 MCP 服务的权威发现和配置来源。其中包含官方 MCP Registry 清单、客户端示例、文档和自动可用性检查。Stellary 托管应用及服务实现不在此代码仓库中分发。

Grok Build 和 GitHub Copilot 的轻量插件清单位于 .mcp.json、.grok-plugin/plugin.json 和 plugin.json 中。这些清单指向托管端点 https://api.stellary.co/mcp（采用 OAuth 的 Streamable HTTP，并兼容 PAT）。 400×400 的目录图标位于 assets/logo-400.png。

此代码仓库中的元数据和文档根据 MIT 许可证授权。托管服务的使用受 Stellary 条款约束。