Connect Claude Code (Anthropic’s terminal-based coding agent) to Prometheux using the MCP server. This guide covers both the local and remote setup options.
Recommended: Use the Local ServerWe recommend using the local MCP server (stdio) with Claude Code for the most reliable experience. It avoids the OAuth browser flow and passes credentials directly.

​
Prerequisites

  • Claude Code installed (npm install -g @anthropic-ai/claude-code)
  • Prometheux credentials (username, organization, API token)

​
1. Install the MCP Package

If you haven’t already, install prometheux-mcp: macOS: 
brew install pipx
pipx ensurepath
pipx install prometheux-mcp
Windows/Linux: 
pip install pipx
pipx ensurepath
pipx install prometheux-mcp

​
2. Add the Server to Claude Code

claude mcp add --scope user \
  -e PROMETHEUX_TOKEN='your_token_here' \
  -e PROMETHEUX_USERNAME='your_username' \
  -e PROMETHEUX_ORGANIZATION='your_organization' \
  -- prometheux /Users/YOUR_USERNAME/.local/bin/prometheux-mcp --url https://api.prometheux.ai
Finding Your PathRun which prometheux-mcp (macOS/Linux) or where prometheux-mcp (Windows) to find the correct path.

​
3. Verify the Connection

Restart Claude Code and check the server status: 
claude mcp list
You should see prometheux listed as connected. You can also type /mcp inside a Claude Code session to see all server statuses.

​
Alternative: Remote Server

You can also use the remote server with OAuth authentication: 
claude mcp add --transport http --scope user prometheux https://api.prometheux.ai/px-remote-mcp-server
This will trigger an OAuth browser flow when Claude Code connects. See the Remote MCP Server page for details.

​
Claude Code in Claude Desktop

If you use Claude Code within the Claude Desktop app (not the terminal), it shares the Desktop app’s MCP connectors. You can either: Both methods make the Prometheux tools available to Claude Code running inside the Desktop app.

​
Usage

Once connected, interact naturally with Claude Code. It will automatically use the Prometheux MCP tools when relevant.
Example Conversations & Available ToolsSee the MCP overview page for example conversations and a complete list of available tools.

​
Managing the Server

# List all configured servers
claude mcp list

# Remove the server
claude mcp remove prometheux

​
Troubleshooting

​
Server shows as “failed” in /mcp

Solution:
  • Verify the path to prometheux-mcp is correct — run which prometheux-mcp in your terminal
  • Check that your credentials are valid and the token hasn’t expired
  • Remove and re-add the server: claude mcp remove prometheux then add it again
  • Run claude --debug to see detailed error logs

​
Tools not being used

Solution:
  • Type /mcp in Claude Code to verify the server is connected
  • Be more explicit in your query: “Use the prometheux tools to list concepts in project X”
  • Restart Claude Code for changes to take effect

​
”command not found” error

Solution:
  • Use the full path to prometheux-mcp instead of just the command name
  • Ensure pipx ensurepath was run and your shell profile was reloaded
For general troubleshooting, see the Local MCP Server troubleshooting section.