Vaiz

vaiz-mcp

OBSOLETO. Este paquete ya no recibe mantenimiento y este repositorio está archivado.

Vaiz ahora ofrece un servidor MCP alojado en https://api.vaiz.com/mcp con OAuth. Ya no necesitas un proxy local de npx ni un VAIZ_API_TOKEN.

Usuarios de Cursor: instala el plugin oficial de Vaiz desde el Marketplace de Cursor — https://github.com/vaizcom/vaiz-cursor-plugin

Cualquier cliente MCP: apunta directamente al servidor remoto.

{
  "mcpServers": {
    "Vaiz": { "url": "https://api.vaiz.com/mcp" }
  }
}

Luego autentícate cuando se te solicite (en Cursor: Configuración → Herramientas y MCP → Autenticar).

Guía: https://vaiz.com/help/tutorials/how-to-connect-vaiz-to-mcp · Soporte: https://vaiz.com/support

Las instalaciones existentes de vaiz-mcp seguirán funcionando por ahora, pero no recibirán actualizaciones ni correcciones de seguridad. Por favor, migra.

---

La documentación original se conserva a continuación como referencia.

Cliente MCP (Protocolo de Contexto de Modelo) para Vaiz — conecta Cursor/Claude a tu espacio de trabajo de Vaiz.

Instalación

npm install -g vaiz-mcp

O úsalo directamente con npx:

npx vaiz-mcp

Configuración

Variables de Entorno

Variable	Requerida	Descripción
VAIZ_API_TOKEN	Sí	Tu clave de API de Vaiz (token Bearer)
VAIZ_SPACE_ID	No	Tu ID de Espacio de Vaiz
VAIZ_API_URL	No	URL de la API de MCP (predeterminada: https://api.vaiz.com/mcp)
VAIZ_DEBUG	No	Establécelo en true para salida de depuración en stderr

Configuración de Cursor

Crea o edita ~/.cursor/mcp.json:

{
  "mcpServers": {
    "vaiz": {
      "command": "npx",
      "args": ["vaiz-mcp@latest"],
      "env": {
        "VAIZ_API_TOKEN": "your-api-key",
        "VAIZ_SPACE_ID": "your-space-id"
      }
    }
  }
}

O después de la instalación global (npm install -g vaiz-mcp):

{
  "mcpServers": {
    "vaiz": {
      "command": "vaiz-mcp@latest",
      "env": {
        "VAIZ_API_TOKEN": "your-api-key",
        "VAIZ_SPACE_ID": "your-space-id"
      }
    }
  }
}

Configuración de Claude Desktop

Agrega a claude_desktop_config.json:

{
  "mcpServers": {
    "vaiz": {
      "command": "npx",
      "args": ["vaiz-mcp@latest"],
      "env": {
        "VAIZ_API_TOKEN": "your-api-key",
        "VAIZ_SPACE_ID": "your-space-id"
      }
    }
  }
}

Uso

Después de la configuración, Cursor/Claude se conectará automáticamente a tu espacio de trabajo de Vaiz y tendrá acceso a:

• 🔍 Buscar tareas, proyectos, usuarios
• 📋 Gestión de tareas (crear, editar, comentarios)
• 📊 Ver tableros y proyectos
• 👥 Información de miembros del equipo
• 📝 Trabajar con documentos e hitos

Depuración

Para habilitar la salida de depuración, agrega la variable VAIZ_DEBUG:

{
  "mcpServers": {
    "vaiz": {
      "command": "npx",
      "args": ["vaiz-mcp@latest"],
      "env": {
        "VAIZ_API_TOKEN": "your-api-key",
        "VAIZ_DEBUG": "true"
      }
    }
  }
}

Los mensajes de depuración se enviarán a stderr.

Uso Programático

También puedes usar la biblioteca de forma programática:

import { createVaizMCPClient } from 'vaiz-mcp';

const client = createVaizMCPClient({
  apiKey: 'your-api-key',
  spaceId: 'your-space-id',
});

// Initialize connection
const initResult = await client.initialize();

// Get list of tools
const tools = await client.listTools();

// Call a tool
const result = await client.callTool('search', { 
  query: 'important task',
  entityType: 'task' 
});

Desarrollo

# Clone the repository
git clone https://github.com/vaiz/vaiz-mcp.git
cd vaiz-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Run in development mode
npm run dev

Plataformas

Licencia

MIT