@patricklouback/mcp-acervo

MCP server (stdio) que dá acesso ao Acervo do Inventta Tools dentro de clientes MCP como Claude Code, Cursor, Codex, Continue, etc.

Como usar

1. Gere um token pessoal (PAT) em https://inventta-tools.avantti.app/settings/tokens.
2. Adicione a config ao seu cliente MCP:

{
  "mcpServers": {
    "inventta-acervo": {
      "command": "npx",
      "args": ["-y", "@patricklouback/mcp-acervo"],
      "env": {
        "INVENTTA_API_URL": "https://api-inventta-tools.avantti.app",
        "INVENTTA_API_TOKEN": "inv_pat_..."
      }
    }
  }
}

3. Reinicie o cliente. As tools acervo_* aparecem na sua sessão.

Tools disponíveis

| Tool | O que faz | |---|---| | acervo_get_tree | Lista toda a árvore (pastas + docs, sem conteúdo) | | acervo_search_docs | Busca por termo em título e conteúdo | | acervo_get_doc | Lê o markdown completo de um doc | | acervo_list_folders | Lista pastas filhas de uma pasta (ou raiz) | | acervo_list_docs | Lista docs de uma pasta (ou raiz) | | acervo_create_doc | Cria um doc novo | | acervo_update_doc | Edita título / conteúdo / pasta de um doc | | acervo_delete_doc | Exclui um doc | | acervo_create_folder | Cria pasta | | acervo_update_folder | Renomeia / move pasta | | acervo_delete_folder | Exclui pasta (e tudo dentro) |

Variáveis de ambiente

| Var | Default | Descrição | |---|---|---| | INVENTTA_API_URL | http://localhost:3333 | URL base da API do Inventta Tools | | INVENTTA_API_TOKEN | — | PAT (formato inv_pat_...). Obrigatório. |

Permissões

O token herda exatamente as permissões do usuário que o gerou. Tokens podem ser revogados a qualquer momento em /settings/tokens.