Connect Other IDEs

Overview

AlphaTales supports any IDE or AI coding tool that implements the MCP protocol. This guide covers setup instructions for GitHub Copilot, Antigravity, and Codex, plus a general configuration pattern for other tools.

GitHub Copilot (VS Code)

GitHub Copilot supports MCP servers through VS Code agent mode. To connect:

1. Open your project in VS Code.
2. Create or edit the file .vscode/mcp.json in your project root.
3. Add the following configuration:

{
  "servers": {
    "alphatales": {
      "type": "http",
      "url": "https://mcp.alphatales.io/mcp"
    }
  }
}

4. Save the file. VS Code picks up the new server automatically.

Tip: The .vscode/mcp.json file is project-scoped. Add it to each project where you want AlphaTales tools available, or place it in a shared settings location.

Antigravity

Antigravity is an agentic development platform that supports MCP servers through its configuration panel. Since Antigravity does not support native MCP OAuth authentication, it uses mcp-remote as a bridge to handle the login flow automatically.

Prerequisites: Node.js must be installed (for npx).

1. Open an Agent session.
2. Click the three-dot menu (...) at the top of the session.
3. Select MCP Servers, then Manage MCP Servers.
4. Click View raw config to open the configuration editor.
5. Add the following to mcp_config.json:

{
  "mcpServers": {
    "alphatales": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.alphatales.io/mcp"
      ]
    }
  }
}

6. Save the configuration. On first use, a browser window opens for you to log in to AlphaTales. After authentication, the connection is established automatically.

Note: mcp-remote handles OAuth authentication, token storage, and automatic token refresh. Credentials are stored locally in ~/.mcp-auth/.

Codex

Codex is a terminal-based coding agent that supports MCP servers natively with OAuth authentication.

Quick setup via CLI:

codex mcp add alphatales --url https://mcp.alphatales.io/mcp
codex mcp login alphatales

Or manually:

1. Open (or create) the file ~/.codex/config.toml in your home directory.
2. Add the following section:

[mcp_servers.alphatales]
url = "https://mcp.alphatales.io/mcp"
startup_timeout_sec = 300

3. Authenticate by running codex mcp login alphatales in your terminal. A browser window opens for you to log in.
4. Start Codex and use AlphaTales tools.

Note: The startup_timeout_sec = 300 setting extends the default 10-second timeout to give you enough time to complete the email verification during the OAuth login flow.

Any MCP-Compatible Tool

If your IDE or tool supports the MCP protocol but is not listed above, use the following server URL:

https://mcp.alphatales.io/mcp

Most tools require you to provide this URL in their MCP or plugin settings. The authentication flow is the same for all tools: you enter your AlphaTales email, receive a verification code, and authorize the connection.

Warning: Only add the AlphaTales MCP server to tools you trust. The server provides access to your project data based on your account permissions.

Authentication

All IDEs use the same authentication flow:

1. The IDE opens a browser window pointing to the AlphaTales login page.
2. Enter your email and the 6-digit code sent to your inbox.
3. After verification, you are redirected back to your IDE.

See Authentication for IDEs for more details.

Next Steps

Once connected, review the MCP Tools Reference to learn what you can do from your IDE.