DocsAgent
Server MCP di docsagent
Cerca e leggi la tua libreria Zotero, il vault Obsidian e Apple Notes in locale con un motore di ricerca BM25 nativo in C++.
Installa DocsAgent
Gira sul tuo computer. Il tuo client lo avvia con questo comando:
Richiede Node.js sul tuo computer. I passaggi qui sotto mostrano dove va il comando in ogni client.
DOCSAGENT_CONFIGfacoltativo Path to the shared docsagent config file (default: ~/.docsagent/config.json)
Condividi questo server
Apre questa pagina, con il comando di installazione e i passaggi di configurazione.
mcp.tc/i/docsagentDescrizione
DocsAgent collega un assistente AI a una base di conoscenza personale: elementi, annotazioni e note di Zotero, vault Obsidian e Apple Notes su macOS. Offre ricerca full-text BM25 con ranking dei passaggi, ricerca mista tra le fonti, recupero di contenuti e metadati, esportazione di citazioni e alcuni strumenti di scrittura controllati.
Viene eseguito in locale tramite stdio dal pacchetto npm @docsagent/docsagent (è disponibile anche un wrapper Python, docsagent-mcp-zotero). Prima va avviato un core C++ residente, che legge i tuoi dati sulla tua macchina. Per l’uso locale non servono account né chiave API.
Cosa puoi fare
- Cercare in Zotero, Obsidian e Apple Notes con ranking BM25
- Eseguire ricerche grep letterali in una fonte
- Leggere passaggi o testo completo di una voce
- Recuperare metadati, annotazioni e citazioni (BibTeX, CSL JSON)
- Sfogliare collezioni, tag, cartelle e ricerche salvate
- Scrivere note tramite un percorso di scrittura controllato
Tool
I server locali mostrano i loro tool solo quando sono in esecuzione, e questo non pubblica l’elenco in anticipo. Il tuo client li mostra dopo che lo hai aggiunto.
Prompt di esempio
Elenca le mie fonti ricercabili in DocsAgent
Cerca nella mia libreria Zotero i paper sull’attenzione nei transformer
Trova le note Obsidian che citano la roadmap del progetto
Ottieni una citazione BibTeX per il primo risultato su BM25
Configurazione
Ogni client avvia DocsAgent sul tuo computer con lo stesso comando. Scegli il tuo; la pagina ricorda la tua scelta.
Claude Code
- Eseguilo in un terminale, nella cartella del tuo progetto:
claude mcp add --transport stdio docsagent -- npx -y @docsagent/docsagent- Avvia Claude Code e digita
/mcp. docsagent dovrebbe risultare collegato.
Aggiungi --scope user per renderlo disponibile in tutti i progetti.
Claude Desktop
- Apri Settings → Developer → Edit Config. Si apre
claude_desktop_config.json. Aggiungi:
{
"mcpServers": {
"docsagent": {
"command": "npx",
"args": [
"-y",
"@docsagent/docsagent"
]
}
}
}- Salva il file e riavvia Claude Desktop.
Richiede Node.js sul tuo computer. Il file si trova in ~/Library/Application Support/Claude/ su macOS e in %APPDATA%\Claude\ su Windows.
Cursor
Aggiungi a Cursor (si apre in una nuova scheda)
Oppure aggiungilo a mano in ~/.cursor/mcp.json (tutti i progetti) o in .cursor/mcp.json (questo progetto):
{
"mcpServers": {
"docsagent": {
"command": "npx",
"args": [
"-y",
"@docsagent/docsagent"
]
}
}
}Richiede Node.js sul tuo computer.
VS Code
Installa in VS Code (si apre in una nuova scheda)
Oppure da un terminale:
code --add-mcp '{"name":"docsagent","type":"stdio","command":"npx","args":["-y","@docsagent/docsagent"]}'Oppure fai commit nel repository in .vscode/mcp.json:
{
"servers": {
"docsagent": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@docsagent/docsagent"
]
}
}
}Richiede Node.js sul tuo computer.
Devin Desktop
- Aggiungilo a
~/.config/devin/mcp_config.json(macOS e Linux) o a%APPDATA%\devin\mcp_config.json(Windows):
{
"mcpServers": {
"docsagent": {
"command": "npx",
"args": [
"-y",
"@docsagent/docsagent"
]
}
}
}- Aggiorna l’elenco dei server MCP in Cascade.
Devin Desktop è il nuovo nome di Windsurf.
Codex
codex mcp add docsagent -- npx -y @docsagent/docsagentOppure modifica direttamente ~/.codex/config.toml:
[mcp_servers.docsagent]
command = "npx"
args = ["-y", "@docsagent/docsagent"]Richiede Node.js sul tuo computer.
Gemini CLI
gemini mcp add docsagent npx -- -y @docsagent/docsagentCosì lo aggiungi al progetto corrente. Aggiungi -s user per usarlo ovunque.
Qualsiasi client
La maggior parte dei client che avviano server locali accetta questa forma:
{
"mcpServers": {
"docsagent": {
"command": "npx",
"args": [
"-y",
"@docsagent/docsagent"
]
}
}
}Zed mette i server sotto context_servers nelle sue impostazioni, con gli stessi campi command, args ed env.
Richiede Node.js sul tuo computer.
Embed
Mostra DocsAgent in un README o sul tuo sito. Ogni embed rimanda a questa pagina, usa il comando di installazione del server e non imposta cookie. Come funzionano gli embed
Card, iframe e JSON sono in inglese. Aggiungi ?lang=it, fr, de o es al loro indirizzo per un’altra lingua.
Badge per il README
[](https://mcp.tc/i/docsagent)<a href="https://mcp.tc/i/docsagent"><img src="https://mcp.tc/i/docsagent/badge.svg" alt="DocsAgent on mcp.tc" height="20"></a>Segue la modalità chiara o scura di chi legge. Aggiungi ?theme=light o ?theme=dark per fissarla, oppure ?style=compact per mostrare il simbolo senza la scritta.
Card per il sito
<script src="https://mcp.tc/w/docsagent.js" async></script>La card compare dove si trova il tag. Aggiungi data-theme="dark" o data-size="compact" al tag per cambiarla. Il file contiene tutto ciò che serve, quindi non fa altre richieste e non imposta cookie.
iframe
<iframe src="https://mcp.tc/embed/docsagent" title="DocsAgent on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>Usalo nelle pagine che non consentono script. Aggiungi ?theme=light o ?theme=dark all’indirizzo per fissare i colori.
JSON
La scheda come dati per le tue pagine e i tuoi strumenti: nome, descrizione breve, comando di installazione, tool e i link «Add to». Qualsiasi sito può leggerla (CORS aperto).
https://mcp.tc/i/docsagent.jsonPrompt per l’AI
Incollalo in un assistente di programmazione con l’AI, come Claude Code o Cursor, e aggiungerà la card di DocsAgent al tuo sito.
Aggiungi al mio sito la card di mcp.tc per DocsAgent, un server MCP. È un solo script statico: niente build, nessun pacchetto da installare, nessun cookie.
Metti questo tag dove deve comparire la card. La card appare subito prima del tag:
```html
<script src="https://mcp.tc/w/docsagent.js" async></script>
```
Per mostrarla altrove, metti lì questo segnaposto e carica lo stesso script una volta sola, per esempio prima di `</body>`. Lascia il link al suo interno: lo vede chi non ha JavaScript.
```html
<div data-mcptc="docsagent"><a href="https://mcp.tc/i/docsagent">DocsAgent on mcp.tc</a></div>
```
Opzioni:
- `data-theme="light"` o `"dark"` sul tag o sul segnaposto fissa i colori. Senza l’attributo, la card segue la modalità chiara o scura di chi visita.
- `data-size="compact"` dà una card più piccola, senza la descrizione breve.
- La variabile CSS `--mcptc-max-width` sul segnaposto o su un elemento padre imposta la larghezza (predefinita `520px`).
- `?lang=` nell’URL dello script imposta la lingua della card: `en`, `it`, `fr`, `de` o `es`.
Se il sito ha una Content Security Policy, consenti `script-src https://mcp.tc` e `img-src data:` (l’icona è inline).
Per un README o altra documentazione in Markdown, usa invece il badge:
```markdown
[](https://mcp.tc/i/docsagent)
```
Riferimento: https://mcp.tc/it/embedCronologia delle modifiche
Questo server gira sul tuo computer, quindi seguiamo il suo pacchetto npm: qui compare ogni nuova versione, insieme alle modifiche di chi lo gestisce.
Domande frequenti
Posso incollare mcp.tc/i/docsagent nel mio client MCP?
No. DocsAgent gira sul tuo computer, avviato dal tuo client, quindi non ha un indirizzo web a cui collegarsi. Il link rapido è la pagina da condividere; il comando di installazione è npx -y @docsagent/docsagent.
DocsAgent richiede una chiave API?
No. Non dichiara chiavi né variabili d’ambiente. Gira con i permessi del tuo account utente, quindi controlla cosa possono raggiungere i suoi tool.
DocsAgent è un server remoto o locale?
Locale. Il tuo client lo avvia come processo sul tuo computer con npx -y @docsagent/docsagent, che richiede Node.js.
Cosa può fare DocsAgent?
Puoi cercare in Zotero, Obsidian e Apple Notes con ranking BM25, eseguire ricerche grep letterali in una fonte e leggere passaggi o testo completo di una voce.
Quali client possono usarlo?
Qualsiasi client che avvia server locali: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed e altri. claude.ai e ChatGPT si collegano solo a server remoti.
mcp.tc tiene traccia delle modifiche di DocsAgent?
In parte. Gira sul tuo computer, quindi seguiamo il suo pacchetto npm: la sua sezione Cronologia mostra ogni nuova versione e le modifiche di chi lo gestisce. Segui la scheda per ricevere un’email quando cambia.
Chi ha scritto questa pagina?
Il robot di mcp.tc ha letto i metadati pubblici di DocsAgent (le pagine del suo pacchetto e del repository), e un modello di AI ne ha ricavato il testo. Una persona esamina tutto ciò che i controlli non riescono a confermare. Il testo può comunque contenere errori, quindi se ne trovi uno usa Segnala questa scheda su questa pagina. Questa traduzione è stata fatta da un modello di AI a partire dal testo inglese.
mcp.tc non è affiliato a docsagent. Questa pagina è stata creata a partire dai metadati pubblici di DocsAgent (ultimo controllo: 12 ott 2026), e la descrizione l’ha scritta un modello di AI, quindi può contenere errori. Nomi e marchi appartengono ai rispettivi titolari. Qualcosa non va? Segnala questa scheda. La traduzione è stata fatta da un modello di AI a partire dal testo inglese.