Connect Cursor

Overview

Cursor is an AI-powered code editor with built-in MCP support. AlphaTales offers a one-click deeplink that configures everything automatically, or you can set it up manually in a few steps.

One-Click Install (Recommended)

The fastest way to connect Cursor is through the Developer Package page in your AlphaTales project:

1. Open any project in AlphaTales.
2. Navigate to the Developer Package page from the project sidebar.
3. Find the Cursor card under MCP Integration.
4. Click Connect, then click the Add to Cursor button.
5. Cursor opens automatically with the MCP server pre-configured.

Tip: The deeplink configures the server URL and name for you. All you need to do is authenticate when prompted.

Manual Setup

If you prefer to configure Cursor manually:

1. Open Cursor Settings (use the gear icon or keyboard shortcut).
2. Navigate to the MCP section.
3. Click Add new MCP Server.
4. Select the URL type.
5. Enter the following server URL:

https://mcp.alphatales.io/mcp

6. Name the server alphatales (or any name you prefer).
7. Save the configuration.

Authentication

When Cursor connects to the AlphaTales MCP server for the first time, you are redirected to a login page:

1. Enter the email address associated with your AlphaTales account.
2. Check your inbox for a 6-digit verification code.
3. Enter the code to complete authentication.
4. You are redirected back to Cursor automatically.

Your session remains active until the token expires. When it does, you will be prompted to re-authenticate.

Verify the Connection

To confirm everything is working:

1. Open the Cursor chat or composer panel.
2. Ask your AI assistant something like: "List my AlphaTales projects."
3. The assistant should call the projects_list tool and return your project list.

If you see your projects, the connection is working correctly.

Warning: If Cursor reports that the MCP server is unreachable, check that you are connected to the internet and that the server URL is entered exactly as shown above.

Next Steps

Now that Cursor is connected, explore the MCP Tools Reference to see all the tools available to you.