Model Context Protocol (MCP)

# macOS/Linux
cat ~/.claude/claude_desktop_config.json

# Windows
cat $APPDATA\Claude\claude_desktop_config.json

# Se não existir, crie um vazio
cat > ~/.claude/claude_desktop_config.json << 'EOF'
{}
EOF

# Edite o arquivo
cat > ~/.claude/claude_desktop_config.json << 'EOF'
{
  "mcpServers": {
    "vectora": {
      "command": "vectora",
      "args": ["mcp", "--stdio"],
      "env": {
        "GEMINI_API_KEY": "seu-gemini-api-key",
        "VOYAGE_API_KEY": "seu-voyage-api-key",
        "VECTORA_NAMESPACE": "seu-projeto"
      }
    }
  }
}
EOF

Usuário: "Você tem acesso a Vectora. Como validamos tokens?"

Claude: Vou procurar no seu codebase...
└─ @vectora search_context("token validation")
└─ Mostra chunks relevantes
└─ Explica baseado no código real

# macOS/Linux
~/.cursor/cursor_settings/cursor_desktop_config.json

# Windows
$APPDATA\Cursor\User\cursor_desktop_config.json

{
  "mcpServers": {
    "vectora": {
      "command": "vectora",
      "args": ["mcp", "--stdio"],
      "env": {
        "GEMINI_API_KEY": "...",
        "VOYAGE_API_KEY": "...",
        "VECTORA_NAMESPACE": "seu-projeto"
      }
    }
  }
}

{
  "assistant": {
    "external_tools": {
      "vectora": {
        "command": "vectora",
        "args": ["mcp", "--stdio"]
      }
    }
  }
}

{
  "method": "tools/call",
  "params": {
    "name": "search_context",
    "arguments": {
      "query": "Como validar JWTs?",
      "top_k": 5,
      "threshold": 0.7
    }
  }
}

{
  "params": {
    "name": "search_tests",
    "arguments": {
      "query": "autenticação",
      "top_k": 10
    }
  }
}

{
  "params": {
    "name": "analyze_dependencies",
    "arguments": {
      "symbol": "getUserById",
      "depth": 2,
      "include_indirect": true
    }
  }
}

{
  "params": {
    "name": "find_similar_code",
    "arguments": {
      "code_snippet": "async function validateToken(token) { ... }",
      "language": "typescript",
      "top_k": 5
    }
  }
}

{
  "params": {
    "name": "get_file_structure",
    "arguments": {
      "path": "src/auth/validate.ts"
    }
  }
}

{
  "params": {
    "name": "list_files",
    "arguments": {
      "pattern": "*.ts",
      "limit": 100
    }
  }
}

{
  "params": {
    "name": "list_namespaces",
    "arguments": {}
  }
}

{
  "params": {
    "name": "get_namespace_stats",
    "arguments": {
      "namespace": "seu-projeto"
    }
  }
}

{
  "params": {
    "name": "index_status",
    "arguments": {
      "namespace": "seu-projeto"
    }
  }
}

{
  "params": {
    "name": "reindex",
    "arguments": {
      "namespace": "seu-projeto",
      "force": true
    }
  }
}

{
  "params": {
    "name": "get_config",
    "arguments": {}
  }
}

{
  "params": {
    "name": "get_metrics",
    "arguments": {
      "namespace": "seu-projeto"
    }
  }
}

Usuário: "Explique como funciona autenticação neste projeto"

1. IDE chama: @vectora search_context("autenticação")
2. Vectora retorna:
   - src/auth/validate.ts (precisão 0.95)
   - src/middleware/auth.ts (0.89)
   - src/guards/jwt.ts (0.85)
   - tests/auth.test.ts (0.82)

3. Claude analisa chunks:
   - "Vejo que usam JWT com expiração de 1h"
   - "Middleware valida em cada request"
   - "3 guards diferentes: Bearer, Session, OAuth"

4. Explicação final com código real do projeto

Usuário: "Este teste falha. Por quê?"

1. IDE: @vectora search_tests("erro 401")
   └─ Encontra testes falhando

2. IDE: @vectora analyze_dependencies("validateToken")
   └─ Mostra quem chama a função

3. IDE: @vectora get_file_structure("src/auth/validate.ts")
   └─ Mostra estrutura do arquivo

4. Claude debugga com contexto real

Usuário: "Revise essa função de cache"

1. IDE: @vectora find_similar_code(seu_código)
   └─ Encontra funções similares existentes

2. IDE: @vectora search_context("cache implementation")
   └─ Mostra padrões de cache no projeto

3. Claude: "Vejo que o projeto usa Pattern X, sua implementação deveria..."

{
  "mcpServers": {
    "vectora": {
      "command": "vectora",
      "args": ["mcp", "--stdio"],
      "env": {
        "VECTORA_NAMESPACE": "staging"
      }
    }
  }
}

# Claude Code + Cursor + Zed
# Todos compartilham mesmo cacheE indices via namespace

VECTORA_NAMESPACE="seu-projeto"

{
  "mcpServers": {
    "vectora": {
      "env": {
        "VECTORA_LOG_LEVEL": "debug",
        "VECTORA_LOG_FILE": "~/.vectora/mcp.log"
      }
    }
  }
}

{
  "mcpServers": {
    "vectora": {
      "env": {
        "VECTORA_MCP_PORT": "9091"
      }
    }
  }
}

# Verifique instalação
which vectora
vectora --version

# Reinstale se necessário
npm install -g @kaffyn/vectora@latest

# Ou use caminho absoluto em config
{
  "command": "/usr/local/bin/vectora"
}

# Teste manualmente
vectora mcp --stdio

# Envie handshake:
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' | vectora mcp --stdio

# Se falha, verifique logs
VECTORA_LOG_LEVEL=debug vectora mcp --stdio

# Verifique variáveis
echo $GEMINI_API_KEY
echo $VOYAGE_API_KEY

# Se vazio, configure em config JSON ou .env
export GEMINI_API_KEY="seu-valor"
export VOYAGE_API_KEY="seu-valor"

# Teste
vectora config show

# Liste namespaces
vectora namespace list

# Configure o namespace correto
{
  "env": {
    "VECTORA_NAMESPACE": "seu-projeto-real"
  }
}