Overview
What is Waldur MCP server?
Waldur MCP server enables integration between a Waldur instance and Claude Desktop by implementing the Model Context Protocol (MCP). It allows Claude to interact with your Waldur instance directly.
How to use Waldur MCP server?
Install Claude Desktop, Python 3.13+, and uv. Then install the package via pip install waldur-mcp-server or uv pip install waldur-mcp-server. Generate an API token from your Waldur instance (Username > Credentials > API Token). Configure Claude Desktop by editing claude_desktop_config.json with environment variables WALDUR_API_URL and WALDUR_TOKEN.
Key features of Waldur MCP server
- Integrates Waldur instance with Claude Desktop
- Implements the Model Context Protocol (MCP)
- Allows direct Claude interaction with Waldur
- Configuration via environment variables
- Supports published and development server modes
- Debuggable via MCP Inspector
Use cases of Waldur MCP server
—
FAQ from Waldur MCP server
How to install Waldur MCP server?
Install via pip (pip install waldur-mcp-server) or uv (uv pip install waldur-mcp-server).
How to generate a Waldur API token?
Log in to your Waldur instance, navigate to Username > Credentials > API Token, and generate a new token with an appropriate lifetime.
How to configure Claude Desktop for the server?
Edit claude_desktop_config.json (Windows: %APPDATA%\Claude\, MacOS: ~/Library/Application Support/Claude/) and add an entry under mcpServers with commands uvx waldur-mcp-server and environment variables WALDUR_API_URL and WALDUR_TOKEN.
How to debug the server?
Check log files at ~/Library/Logs/Claude/mcp.log on macOS. For advanced debugging, use the MCP Inspector with npx @modelcontextprotocol/inspector uv --directory <path> run waldur-mcp-server.
What are common issues?
Invalid token (check permissions and expiration) and connection issues
