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 18 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 Credentials

Go to Settings → API Keys in the Erold web app and create a new key. Also note your Tenant ID from the URL or settings.

2. Configure Claude Code (Recommended Method)

Run this command in your terminal (replace with your actual credentials): 

claude mcp add-json erold '{"command":"npx","args":["-y","@erold/mcp-server@latest"],"env":{"EROLD_API_KEY":"YOUR_API_KEY","EROLD_TENANT":"YOUR_TENANT_ID"}}' --scope user

3. Verify the Connection

claude mcp list

You should see: erold: npx -y @erold/mcp-server@latest - ✓ Connected

4. Restart Claude Code

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

5. Test It

Ask Claude: "List my Erold projects"

Claude should show your projects using the MCP tools.

Important: Use actual values for the environment variables. Do NOT use ${EROLD_API_KEY} syntax - Claude Code doesn't expand shell variables.

Setup for Claude Desktop

Add to your Claude Desktop config file:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "erold": {
      "command": "npx",
      "args": ["-y", "@erold/mcp-server@latest"],
      "env": {
        "EROLD_API_KEY": "erold_your_api_key_here",
        "EROLD_TENANT": "your-tenant-id"
      }
    }
  }
}

Setup for Cursor

Add to your Cursor settings (.cursor/mcp.json): 

{
  "mcpServers": {
    "erold": {
      "command": "npx",
      "args": ["-y", "@erold/mcp-server@latest"],
      "env": {
        "EROLD_API_KEY": "erold_your_api_key_here",
        "EROLD_TENANT": "your-tenant-id"
      }
    }
  }
}

Setup for Windsurf

// ~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "erold": {
      "command": "npx",
      "args": ["-y", "@erold/mcp-server@latest"],
      "env": {
        "EROLD_API_KEY": "erold_your_api_key_here",
        "EROLD_TENANT": "your-tenant-id"
      }
    }
  }
}

Environment Variables

Variable Required Description
EROLD_API_KEY Yes Your Erold API key (starts with erold_)
EROLD_TENANT Yes Your tenant ID
EROLD_API_URL No Custom API URL (default: https://api.erold.dev/api/v1)

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