Skip to main content

Claude Desktop Integration

Connect your Vectorize MCP agent to Claude Desktop for AI assistance powered by your private data.

Prerequisites​

  • Claude Desktop installed (Download here)
  • MCP agent created in Vectorize
  • At least one function configured
  • API key generated for your agent

Quick Setup​

1. Get Your Configuration​

  1. Open your MCP agent in Vectorize
  2. Go to Agent API Keys
  3. Click Create New Key and name it (e.g., "Claude Desktop")
  4. Copy the provided configuration

2. Locate Configuration File​

macOS:

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

Windows:

%APPDATA%\Claude\claude_desktop_config.json

3. Add Configuration​

Open the configuration file and paste the configuration from Vectorize:

{
  "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"
      }
    }
  }
}

The configuration is pre-filled with your Agent ID and API key.

4. Restart Claude Desktop​

Completely quit and restart Claude Desktop to apply changes.

Verify Connection​

  1. Click the Search and tools button in Claude Desktop

Search and tools button

  1. You'll see your agent name and number of available functions

Agent tools overview

  1. Click your agent to enable/disable functions

Agent tools toggle

Usage Tips​

Effective Queries​

Claude automatically selects the right function based on your question:

  • Be specific about what you're looking for
  • Mention relevant keywords from your data
  • Reference the type of information needed

Example Prompts​

  • "Search our engineering docs for authentication setup"
  • "Find customer feedback about the dashboard feature"
  • "What do our API docs say about rate limiting?"

Troubleshooting​

Agent Not Appearing​

  • Verify configuration was saved correctly
  • Ensure Claude Desktop was fully restarted
  • Check API key is valid in Vectorize dashboard

Poor Results​

  • Review function descriptions for clarity
  • Check pipeline has indexed content
  • Test without metadata filters first
  • Try broader search terms

Connection Errors​

  • Validate API key hasn't expired
  • Check internet connectivity
  • Verify Agent ID is correct

Next Steps​

Was this page helpful?