Connect Claude Code

Overview

Claude Code is a terminal-based AI coding assistant. Connecting it to AlphaTales takes a single command and gives you access to your projects and tasks without leaving the command line.

Add the MCP Server

Open your terminal and run:

claude mcp add alphatales https://mcp.alphatales.io/mcp

This registers the AlphaTales MCP server with Claude Code under the name alphatales.

Tip: You only need to run this command once. The server is remembered across sessions.

Authentication

The first time Claude Code connects to AlphaTales, a browser window opens for authentication:

1. Enter the email address linked to your AlphaTales account.
2. A 6-digit verification code is sent to your inbox.
3. Enter the code in the browser.
4. The browser confirms success and redirects you back to your terminal.

Your session stays active until the authentication token expires. When it does, the login flow runs again automatically.

Using AlphaTales Tools

Once connected, you can ask Claude Code to interact with AlphaTales on your behalf. For example:

• "What features are assigned to me?" -- calls tasks_my
• "List all features in my project." -- calls tasks_list
• "Start working on the login page feature." -- calls tasks_start
• "What should I work on next?" -- calls tasks_next
• "Get details for feature #3." -- calls tasks_getDetails
• "Set my active project." -- calls projects_set
• "Show project architecture." -- calls projects_init

Claude Code automatically selects the right tool based on your request.

Verify the Connection

To confirm the setup is working:

1. Start a new Claude Code session.
2. Ask: "List my AlphaTales projects."
3. Claude Code should display your projects by calling the projects_list tool.

If the tool call succeeds and returns your project data, the connection is active.

Warning: If you see an authentication error, make sure you are using the same email address you use to log in to AlphaTales on the web.

Remove the Server

If you ever need to remove the integration, run:

claude mcp remove alphatales

Next Steps

Explore the full set of available tools in the MCP Tools Reference.