How to Set Up Astra MCP Integration

Last updated: June 15, 2026

Introduction

Astra MCP connects your AI assistant to your Astra account so you can view, query, and act on pentest data through natural language — without switching between tools or exporting screenshots.

Once connected, your AI assistant inherits your Astra permissions and can access targets, audits, vulnerabilities, findings, and comments. You can ask questions, get contextual insights, update issues, or request rescans — all from within your preferred AI tool.

Astra MCP supports Claude Desktop, Claude Code, Cursor, VS Code, and ChatGPT (paid plan required).

Prerequisites

Before you begin, ensure:

  • You have an active Astra account with access to relevant workspaces

  • You are using an MCP-compatible tool such as:

    • ChatGPT (paid plan required)

    • Claude Desktop or Claude Code

    • Cursor

    • Visual Studio Code

  • If 2FA is enabled, your device is available for OTP verification

MCP Server URL

Use the following URL during setup:

https://mcp.getastra.com/mcp

Instructions

Step 1: Choose Your AI Tool

Select the tool where you want to use Astra MCP:

  • ChatGPT

  • Claude Desktop / Claude Code

  • Cursor

  • VS Code

Step 2: Set Up in ChatGPT (Paid Version Only)

  1. Open Settings → Data Controls and turn off Improve the model for everyone

  2. Go to Settings → Personalization and enable Connector Search

  3. Navigate to Settings → Apps and enable Developer Mode

  4. Click Create App

  5. Enter:

  6. Select OAuth as authentication

  7. Accept the risk acknowledgment

  8. Complete sign-in via browser

Once authenticated, Astra MCP will be connected.

Step 3: Set Up in Claude Desktop

  1. Open Claude Desktop

  2. Go to Customize → Connectors

  3. Click + Add Custom Connector

  4. Enter:

  5. Click Add

  6. Select Astra MCP and click Connect

  7. Complete sign-in in the browser

You’ll be redirected back once connected.

Step 4: Set Up in Cursor

  1. Open Cursor Settings → Tools and MCP

  2. Add the following configuration:

{
  "mcpServers": {
    "astra": {
      "url": "https://mcp.getastra.com/mcp"
    }
  }
}

  1. Restart Cursor if prompted

  2. Start using MCP-enabled assistant

  3. Complete browser authentication on first use

Step 5: Set Up in VS Code

  1. Open Command Palette

    • Mac: Cmd + Shift + P

    • Windows/Linux: Ctrl + Shift + P

  2. Search: MCP: Open Configuration

  3. Add:

{
  "servers": {
    "astra-mcp": {
      "url": "https://mcp.getastra.com/mcp",
      "type": "http"
    }
  },
  "inputs": []
}

Step 6: Set Up in Claude Code

  1. Run in terminal:

claude mcp add --transport http astra https://mcp.getastra.com/mcp

  1. Restart Claude Code if required

  2. Run:

/mcp

  1. Complete browser authentication

To verify:

claude mcp list

Expected Outcome

Once setup is complete, your AI assistant will be connected to your Astra account. You'll be able to:

  • Query vulnerabilities, findings, audits, and targets using natural language

  • Get instant contextual insights without leaving your AI tool

  • Update issues, add comments, or progress workflows based on your account permissions

All access is permission-based and aligned with your Astra account role — the assistant cannot access data outside your assigned workspaces.

Best Practices

  • Use the correct account. If data looks missing or incomplete, confirm you're logged into the right Astra organization.

  • Keep authentication active. If the connection drops, re-authenticate via the browser sign-in flow for your tool.

  • Check firewall and VPN settings if the MCP server URL fails to connect — ensure mcp.getastra.com is accessible from your network.

  • Limit MCP access to trusted tools. Since the assistant inherits your Astra permissions, only connect Astra MCP on devices and tools you control.

  • Reach out for help early. If setup fails, contact your Astra administrator or reach out to Astra Support at help@getastra.com before retrying repeatedly.