MCP server

O que é

O Geneziz vem com um MCP (Model Context Protocol) server que expõe sua base de conhecimento a assistentes de IA. É um server stdio local: roda na sua máquina como subprocesso do seu cliente de IA, não há porta para configurar e ele lê seus arquivos Markdown locais diretamente. Sua base de conhecimento não sai da sua máquina.

O server expõe 34 tools e 4 recursos knowledge:// (stats, index, trends, categories), agrupados pelo que fazem:

• Pesquisa - palavras-chave, semântica, itens relacionados, duplicatas e buscas por data
• Listagens - tools, articles, tags, categories, domains
• Leitura de um item - uma tool, article ou bookmark completo, além de estatísticas
• Ask + memory loop - Q&A sobre toda a base, com conversas de follow-up salvas
• Escrita - salve links, adicione notas, gere TL;DRs a partir do seu assistente
• Curadoria e edição segura - organização em lote, tagging, edições de frontmatter, reclassificação, archive/restore e undo
• Autoaperfeiçoamento - varreduras de qualidade, reparo de lacunas, cross-links de wiki, checagem de duplicatas, enriquecimento de links
• Recursos - knowledge://stats, knowledge://index, knowledge://trends, knowledge://categories

O ask_kb responde uma pergunta sobre toda a sua base de conhecimento com fontes citadas, e um conversation_id encadeia follow-ups em uma conversa salva. Perguntar custa 1 crédito por pergunta pelo proxy do proxy de IA do Geneziz; é gratuito com a sua própria chave de API (BYOK). Veja Modos de IA.

Ativação

O MCP requer uma conta Geneziz ativada (a licença de US$ 99, preço único) e roda localmente na sua máquina. O registro - escrever as entradas de configuração abaixo - não precisa de licença; iniciar o server precisa.

Configuração automática

geneziz mcp register

O comando detecta os clientes de IA suportados na sua máquina e escreve a entrada do server no arquivo de configuração de cada um: Claude Desktop, Claude Code, Cursor, Windsurf, Codex, VS Code, ZCode e OpenCode. Cada entrada recebe o caminho absoluto do executável geneziz, o argumento mcp e uma variável de ambiente GENEZIZ_DATA_DIR apontando para o seu diretório de dados - então nenhuma configuração de PATH é necessária. Apenas a entrada geneziz é escrita; seus outros MCP servers ficam intocados, e um backup único de cada configuração é feito antes da primeira alteração.

Inspecione ou desfaça o registro:

geneziz mcp register --status        # what's registered, per client (JSON)
geneziz mcp register --remove --all  # remove only the Geneziz entries

Configuração manual

Cada cliente abaixo aceita a mesma definição de server - comando geneziz, argumento mcp - no formato do arquivo de configuração desse cliente. O executável geneziz precisa estar no seu PATH (o registro automático, em vez disso, escreve o caminho absoluto, o que elimina esse requisito).

Claude Code

Adicione uma entrada geneziz em mcpServers no ~/.claude.json:

{
  "mcpServers": {
    "geneziz": {
      "command": "geneziz",
      "args": ["mcp"]
    }
  }
}

Cursor

Adicione a mesma entrada em mcpServers no ~/.cursor/mcp.json:

{
  "mcpServers": {
    "geneziz": {
      "command": "geneziz",
      "args": ["mcp"]
    }
  }
}

Windsurf

Adicione a mesma entrada em mcpServers no ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "geneziz": {
      "command": "geneziz",
      "args": ["mcp"]
    }
  }
}

ZCode

O ZCode lê um formato aninhado mcp.servers e requer "type": "stdio". Adicione uma entrada geneziz no ~/.zcode/cli/config.json:

{
  "mcp": {
    "servers": {
      "geneziz": {
        "type": "stdio",
        "command": "geneziz",
        "args": ["mcp"]
      }
    }
  }
}

Variável de ambiente

Se o seu cliente de IA iniciar geneziz mcp e encontrar uma base de conhecimento vazia, adicione a variável de ambiente GENEZIZ_DATA_DIR à entrada, apontando para o seu diretório de dados (por exemplo ~/Library/Application Support/Geneziz no macOS). O registro automático sempre escreve essa variável - veja o vault.

Experimentando

Em uma nova sessão, faça uma pergunta que envolva o que você salvou:

Quais tools eu salvei para Rust async?

O assistente pesquisa sua base de conhecimento local e responde com títulos, categorias e trechos. Veja Setting up the Geneziz MCP server with Claude Code para o passo a passo, e a visão geral para o restante do produto. Os preços estão em /landing#pricing.