Vaiz

vaiz-mcp

OBSOLETO. Este pacote não é mais mantido e este repositório está arquivado.

O Vaiz agora oferece um servidor MCP hospedado em https://api.vaiz.com/mcp com OAuth. Você não precisa mais de um proxy local npx ou de um VAIZ_API_TOKEN.

Usuários do Cursor: instale o plugin oficial Vaiz da Cursor Marketplace — https://github.com/vaizcom/vaiz-cursor-plugin

Qualquer cliente MCP: aponte diretamente para o servidor remoto.

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

Em seguida, autentique quando solicitado (no Cursor: Configurações → Ferramentas e MCPs → Autenticar).

Guia: https://vaiz.com/help/tutorials/how-to-connect-vaiz-to-mcp · Suporte: https://vaiz.com/support

Instalações existentes do vaiz-mcp continuam funcionando por enquanto, mas não receberão atualizações ou correções de segurança. Por favor, migre.

---

A documentação original é mantida abaixo para referência.

Cliente MCP (Model Context Protocol) para Vaiz — conecte Cursor/Claude ao seu workspace Vaiz.

Instalação

npm install -g vaiz-mcp

Ou use diretamente via npx:

npx vaiz-mcp

Configuração

Variáveis de Ambiente

Variável	Obrigatória	Descrição
VAIZ_API_TOKEN	Sim	Sua chave de API do Vaiz (token Bearer)
VAIZ_SPACE_ID	Não	Seu ID de Space do Vaiz
VAIZ_API_URL	Não	URL da API MCP (padrão: https://api.vaiz.com/mcp)
VAIZ_DEBUG	Não	Defina como true para saída de depuração em stderr

Configuração do Cursor

Crie ou edite ~/.cursor/mcp.json:

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

Ou após instalação 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"
      }
    }
  }
}

Configuração do Claude Desktop

Adicione 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

Após a configuração, o Cursor/Claude se conectará automaticamente ao seu workspace Vaiz e terá acesso a:

• 🔍 Pesquisar tarefas, projetos, usuários
• 📋 Gerenciamento de tarefas (criar, editar, comentários)
• 📊 Visualizar quadros e projetos
• 👥 Informações de membros da equipe
• 📝 Trabalhar com documentos e marcos

Depuração

Para habilitar a saída de depuração, adicione a variável VAIZ_DEBUG:

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

As mensagens de depuração serão enviadas para stderr.

Uso Programático

Você também pode usar a biblioteca programaticamente:

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' 
});

Desenvolvimento

# 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

Licença

MIT