/
Setting Up the Kyvos Cowork Plugin Connected to Your Kyvos Environment

Setting Up the Kyvos Cowork Plugin Connected to Your Kyvos Environment

This section provides step-by-step instructions for installing and configuring the Kyvos Cowork Plugin in Claude Cowork. It outlines the Kyvos Cowork plugin upload process, MCP Server configuration, and connection steps required to enable and use the plugin to execute business queries. Upon completion, users can leverage enterprise semantic models to execute governed business analytics workflows.

Note

  • To use the Kyvos Cowork Plugin connected to your Kyvos environment, Kyvos version 2025.12 or later is required.

  • The Kyvos MCP Server must be configured before installing the Kyvos plugin. For more information on configuring the Kyvos MCP Server, click here.

  • Before starting installation, ensure Claude Desktop is installed on your system. You can install Cowork using the Claude Desktop application from here.

Follow the procedures carefully to ensure a smooth installation and setup experience.

Installing the Kyvos Cowork plugin in Claude Cowork

To set up the Kyvos Cowork plugin connected to your Kyvos environment in Claude Cowork, perform the following steps.

  1. Launch the Claude Desktop application.

    image-20260220-180509.png

     

  2. In the Cowork space, click the Plus (+) icon and select Add plugins. The Browse plugins dialog is displayed.

    image-20260220-182953.png

     

  3. On the Browse plugins dialog box, click the Plus (+) icon and choose one of the following installation options:

    • Add marketplace from GitHub: Use this option to install the Kyvos Cowork plugin directly from GitHub Marketplace.

    • Upload plugin: Use this option to upload the Kyvos Cowork plugin (.zip file).

  4. Next, install the Kyvos Cowork plugin by doing one of the following:

    • If installing from the GitHub Marketplace:

      1. On the Browse plugins dialog box, click the Add marketplace from GitHub. The Add marketplace from GitHub dialog box is displayed.

        image-20260220-184154.png

         

      2. On the Add marketplace from GitHub dialog box, enter ki-kyvos/kyvos-plugins in the URL field and click Sync. The kyvos-plugins tab is added.

        image-20260220-183942.png

         

      3. Once the kyvos-plugins tab appears, click Install.

        image-20260220-185000.png

         

      4. After installation completes, click Manage to view the Kyvos plugin details, as described in step-5.

        image-20260220-185213.png

         

    • If installing using a local zip file - Kyvos Cowork plugin

      1. On the Personal tab, click the Plus (+) icon and select Upload plugin. The Upload local plugin dialog is displayed.

        image-20260220-185533.png

         

      2. Navigate to the folder where the kyvos-cowork-plugin.zip file is saved and click Upload. After uploading the Kyvos Cowork plugin, its details appear on the Kyvos page as mentioned below (step-5).

        image-20260220-181015.png

         

  5. View the Kyvos plugins details on the Kyvos page.



    image-20260220-190531.png

  6. Next, to complete the Kyvos plugin setup, install the Kyvos MCP Server. On the Plugins page, select Connectors > Install.

    image-20260210-110147.png


    The Kyvos MCP Server must be configured before installing the Kyvos plugin. For more information on configuring the Kyvos MCP Server, click here.

  7. Select VS Code. The mcp.json configuration file is displayed.

    image-20260210-110522.png

     

  8. Enter the Kyvos MCP Server details in the mcp.json file based on the selected authentication type (OAuth or basic authentication).

    • OAuth Authentication Key (Recommended by Kyvos): Provide the Kyvos MCP Server URL as shown below.

      image-20260210-110756.png

       

    • Basic Authentication (Username and Password):

      1. Enter the commands as npx.

      2. Provide the Kyvos MCP Server URL.

      3. Authorization header (Base64 encoded <username>:<password>). Replace the placeholders with the appropriate Kyvos MCP Server URL and the Base64-encoded username:password value.

        image-20260211-152605.png

Note

  • For basic authentication (username and password), install Node.js (version 22.x LTS or later recommended), and then install MCP-remote using the npm install -g mcp-remote command.

  • Ensure that both Node.js and MCP-remote are installed on the same machine on which Claude Desktop is installed.

  1. After configuring the MCP Server details, exit the Claude application and restart it to ensure that the Kyvos Cowork Plugin changes take effect.

  2. Restart Claude. You are redirected to the Plugins page.

  3. On the Plugins page, click Connectors > Install.
    The Add customer connector dialog box is displayed with the configured MCP Server URL.

    image-20260220-190930.png

     

  4. In the Add customer connector dialog box, verify the MCP Server URL. Click Add, and then click Connect to establish the connection to the Kyvos MCP Server.

    image-20260223-142356.png

     

  5. Once the Kyvos MCP Server connection is established and displays as enabled, review the listed tool permission details.

     

    image-20260211-170745.png

     

  6. Click the Back arrow next to Plugins to go to the Home page. The Kyvos Cowork plugin is now installed and ready for use.

    image-20260210-112849.png

     

  7. On the Home page, click Plus (+) > Plugins > Kyvos to display a list of available commands.

    image-20260223-143612.png

 

Note
The steps below (from steps 18 to 20) are based on a sample dataset. However, you can explore and ask questions based on the data in your Kyvos semantic models.

  1. Select one of the following commands to execute your query. For more information about commands, click here.

    1. analyze

    2. build-dashboard

    3. create-viz.

    4. discover

    5. get-data

    6. validate

  2. Enter your business query followed by the selected command and click Let’s go.

    image-20260220-191745.png

     

  3. Review the generated response to your query.

    image-20260210-113343.png

Copyright Kyvos, Inc. 2025. All rights reserved.