Connect your AI client to Astravue MCP and start managing projects, tasks, and teams directly from natural language conversations.

INFO

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.

AI Clients

Claude Code

Add Astravue MCP

Run the following command in your terminal:

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

Your browser will open automatically.
Sign in with your Astravue account and click Approve.

Confirm the connection

In a new Claude Code session, run:

/mcp

You should see astravue-mcp 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.

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

Commit .mcp.json to your repository so teammates automatically get the connection.

Claude Desktop

TIP

Requires a Claude Pro, Max, Team, or Enterprise plan.

Open Connectors

Go to Settings → Connectors in Claude Desktop.

Add a custom connector

Click Add custom connector and enter:

https://api.astravue.com/mcp

Your browser will open.
Sign in with your Astravue account and click Approve.

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

Example configuration:

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

Save the file and restart Claude Desktop.

Claude.ai(web)

TIP

Requires a Claude Pro, Max, Team, or Enterprise plan.

Open Connectors

Go to claude.ai → Settings → Connectors

Add Astravue MCP

Click Add connector and enter:

https://api.astravue.com/mcp

Your browser will open a new tab.
Sign in with your Astravue account and click Approve.

Claude Mobile (iOS / Android)

Claude Mobile uses the same connector ecosystem as Claude.ai.

Add the connector on Claude.ai (web) or Claude Desktop first — it will automatically appear on your mobile app.

No separate setup needed.

Developer IDE Clients

Cursor

Open MCP settings

Go to Cursor Settings → Tools & MCP

Add Astravue MCP

Click New MCP Server — this opens your mcp.json file

Add the following:

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

Save the file.

Your browser will open automatically. Sign in with your Astravue account and click Approve.

Project-level configuration (.cursor/mcp.json)

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

Create config file

Add a .vscode/mcp.json file to your project root.

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

Start the server

Open Command Palette:

Cmd + Shift + P (macOS)
Ctrl + Shift + P (Windows)

Run:

MCP: List Servers

Click Start next to astravue-mcp.

Authenticate with your Astravue account in the browser.

User-level configuration (all projects)

Add this to User Settings (JSON).

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

Windsurf

Open MCP settings

Open the Windsurf MCP config file:

macOS / Linux

~/.codeium/mcp_config.json

Windows

C:\Users\[username]\.codeium\mcp_config.json

Or go to New MCP plugins can be added by going to the Settings > Tools > Windsurf Settings > Add Server section.

If you cannot find your desired MCP plugin, you can add it manually by clicking View Raw Config button and editing the raw mcp_config.json file.

When you click on an MCP server, simply click + Add Server to expose the server and its tools to Cascade.

Add Astravue

Add the following to your config file:.

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

Note: If you already have other servers in your config, add "astravue-mcp" alongside them inside the existing mcpServers object — don't replace the entire file.

Reload Windsurf and authenticate with your Astravue account.

Cline

Open MCP Servers

Click the Cline icon in the VS Code sidebar → Click the menu (⋮) in the top right → Select MCP Servers.

Add Astravue MCP

Go to the Remote Servers tab and fill in:

Server Name: astravue-mcp

Server URL: https://api.astravue.com/mcp

Transport Type: Streamable HTTP

Click Add Server.

Your browser will open for OAuth authentication.
Sign in with your Astravue account and click Approve.

Manual JSON configuration (cline_mcp_settings.json)

Click Configure MCP Servers in the Configure tab to open the JSON file and add:

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

Jetbrains(IntelliJ, WebStorm, PyCharm, etc.)

Open MCP settings

Go to Settings → Tools → AI Assistant → Model Context Protocol (MCP)

Add Astravue MCP

Click Add → Select Streamable HTTP → Paste the following:

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

Click OK, then Apply.

Your browser will open. Sign in with your Astravue account and click Approve.

GitHub Copilot CLI

Add to your Copilot CLI MCP configuration at ~/.copilot/mcp-config.json:

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

Chat Clients

Mistral Le Chat(coming soon)

Open Connectors

Go to chat.mistral.ai → Settings → Connectors

Add custom connector

Click Add connector and enter:

https://api.astravue.com/mcp

Authenticate with your Astravue account in the browser.

INFO

Mistral Le Chat MCP connector support may vary. Check Mistral's documentation for the latest availability.

ChatGPT(coming soon)

TIP

Requires ChatGPT Pro, Plus, Business, Enterprise, or Education.

ChatGPT requires Dynamic Client Registration (DCR) which is planned for a future Astravue MCP update.

Other MCP Clients

For any client that supports Streamable HTTP + OAuth 2.0

Setting	Value
Server URL	https://api.astravue.com/mcp
Transport	Streamable HTTP
Authentication	OAuth 2.0 (Authorization Code + PKCE)

SSE-only clients (mcp-remote bridge)

If your client only supports SSE transport, run:

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

Point your client to the local mcp-remote process instead of the Astravue URL.

Try it

Once connected, try asking your AI assistant:

Create a project called Sprint Planning in the Engineering space

Show me all overdue tasks

Assign the login bug to Sarah and set it to high priority

Start tracking time on the API documentation task

Troubleshooting

Authentication fails or browser does not open

Sign out of Astravue at app.astravue.com, sign back in, then reconnect your AI client.

Client not found or Unknown server error

Remove the Astravue connection from your client and add it again.

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.

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.

Get started

AI Clients#

Claude Code#

Claude Desktop#

Claude.ai(web)#

Claude Mobile (iOS / Android)#

Developer IDE Clients#

Cursor#

VS Code#

Windsurf#

Cline#

Jetbrains(IntelliJ, WebStorm, PyCharm, etc.)#

GitHub Copilot CLI#

Chat Clients#

Mistral Le Chat(coming soon)#

ChatGPT(coming soon)#

Other MCP Clients#

Try it#

Troubleshooting#

FAQ#

AI Clients

Claude Code

Claude Desktop

Claude.ai(web)

Claude Mobile (iOS / Android)

Developer IDE Clients

Cursor

VS Code

Windsurf

Cline

Jetbrains(IntelliJ, WebStorm, PyCharm, etc.)

GitHub Copilot CLI

Chat Clients

Mistral Le Chat(coming soon)

ChatGPT(coming soon)

Other MCP Clients

Try it

Troubleshooting

FAQ