Astra MCP FAQ

Last updated: November 2, 2026

This article answers common questions about connecting to and using Astra MCP.

Can Astra MCP connect with a static token or API key instead of browser sign-in?

Not at the moment. Astra MCP connects only through browser sign-in (OAuth). Headless agents or tools that accept only a fixed token cannot connect yet. To share interest in token-based access, contact help@getastra.com.

Which AI tools work with Astra MCP?

Cursor, VS Code, ChatGPT Web, the ChatGPT App, Claude Code and Claude Desktop have setup steps in Connect Astra MCP to your AI tool. Any other assistant works if it supports remote HTTP MCP servers and browser-based OAuth sign-in.

Does Astra MCP work with an organization's own or internal AI tool?

Yes, if the tool supports remote HTTP MCP servers and can open a browser for the Astra sign-in. Add https://mcp.getastra.com/mcp as an HTTP server in the tool's MCP settings and sign in when prompted. If sign-in does not complete in an older version of the tool, update it to the latest version first.

Why does opening the server URL in a browser or with curl return an error?

This is expected. https://mcp.getastra.com/mcp only answers requests from an MCP client that has completed the Astra sign-in. A direct request without that sign-in is refused with an authorization error. To check the connection, use the AI tool's own server list instead, for example MCP: List Servers in VS Code or claude mcp list in Claude Code.

The connection times out or fails to connect. What should be checked?

  • Check that the network allows mcp.getastra.com and mcp-auth.getastra.com. A VPN, proxy or company firewall can block the connection. Try another network to confirm.

  • If the AI tool says the server already exists, remove the old Astra entry and add it again, as in Fix Astra MCP connection errors.

  • If the error mentions a temporary server problem, such as HTTP 503, wait and try again later. If it keeps failing, contact help@getastra.com with a screenshot of the error.

The email verification code did not arrive. What should be done?

The 8-digit code is sent to the email address registered on the Astra account. Check the spam or junk folder, and check that the sign-in used the right account email. If the code still does not arrive, start the sign-in again from the AI tool, or contact help@getastra.com.

For anything not covered here, contact help@getastra.com.