vaiz

vaiz-mcp

已弃用。 此软件包不再维护，且此代码库已归档。

Vaiz 现在提供带 OAuth 的托管 MCP 服务，地址为 https://api.vaiz.com/mcp。您不再需要本地 npx 代理或 VAIZ_API_TOKEN。

Cursor 用户： 从 Cursor Marketplace 安装官方 Vaiz 插件 — https://github.com/vaizcom/vaiz-cursor-plugin

任何 MCP 客户端： 直接连接到远程服务。

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

然后按提示进行身份验证（在 Cursor 中：Settings → Tools & MCPs → Authenticate）。

指南：https://vaiz.com/help/tutorials/how-to-connect-vaiz-to-mcp · 支持：https://vaiz.com/support

现有的 vaiz-mcp 安装目前仍可继续使用，但不会收到更新或安全修复。请迁移。

---

以下保留原始文档以供参考。

Vaiz 的 MCP（Model Context Protocol）客户端 — 将 Cursor/Claude 连接到您的 Vaiz 工作区。

安装

npm install -g vaiz-mcp

或者通过 npx 直接使用：

npx vaiz-mcp

配置

环境变量

变量	必需	说明
VAIZ_API_TOKEN	是	您的 Vaiz API 密钥（Bearer 令牌）
VAIZ_SPACE_ID	否	您的 Vaiz Space ID
VAIZ_API_URL	否	MCP API URL（默认：https://api.vaiz.com/mcp）
VAIZ_DEBUG	否	设置为 true，将调试输出写入 stderr

Cursor 配置

创建或编辑 ~/.cursor/mcp.json：

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

或者在全局安装后（npm install -g vaiz-mcp）：

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

Claude Desktop 配置

添加到 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"
      }
    }
  }
}

使用方法

完成配置后，Cursor/Claude 将自动连接到您的 Vaiz 工作区，并获得以下访问权限：

• 🔍 搜索任务、项目和用户
• 📋 任务管理（创建、编辑、评论）
• 📊 查看看板和项目
• 👥 团队成员信息
• 📝 处理文档和里程碑

调试

若要启用调试输出，请添加 VAIZ_DEBUG 变量：

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

调试消息将输出到 stderr。

编程方式使用

您也可以通过编程方式使用此库：

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

开发

# 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

平台

许可证

MIT