How to connect to Vaiz MCP in Claude and Cursor

MCP allows AI tools like Claude and Cursor to securely access your Vaiz workspace — tasks, projects, documents, and more — directly inside the editor or chat. You can find all available Vaiz integrations on the integrations page.

Prerequisites: install Node.js

Before proceeding with the setup, you must have Node.js installed on your computer. Both Claude and Cursor rely on the npx command to fetch and run the Vaiz MCP server.

If you haven't installed it yet, you can download it from the official Node.js website. Once installed, you can verify it by opening your terminal and typing npm -v or npx -v.

Connect Vaiz to Claude Desktop

Step 1: Open settings in Claude

Open Claude Desktop and click Settings in the left sidebar.

Step 2: Open the Developer Section and edit the MCP Config

In the Settings menu, scroll down and select Developer. In the Local MCP servers section, click “Edit config”.

This will open the claude_desktop_config.json file, where MCP servers are configured. In the opened file, add or update the Vaiz MCP configuration as shown below.

To make this easier, you can copy the configuration below and paste it directly into your mcp.json file.

{
  "mcpServers": {
    "Vaiz": {
      "command": "npx",
      "args": ["vaiz-mcp@latest"],
      "env": {
        "VAIZ_API_TOKEN": "your_personal_access_token",
        "VAIZ_SPACE_ID": "your_space_id (optional)"
      }
    }
  },
  "preferences": {
    "menuBarEnabled": false,
    "quickEntryShortcut": "off"
  }
}

Step 3: Start a new chat to trigger MCP authorization

Start a new chat in Claude. Type a request that requires Vaiz data, for example: “How many tasks do I have?”.

Step 4: Allow Claude to perform actions

Claude will prompt you with a permission window asking to use Vaiz tools. Select “Allow once” or “Always allow”.

Step 5: Claude connects and returns your Vaiz Data

Once authorized, Claude will fetch the requested information from your Vaiz workspace.

Note: Claude is now connected to Vaiz via MCP.

Connect Vaiz to Cursor

Step 1: Open MCP settings in Cursor

In Cursor, open Settings, then Tools & MCP. Scroll to Installed MCP Servers and click “Add Custom MCP”.

Step 2: Create or Edit your MCP configuration File

Cursor stores MCP server configurations in the file: ~/.cursor/mcp.json.

Add the Vaiz MCP configuration:

Use the example below to quickly add the Vaiz MCP configuration — just copy and paste it.

{
  "mcpServers": {
    "Vaiz": {
      "command": "npx",
      "args": [
        "vaiz-mcp@latest"
      ],
      "env": {
        "VAIZ_API_TOKEN": "your_personal_access_token",
        "VAIZ_SPACE_ID": "your_space_id (optional)"
      }
    }
  }
}

Step 3: Enable the Vaiz MCP Server

After saving the config file, return to Tools & MCP. You’ll now see Vaiz listed as an installed server — toggle it on.

Step 4: Start a new chat and use Vaiz Tools

Open a new chat and send a request that relies on your Vaiz data. For example: “Let’s see how to solve task DEMO-32”.

Cursor will call the Vaiz MCP tools and display structured task information.

Step 5: Continue your workflow using Vaiz Data

Cursor can now generate follow-up tasks, code, plans, and deliverables using your workspace context.

Note: Your Vaiz MCP integration is ready.

Conclusion

Once MCP is connected, Vaiz becomes directly accessible from tools like Claude and Cursor. You can ask questions about your tasks, get summaries, and work with real project data without leaving your AI workspace. After you set up your Personal Access Token and complete the MCP configuration, the connection works securely in the background and is ready whenever you need it.