How to Set Up Astra MCP Integration

Astra MCP allows AI assistants to securely connect with your Astra account so you can view, understand, and act on pentest data directly through conversational workflows.

What This Article Covers

This guide walks you through:

• What Astra MCP is and how it works

• Prerequisites before setup

• Step-by-step instructions to connect Astra MCP with supported AI tools

• Troubleshooting common issues

Why This Matters

Astra MCP helps you:

• Interact with security data using natural language instead of exports or screenshots

• Access targets, audits, vulnerabilities, findings, and comments in one place

• Take action faster by updating issues, adding comments, or progressing workflows

• Maintain secure, permission-based access aligned with your Astra account

How It Works

Astra MCP connects your AI assistant to your Astra account using a secure MCP server.

Once connected:

• You authenticate via a secure browser flow (SSO or 2FA supported)

• The assistant inherits your Astra permissions

• You can query and act on security data directly from chat

You can:

• Ask questions about vulnerabilities and findings

• Get contextual insights instantly

• Update issues or request rescans (based on permissions)

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

How to Set Up Astra MCP

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:

   • Name: Astra MCP

   • URL: https://mcp.getastra.com/mcp

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:

   • Name: Astra MCP

   • Server URL: https://mcp.getastra.com/mcp

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"
    }
  }
}

3. Restart Cursor if prompted

4. Start using MCP-enabled assistant

5. 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

2. Restart Claude Code if required

3. Run:

/mcp

4. Complete browser authentication

To verify:

claude mcp list

Troubleshooting

Connection Issues

• Verify the MCP server URL

• Check VPN or firewall restrictions

Authentication Errors

• Retry the sign-in process

Incorrect or Missing Data

• Ensure you are logged into the correct Astra account and organization

Once connected, you can start managing vulnerabilities, audits, and workflows directly through your AI assistant without switching tools.