Servidor MCP de Waldur

El servidor MCP de Waldur permite la integración entre la instancia de Waldur y Claude Desktop mediante la implementación del Protocolo de Contexto de Modelo (MCP). Esto permite que Claude interactúe directamente con su instancia de Waldur.

Inicio rápido

Instale Claude Desktop para su plataforma desde la página de versiones de Claude Desktop
Instale Python 3.13 o superior.
Instalar el administrador de paquetes uv.

Instalación

Para instalar el paquete:

pip install waldur-mcp-server

O con uv:

uv pip install waldur-mcp-server

Generar tokens Waldur

Inicie sesión en su instancia de Waldur
Vaya a Nombre de usuario > Credenciales > Token API
Genere un nuevo token con una duración de token adecuada: lo necesitará para la configuración

Configuración del servidor MCP de Claude Desktop

En Windows: %APPDATA%\Claude\claude_desktop_config.json

En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "waldur-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "C:\\waldur_service",
        "run",
        "waldur-mcp-server"
      ],
      "env": {
        "WALDUR_API_URL": "https://your-waldur-instance",
        "WALDUR_TOKEN": "your-token"
      }
    }
  }
}

{
  "mcpServers": {
    "waldur-mcp-server": {
      "command": "uvx",
      "args": [
        "waldur-mcp-server"
      ],
      "env": {
        "WALDUR_API_URL": "https://your-waldur-instance",
        "WALDUR_TOKEN": "your-token"
      }
    }
  }
}

Depuración

En macOS, los archivos de registro se encuentran en ~/Library/Logs/Claude/mcp.log

Si encuentra un error spawn uvx ENOENT , verifique que la variable de entorno PATH incluya el directorio de instalación de Python donde está instalado uv . Como alternativa, puede especificar la ruta completa a uvx en el archivo de configuración, por ejemplo: ~/Library/Frameworks/Python.framework/Versions/3.13/bin/uvx

Dado que los servidores MCP se ejecutan en stdio, la depuración puede ser complicada. Para una experiencia óptima, recomendamos usar el Inspector MCP .

Puede iniciar el Inspector MCP a través de npm con este comando:

npx @modelcontextprotocol/inspector uv --directory C:\\waldur_service run waldur-mcp-server

Al depurar, deberá configurar las variables de entorno necesarias. Al iniciarse, el Inspector mostrará una URL a la que podrá acceder desde su navegador para comenzar la depuración.

Problemas comunes

Token no válido: verificar los permisos y la expiración del token
Problemas de conexión: Compruebe que WALDUR_API_URL sea accesible

Waldur MCP Server