@patricklouback/mcp-inventta-tools

MCP server (stdio) que dá acesso às ferramentas do Inventta Tools — hoje o Wiki, os arquivos do OneDrive/SharePoint e os agentes autônomos — dentro de clientes MCP como Claude Code, Cursor, Codex, Continue, etc.

As tools, o client e o createMcpServer ficam em @inventta/mcp-core; este pacote é um wrapper fino de stdio e o build (esbuild) inlina essa lib no dist/index.js. As mesmas tools também são expostas como conector remoto OAuth para o Claude.ai web (ver abaixo).

Como usar (stdio — Claude Code, Cursor, Codex)

1. Gere um token pessoal (PAT) em https://inventta-tools.avantti.app/settings/tokens.
2. Adicione a config ao seu cliente MCP (a própria tela /settings/tokens já gera esse JSON e um prompt que configura tudo sozinho):

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

3. Reinicie o cliente. As tools wiki_*, remote_* e agent_* aparecem na sua sessão.

Conector web (Claude.ai) — OAuth

No Claude.ai (web/desktop) não se usa este pacote nem um PAT: as mesmas tools são servidas pela rota /mcp da API (lib @inventta/mcp-connector), autenticadas por OAuth 2.1.

1. Configurações → Conectores → Adicionar conector personalizado.
2. URL: https://api-inventta-tools.avantti.app/mcp — deixe Client ID/Secret vazios (DCR).
3. Adicionar → Conectar → autorize com sua conta Microsoft.

A tela /settings/tokens mostra essa URL pronta. Arquitetura, deploy e troubleshooting estão na wiki: "MCP Remoto — Conector OAuth para Claude.ai web".

Tools disponíveis

| Tool | O que faz | | ---------------------------- | ------------------------------------------------------- | | wiki_get_tree | Lista toda a árvore (pastas + docs, sem conteúdo) | | wiki_search_docs | Busca por termo em título e conteúdo | | wiki_get_doc | Lê o markdown completo de um doc | | wiki_list_folders | Lista pastas filhas de uma pasta (ou raiz) | | wiki_list_docs | Lista docs de uma pasta (ou raiz) | | wiki_create_doc | Cria um doc novo | | wiki_update_doc | Edita título / conteúdo / pasta de um doc | | wiki_delete_doc | Exclui um doc | | wiki_create_folder | Cria pasta | | wiki_update_folder | Renomeia / move pasta | | wiki_delete_folder | Exclui pasta (e tudo dentro) | | remote_get_drives | Lista drives do OneDrive/SharePoint sincronizados | | remote_search | Busca arquivos/pastas por nome | | remote_list_folder | Lista o conteúdo direto de uma pasta | | remote_breadcrumb | Caminho hierárquico de um item | | remote_get_content | Extrai o texto de um arquivo (pdf, docx, xlsx…) | | remote_index_drive | Indexa e resume um drive inteiro | | agent_list | Lista agentes visíveis (seus, públicos, compartilhados) | | agent_get | Lê a configuração completa de um agente | | agent_create | Cria um agente (você vira o dono) | | agent_update | Edita um agente (se você puder editar) | | agent_delete | Exclui um agente (só dono/admin) | | agent_get_access | Mostra visibilidade, bloqueio e compartilhamentos | | agent_set_access | Define visibilidade / bloqueio (só dono/admin) | | agent_list_shares | Lista compartilhamentos de um agente | | agent_add_share | Compartilha com um usuário (reader/editor) | | agent_remove_share | Remove um compartilhamento | | agent_run | Dispara uma execução manual | | agent_list_runs | Lista execuções recentes | | agent_get_run | Detalhes de uma execução | | agent_retry_run | Reexecuta uma execução | | agent_delete_run | Exclui uma execução do histórico | | agent_clear_runs | Limpa o histórico de execuções | | agent_duplicate | Duplica um agente como novo agente seu | | agent_rotate_webhook_token | Gera novo token de webhook |

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.