Skip to main content

​
Overview

You can connect Claude Code to Elitea through Model Context Protocol (MCP) and use:
  • Agents tagged with mcp
  • Pipelines tagged with mcp
  • Toolkit tools with Make Tools Available by MCP enabled
This is useful when you want Claude Code to call Elitea capabilities directly from your local development workflow.

​
Prerequisites

Before you start, verify that you have:
  • Claude Code installed
  • Python 3.10+ installed
  • pipx installed
  • elitea-mcp installed with pipx
  • Elitea deployment URL (example: https://next.elitea.ai)
  • Elitea personal access token from Create Personal Access Token
  • Elitea project ID from AI Configuration

​
Install pipx & elitea-mcp

Install pipx and elitea-mcp on your operating system using one of the following methods.

​
macOS

Use the following commands to install pipx and elitea-mcp on macOS:

​
Windows

Use the following steps to install pipx and elitea-mcp on Windows:
  1. Open PowerShell: Press Windows key, type “PowerShell”, and press Enter.
  2. Install pipx:
  3. Set up pipx path:
  4. Install elitea-mcp:
Restart your terminal so pipx and elitea-mcp are available in PATH.

​
Configure Claude Code

Open the Claude Code MCP configuration and add an Elitea server entry.
  1. In Claude Code Desktop, open Settings.
  2. Select Developer.
  3. In Local MCP Servers, select Edit Config to open the MCP configuration JSON file.
  4. Add the Elitea MCP server parameters to the JSON file. Claude Code local MCP servers screen.
After updating the MCP configuration, fully close and reopen Claude Code Desktop before the configured MCP servers appear in the UI.
Use the following example as a template:
Replace:
  • 13 with your Elitea project ID
  • https://next.elitea.ai with your Elitea URL
  • <your_elitea_token> with your personal access token
Claude Code configuration location may vary by installation method and OS. Open Claude Code settings for Local MCP Servers and edit the generated config file there.

​
Make Elitea Items Available in MCP

Claude Code will only see Elitea items that are exposed through MCP. Tag agents and pipelines with mcp, or enable the MCP option on toolkit tools. Agents Add the tag mcp to the agent and save it. Tag agent with mcp. Pipelines Add the tag mcp to the pipeline and save it. Tag pipeline with mcp. Toolkit tools When creating or editing a toolkit:
  1. Open the Tools section.
  2. Select the tools you want to expose.
  3. Enable Make Tools Available by MCP.
  4. Save the toolkit.
For more information, see Expose Elitea Tools via MCP. Toolkit MCP checkbox.

​
Use Elitea Tools in Claude Code

After the MCP server is running in Claude Code:
  1. Open Claude Code.
  2. Verify that the Elitea MCP server is shown as running.
  3. Start a prompt that requires an Elitea agent, pipeline, or toolkit tool.
  4. Claude Code will discover and use the available MCP tools.
If you add agents, pipelines, or toolkit tools, restart the Elitea MCP server in Claude Code.

​
Quick Troubleshooting

Check that:
  • The agent or pipeline has the mcp tag.
  • The toolkit has Make Tools Available by MCP enabled.
  • The correct project ID is used.
  • The personal token is valid.
  • The MCP server was restarted after changes.
Check that:
  • pipx was installed successfully.
  • Your terminal was restarted.
  • elitea-mcp is available in PATH.
Check that:
  • The config JSON is valid.
  • deployment_url, project_id, and auth_token are correct.
  • elitea-mcp is up to date. If Claude Code cannot connect to the Elitea MCP server, upgrade it with pipx upgrade elitea-mcp.
  • Local firewall or security tools are not blocking the process.

​
Guides & References