Skip to main content

Zilliz Plugin Setup

This guide provides multiple methods for integrating Zilliz Plugins into your LLM Agent-powered workflows.

Prerequisites​

1

Run Claude Code

> claude
2

Add the Zilliz Plugin marketplace.

/plugin marketplace add zilliztech/zilliz-plugin
3

Install the plugin

/plugin install zilliz@zilliztech/zilliz-plugin

Initial Setup​

After installation, run the quickstart wizard:

/zilliz:setup

The wizard will guide you through:

1

Install Zilliz CLI.

The plugin requires the Zilliz CLI. If not installed, run:

pip install zilliz-cli

Verify installation:

zilliz --version
2

Authenticate.

Authenticate with your Zilliz Cloud account:

zilliz auth login

This opens a browser for authentication. After login, your credentials are stored locally.

3

Connect to your cluster.

Configure your default cluster connection:

zilliz context set --cluster-id <your-cluster-id>

Or let the plugin help you select from available clusters.

Verification​

Test the plugin with a simple command:

You: "List my clusters"

The plugin should display your Zilliz Cloud clusters.

Troubleshooting​

  • Plugin shows "CLI not found"

    Solution: Install the Zilliz CLI:

    pip install zilliz-cli

  • Authentication fails

    Solution:

    1. Check your internet connection

    2. Verify your Zilliz Cloud account is active

    3. Try logging out and back in:

    zilliz auth logout
    zilliz auth login

  1. "No cluster configured"

    Solution: Set a default cluster:

    zilliz context set --cluster-id <cluster-id>

Next Steps​