English Français العربية

com.vaiz/mcp

Registre officiel Archivé Productivité

Connect AI assistants to your Vaiz workspace: tasks, projects, boards, documents and milestones.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package vaiz-mcp
Claude Code 
claude mcp add com-vaiz-mcp -e 'VAIZ_API_TOKEN=<your vaiz_api_token>' -e 'VAIZ_SPACE_ID=<VAIZ_SPACE_ID>' -e 'VAIZ_API_URL=<VAIZ_API_URL>' -- npx -y vaiz-mcp@1.1.2
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "com-vaiz-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "vaiz-mcp@1.1.2"
            ],
            "env": {
                "VAIZ_API_TOKEN": "<your vaiz_api_token>",
                "VAIZ_SPACE_ID": "<VAIZ_SPACE_ID>",
                "VAIZ_API_URL": "<VAIZ_API_URL>"
            }
        }
    }
}

Variables d'environnement

  • VAIZ_API_TOKEN obligatoire secret Your Vaiz API key (Bearer token)
  • VAIZ_SPACE_ID Your Vaiz Space ID
  • VAIZ_API_URL Vaiz MCP API URL (default: https://api.vaiz.com/mcp)

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. vaiz-mcp
  2. Installation
  3. Configuration
  4. Usage
  5. Debugging
  6. Programmatic Usage
  7. Development
  8. Platforms
  9. License

vaiz-mcp

DEPRECATED. This package is no longer maintained and this repository is archived.

Vaiz now provides a hosted MCP server at https://api.vaiz.com/mcp with OAuth. You no longer need a local npx proxy or a VAIZ_API_TOKEN.

Cursor users: install the official Vaiz plugin from the Cursor Marketplace — https://github.com/vaizcom/vaiz-cursor-plugin

Any MCP client: point it at the remote server directly.

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

Then authenticate when prompted (in Cursor: Settings → Tools & MCPs → Authenticate).

Guide: https://vaiz.com/help/tutorials/how-to-connect-vaiz-to-mcp · Support: https://vaiz.com/support

Existing installations of vaiz-mcp keep working for now, but will not receive updates or security fixes. Please migrate.

The original documentation is kept below for reference.

MCP (Model Context Protocol) client for Vaiz — connect Cursor/Claude to your Vaiz workspace.

Installation

npm install -g vaiz-mcp

Or use directly via npx:

npx vaiz-mcp

Configuration

Environment Variables
VariableRequiredDescription
VAIZ_API_TOKENYesYour Vaiz API key (Bearer token)
VAIZ_SPACE_IDNoYour Vaiz Space ID
VAIZ_API_URLNoMCP API URL (default: https://api.vaiz.com/mcp)
VAIZ_DEBUGNoSet to true for debug output to stderr
Cursor Configuration

Create or edit ~/.cursor/mcp.json:

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

Or after global installation (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 Configuration

Add to 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"
      }
    }
  }
}

Usage

After configuration, Cursor/Claude will automatically connect to your Vaiz workspace and gain access to:

  • 🔍 Search tasks, projects, users
  • 📋 Task management (create, edit, comments)
  • 📊 View boards and projects
  • 👥 Team member information
  • 📝 Work with documents and milestones

Debugging

To enable debug output, add the VAIZ_DEBUG variable:

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

Debug messages will be output to stderr.

Programmatic Usage

You can also use the library programmatically:

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

Development

# 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

Platforms

License

MIT

Questions fréquentes

Qu'est-ce que com.vaiz/mcp ?

Connect AI assistants to your Vaiz workspace: tasks, projects, boards, documents and milestones.

Comment installer com.vaiz/mcp ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add com-vaiz-mcp -e 'VAIZ_API_TOKEN=<your vaiz_api_token>' -e 'VAIZ_SPACE_ID=<VAIZ_SPACE_ID>' -e 'VAIZ_API_URL=<VAIZ_API_URL>' -- npx -y vaiz-mcp@1.1.2. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour com.vaiz/mcp ?

Oui. Il attend VAIZ_API_TOKEN, à renseigner dans sa configuration.

com.vaiz/mcp est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient com.vaiz/mcp ?

Il est publié par vaizcom. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.