Skip to main content

Connecting Vectorize MCP Server to Claude Desktop

This guide shows you how to connect your Vectorize MCP agent to Claude Desktop, enabling Claude to access your agent's capabilities directly within the desktop application.

Prerequisites​

  • Claude Desktop installed on your computer
  • A Vectorize MCP agent already created with at least one tool configured
  • An API key for your Vectorize agent

Setup Instructions​

Step 1: Get Your Agent Configuration​

From your Vectorize agent:

  1. Navigate to your agent's Agent API Keys section
  2. If you don't have an API key yet:
    • Click Create New Key
    • Give it a descriptive name (e.g., "Claude Desktop Key")
    • Click Create Key
  3. Copy the automatically generated MCP configuration - it will have your Agent ID and API key already filled in

Step 2: Locate Claude Desktop Configuration​

Find your Claude Desktop configuration file:

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

Step 3: Add Vectorize MCP Server Configuration​

Open the configuration file and add the MCP server configuration that Vectorize provided when you created your API key. It will look similar to this:

{
  "mcpServers": {
    "vectorize-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://agents.vectorize.io/api/agents/AGENT_ID/mcp",
        "--header",
        "Authorization: Bearer ${VECTORIZE_API_KEY}"
      ],
      "env": {
        "VECTORIZE_API_KEY": "YOUR_ACTUAL_API_KEY"
      }
    }
  }
}

Important: Use the exact configuration provided by Vectorize after creating your API key - it will have your actual Agent ID and API key already filled in.

Step 4: Restart Claude Desktop​

After saving the configuration file, completely quit and restart Claude Desktop for the changes to take effect.

Verification​

Once Claude Desktop restarts, you should see the Vectorize MCP server connection in the interface. The server will:

  1. You will see all of your connected tools by clicking on the Search and tools button

Search and tools button

  1. Here you will see the Agent's name and the number of tools that are connected.

Agent tools overview

  1. Click on your agent to toggle the tools on or off.

Agent tools toggle

Using Your MCP Tools​

Once connected, you can interact with your Vectorize agent directly in Claude Desktop by asking questions or making requests related to your configured tools. Claude will automatically use the appropriate tools based on your queries and the tool descriptions you've configured - make sure your tool descriptions clearly explain what each tool does so Claude knows when to use them.

Troubleshooting​

Not Seeing Expected Results​

If your agent isn't returning the results you expect:

  • Check your metadata filters - incorrect or overly restrictive filters are a common cause of poor results
  • Review your tool descriptions - unclear or inaccurate descriptions can prevent Claude from using the right tools at the right time
  • Verify your pipeline configuration and data indexing
  • Ensure your tools are properly connected to the right pipelines
  • Test your queries with different phrasing or broader search terms

Was this page helpful?