🩺 Troubleshooting

Common issues and fixes when running the Jenkins MCP server.

👻 Server Not Showing in Claude

✅ Check path is absolute
✅ Run npm install && npm run build
✅ Verify environment variables
✅ Restart Claude completely

🔐 Authentication Errors

# Test your credentials
curl -u username:token https://your-jenkins.com/api/json

If this returns JSON, your credentials are valid!

🔨 Build Errors

# Clean rebuild
npm run clean && npm run build

📋 Check Logs

Claude Desktop logs:

macOS: ~/Library/Logs/Claude/mcp*.log
Windows: %APPDATA%\Claude\logs\mcp*.log

Claude Code CLI logs:

claude mcp get jenkins

🔍 Testing with MCP Inspector

export MCP_JENKINS_URL=https://pipeline.yourcompany.com
export MCP_JENKINS_USER=your_username
export MCP_JENKINS_API_TOKEN=your_token

npm run inspect:dev

Opens http://localhost:5173 - test all tools interactively!

🔐 Authentication

Getting a Jenkins API token and choosing between bearer token and basic auth.

On this page

👻 Server Not Showing in Claude 🔐 Authentication Errors 🔨 Build Errors 📋 Check Logs 🔍 Testing with MCP Inspector