Astravue MCP
com.astravue由 astravue.com 發布官方發布者v1.0.1更新於 Oct 27, 2026
Manage projects, tasks, time tracking, and team collaboration through natural language.
概覽
遠端 Astravue 連接器,讓 AI 助理在你的工作區中搜尋、建立與更新空間、專案、任務、工時紀錄和自訂欄位。
- 可以做什麼
- 搜尋與瀏覽空間、專案、任務和子任務,支援關鍵字查找與任務數量統計
- 建立、更新、移動、複製和刪除任務、子任務、檢查清單、留言及任務相依關係
- 以計時器或手動方式記錄工時,並產生工時與工作量報告
- 管理自訂欄位、專案成員以及批次任務操作
- 使用內建提示完成每日站立會議、狀態報告、衝刺規劃、風險與工作量評估
- 適用情境
- 適合已在使用 Astravue 的專案經理、開發者和團隊,希望直接在 AI 助理或 IDE 中管理專案,例如把一段對話變成衝刺、任務和狀態報告,而不必切換應用程式。
- 執行需求
- 遠端 Streamable HTTP 端點,不需本機安裝套件或執行環境。需要 Astravue 帳號,並透過瀏覽器完成 OAuth 2.0 登入(不支援 API 金鑰)。所有 Astravue 方案(含免費版)皆可使用。僅支援 SSE 的用戶端需透過 mcp-remote 橋接。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Astravue MCP,將其新增到工作區。
- 連接 所需的 憑證。它們會被私密儲存,絕不會在公開頁面上展示。
- 為需要使用其工具的對話啟用該服務。
Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。
交給代理程式安裝
把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。
閱讀 https://sourceweft.com/mcp/com.astravue%2Fastravue-mcp/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。其他 MCP 客戶端
把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。
{
"mcpServers": {
"astravue": {
"type": "http",
"url": "https://api.astravue.com/mcp"
}
}
}README
[Website] [Documentation] [Latest release] [Apache License 2.0] [Official MCP Registry] [Official on PulseMCP] [Listed on Vibehackers] [Listed on MCP Market] [Listed on Glama.ai] [Verified Claude Connector] [Claude Code plugin]
[Install MCP Server in Cursor]
Astravue MCP Server
[Astravue MCP demo]
Click the image to download the full demo (with audio).
The Astravue MCP Server is a cloud-based bridge between your Astravue workspace and compatible AI tools. Once configured, it enables those tools to interact with your spaces, projects, tasks, time entries, and custom fields in real time. All actions are authenticated via OAuth 2.0 and respect the user's existing access controls.
With the Astravue MCP Server, you can:
- Search and browse spaces, projects, and tasks without switching tools.
- Create and update tasks, subtasks, checklists, and comments through natural language.
- Track time with live timers or manual entries and generate timesheet reports.
- Manage custom fields including dropdowns, dates, currencies, and more.
- Automate workflows like sprint planning, status reporting, and bulk task updates.
It's designed for project managers, developers, and teams who use AI-powered IDEs or assistants and want to manage work without context switching.
Full product documentation lives at docs.astravue.com.
Astravue is a verified and reviewed integration in the Claude Connectors Directory.
Supported Clients
All clients connect to the same endpoint: https://api.astravue.com/mcp
You will be asked to sign in to Astravue in your browser the first time you connect.
Setup Instructions
Claude Connectors Directory (recommended)
Astravue is available as a verified connector across Claude.ai, Claude Desktop, Claude Mobile, Claude Code, and Cowork.
- In Claude.ai or Claude Desktop, go to Customize → Connectors.
- Click +, browse the Connectors Directory, and search for Astravue.
- Select Astravue, click Connect, then sign in to Astravue and approve access.
- Start a new conversation and enable Astravue from the + → Connectors menu.
When Claude Code is authenticated with your Claude.ai subscription, the connector is available automatically. Run /mcp to confirm it is connected. Claude Code sessions using an API key, Bedrock, or Vertex do not load Claude.ai connectors; use the direct connection command below instead.
Claude Code
The Connectors Directory provides the verified MCP connection. For eight guided project-management workflows as well, install the Astravue plugin. A direct MCP connection remains available for API-key, Bedrock, Vertex, and custom setups.
Option A — Install as a Claude Code plugin (recommended)
The plugin bundles the MCP server with eight pre-built skills that automate common project management workflows. It is listed in Anthropic's community plugin marketplace.
Inside Claude Code, run:
Alternatively, install directly from this repository:
After install, run /mcp to confirm astravue is connected, then open /plugin and switch to the Installed tab to view the bundled skills.
See Anthropic's plugin discovery docs for installation scopes (user, project, local).
Option B — Install only the MCP server
If you only want the raw MCP server without the bundled skills, run:
Your browser will open automatically. Sign in with your Astravue account and click Approve.
To confirm the connection, run /mcp in a new Claude Code session. You should see astravue listed with a green connected status.
Share connection across a project team
Add the --scope project flag to create a .mcp.json file in your project root:
Commit .mcp.json to your repository so teammates automatically get the connection.
Claude Desktop
- Go to Customize → Connectors in Claude Desktop.
- Click +, browse the directory, and search for Astravue.
- Select Astravue, click Connect, then sign in and approve access.
Manual config file setup (advanced)
If Connectors is not available in your Claude Desktop version, edit:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Save the file and restart Claude Desktop.
Claude.ai (Web)
- Go to claude.ai → Customize → Connectors.
- Click +, browse the directory, and search for Astravue.
- Select Astravue, click Connect, then sign in and approve access.
Claude Mobile (iOS / Android)
Claude Mobile uses the same connector ecosystem as Claude.ai. Connect Astravue from the mobile Connectors Directory, or connect it once on Claude.ai or Claude Desktop and use the same Claude account on mobile.
Cursor
- Go to Cursor Settings → Tools & MCP
- Click New MCP Server — this opens your
mcp.jsonfile - Add the following configuration:
- Save the file. Your browser will open — sign in with your Astravue account and click Approve.
Project-level configuration
Create a .cursor/mcp.json file in your project root with the same config above. This scopes the connection to that project only.
VS Code
- Add a
.vscode/mcp.jsonfile to your project root:
- Open Command Palette (
Cmd+Shift+Pon macOS,Ctrl+Shift+Pon Windows), run MCP: List Servers, and click Start next toastravue-mcp. - Authenticate with your Astravue account in the browser.
User-level configuration (all projects)
Add this to your User Settings (JSON):
Windsurf
-
Open the Windsurf MCP config file:
- macOS / Linux:
~/.codeium/mcp_config.json - Windows:
C:\Users\[username]\.codeium\mcp_config.json - Or go to Settings → Tools → Windsurf Settings → Add Server
- macOS / Linux:
-
Add the following:
If you already have other servers in your config, add
astravue-mcpalongside them inside the existingmcpServersobject — don't replace the entire file.
- Reload Windsurf and authenticate with your Astravue account.
Cline
- Click the Cline icon in the VS Code sidebar → click the menu (⋮) in the top right → select MCP Servers.
- Go to the Remote Servers tab and fill in:
- Server Name:
astravue-mcp - Server URL:
https://api.astravue.com/mcp - Transport Type:
Streamable HTTP
- Server Name:
- Click Add Server. Your browser will open — sign in and click Approve.
Manual JSON configuration
Click Configure MCP Servers in the Configure tab to open cline_mcp_settings.json and add:
JetBrains (IntelliJ, WebStorm, PyCharm, etc.)
- Go to Settings → Tools → AI Assistant → Model Context Protocol (MCP)
- Click Add → Select Streamable HTTP → Paste:
- Click OK, then Apply. Sign in with your Astravue account in the browser.
Gemini CLI
Copy gemini-extension.json from this repository to your Gemini CLI extensions directory, or add the server URL to your Gemini MCP configuration.
Other MCP Clients
For any client that supports Streamable HTTP + OAuth 2.0:
SSE-only clients (mcp-remote bridge)
If your client only supports SSE transport, run:
Point your client to the local mcp-remote process instead of the Astravue URL.
How It Works
Astravue MCP exposes workspace operations as tools that AI assistants can call. Each tool performs a specific action in your Astravue workspace such as creating projects, managing tasks, logging time, or retrieving reports.
When an AI assistant receives a request, it selects the appropriate tool based on the user's prompt and executes it with the required parameters.
Authentication: All tools require an active authenticated session. If a tool call fails with
401 Unauthorized, reconnect your AI client to refresh your session.
Destructive actions: Some tools perform destructive actions such as deleting tasks, projects, or spaces. Most AI clients require confirmation before executing these operations. Always review actions before approving them.
Permissions
Astravue MCP respects the same role-based access control as the Astravue web app. Every tool call is executed as your authenticated user with your existing permissions. You cannot access or modify anything through MCP that you cannot access in the app.
Organization Roles
Space-Level Permissions
Project-Level Permissions
Task-Level Permissions
If a tool call returns
403 Access Denied, it means your account does not have the required role for that action. Contact your workspace admin to update your permissions.
Example Workflow
A user asks an AI assistant:
"Create a new sprint called Sprint 5 and add tasks for login, payments, and API docs."
The AI assistant may execute these tools:
astravue_create_project— creates the Sprint 5 projectastravue_bulk_create_tasks— creates the three tasks in one callastravue_update_task— sets priorities or due dates as needed
This allows complex project setup to be completed from a single conversation.
Available Tools
The Astravue MCP Server provides 87 tools across the following categories.
Spaces (5 tools)
Projects (6 tools)
Tasks (13 tools)
Subtasks (4 tools)
Comments (4 tools)
Checklists (4 tools)
Dependencies (3 tools)
Tags (3 tools)
Attachments (2 tools)
Time Tracking (10 tools)
Custom Fields (7 tools)
Task Statuses (5 tools)
Filters (4 tools)
Scheduled & Overdue Tasks (2 tools)
Notifications (2 tools)
Workspace & Members (3 tools)
Interactive Views (3 tools)
Available Prompts
The Astravue MCP Server provides 15 prompts — pre-built workflows that guide your AI assistant through common project management tasks.
Available Resources
The Astravue MCP Server provides 6 resources — context data that AI assistants can attach to conversations for richer, more accurate responses.
Static Resources
Resource Templates
Skills
This repository includes ready-to-use skills that automate common project management workflows:
Skills are available automatically when using the Claude Code or Cursor plugin.
Data and Security
- All traffic is encrypted via HTTPS using TLS 1.2 or later.
- OAuth 2.0 authentication ensures secure access control.
- Data access respects your workspace role and project-level permissions.
- The MCP server never stores credentials — authentication is handled per session.
For more details, see SECURITY.md.
Rate Limits
Astravue MCP enforces rate limits to ensure platform stability.
If the limit is exceeded, the server returns HTTP 429 Too Many Requests. Wait 60 seconds before retrying.
Troubleshooting
Authentication fails or browser does not open
Sign out of Astravue at app.astravue.com, sign back in, then reconnect your AI client.
401 Unauthorized error
Your OAuth session expired. Reconnect your client to trigger a new sign-in flow.
Tools not appearing in my AI client
Ensure your client supports Streamable HTTP transport. Clients that only support SSE must use the mcp-remote bridge (see Other MCP Clients).
Connection drops after some time
OAuth tokens expire periodically. Your client should refresh automatically. If it does not, reconnect once.
FAQ
Do I need a paid Astravue plan?
No. Astravue MCP works on all plans including free.
Can multiple team members connect their AI clients?
Yes. Each user authenticates with their own Astravue account.
What permissions does Astravue MCP have?
Astravue MCP only has access to resources your account already has permission to access. All actions are performed as your authenticated user.
Can I use an API key instead of OAuth?
No. OAuth 2.0 is required so every action is tied to an authenticated user.
Will the AI make changes without asking me?
Most AI clients ask for confirmation before executing write operations. Check your client's tool approval settings.
Contributing
We welcome contributions. See CONTRIBUTING.md for guidelines.
Code of Conduct
This project follows the Contributor Covenant.
License
This project is licensed under the Apache License 2.0.
Copyright 2026 Astravue.
Support
- Open an issue on GitHub
- Email [email protected]
- Visit help.astravue.com
來源:README.md,提交 dfd8bad
工具
0版本歷史
1- v1.0.1最新Sep 16, 2026
評分
已滿足適用檢查項的 85%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通必需25 分
- 已宣告認證方式必需10 分
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分