Skip to main content

MCP Server Setup

The Model Context Protocol (MCP) server allows AI assistants like Claude Code, Cursor, and Windsurf to interact directly with Erold.

What is MCP?

MCP is a standard protocol that enables AI assistants to use external tools. Our MCP server provides 27+ tools that let AI:

  • Create and update tasks
  • Search and read project information
  • Access and update the knowledge base
  • Log time and add comments

Prerequisites

  • A Erold account with an API key
  • Node.js 18+ installed
  • An MCP-compatible AI tool (Claude Code, Cursor, etc.)

Setup for Claude Code

1. Get Your API Key

Go to Settings → API Keys in the Erold web app and create a new key with Write permissions.

2. Configure Claude Code

Edit your Claude Code configuration file: 

// macOS: ~/.config/claude/claude_desktop_config.json
// Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "yet": {
      "command": "npx",
      "args": ["-y", "@erold/mcp-server"],
      "env": {
        "EROLD_API_KEY": "erold_your_api_key_here"
      }
    }
  }
}

3. Restart Claude Code

Completely quit and restart Claude Code to load the MCP server.

4. Verify

Ask Claude: "List my Erold projects"

Claude should show your projects using the MCP tools.

Setup for Cursor

Add to your Cursor settings: 

// .cursor/settings.json
{
  "mcp": {
    "servers": {
      "yet": {
        "command": "npx",
        "args": ["-y", "@erold/mcp-server"],
        "env": {
          "EROLD_API_KEY": "erold_your_api_key_here"
        }
      }
    }
  }
}

Setup for Windsurf

// ~/.windsurf/config.json
{
  "mcpServers": {
    "yet": {
      "command": "npx",
      "args": ["-y", "@erold/mcp-server"],
      "env": {
        "EROLD_API_KEY": "erold_your_api_key_here"
      }
    }
  }
}

Environment Variables

Variable Required Description
EROLD_API_KEY Yes Your Erold API key
EROLD_API_URL No Custom API URL (default: https://api.erold.dev)
EROLD_DEFAULT_PROJECT No Default project key for commands

Troubleshooting

"MCP server not found"

  • Ensure Node.js 18+ is installed: node --version
  • Try running manually: npx -y @erold/mcp-server

"Unauthorized" errors

  • Check your API key is correct
  • Ensure the key has Write permissions
  • Verify the key hasn't been revoked

"No projects found"

  • Create a project in the web app first
  • Check if your API key is scoped to specific projects

Next Steps