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

1. Instale Claude Desktop para su plataforma desde la página de versiones de Claude Desktop

2. Instale Python 3.13 o superior.

3. 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

1. Inicie sesión en su instancia de Waldur

2. Vaya a Nombre de usuario > Credenciales > Token API

3. 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