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

Setting Up the Kyvos Cowork Plugin Connected to Kyvos Trial Environment

This section explains how to install and configure the Kyvos Cowork Plugin connected to the Kyvos Trial Environment in Claude Cowork. It provides comprehensive end-to-end setup details using the Kyvos sample semantic model.

Note

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 in Claude Cowork connected to the Kyvos trial environment, 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 Add customer connector dialog box is displayed with the configured MCP Server URL.

    image-20260220-190930.png

     

  7. 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

     

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

    image-20260220-191322.png

     

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

    image-20260210-112849.png

     

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

    image-20260223-143847.png

     

Note

The steps below (from steps 12 to 14) 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.

    • analyze

    • build-dashboard

    • create-viz

    • discover

    • get-data

    • validate

  2. Enter your business query along with the appropriate command. You may use the following sample business queries to experience the workflow:

    • /analyze Analyze why the Central region is underperforming compared to other regions.

    • /build-dashboard: Create a product performance dashboard that displays sales velocity and profitability.

    • /create-viz Show monthly sales trends for 2023 by subcategory.

    • /get-data Identify subcategories that are incurring losses despite high sales.

    • /discover Identify subcategories that are incurring losses despite high sales.

    • /anomaly-detector Detect anomalies in the 2023 sales data for the Retail Superstore.

    • /validate Validate the sales data for subcategories.

  3. Next, click Let’s go.

    image-20260220-191745.png

     

  4. Review the generated response to your query.

    image-20260220-191833.png

     

Note

  • Once you have explored the Kyvos plugin in the trial environment and intend to deploy it in your own environment, ensure that the Kyvos application is configured.

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

Copyright Kyvos, Inc. 2025. All rights reserved.