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 の場合：設定 → ツールと MCP → 認証）。

ガイド：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 キー（ベアラートークン）
VAIZ_SPACE_ID	いいえ	Vaiz Space ID
VAIZ_API_URL	いいえ	MCP API URL（デフォルト：https://api.vaiz.com/mcp）
VAIZ_DEBUG	いいえ	デバッグ出力を stderr に出力するには true に設定します

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