Configurazione & Guida
Step 1
Genera un token di autenticazione sicuro per il tuo client:
dotnet run --project src/OTG.Hawk create-token <username>Step 2
Configura Claude Desktop (
claude_desktop_config.json) o un altro client MCP per connettersi all'endpoint SSE:{
"mcpServers": {
"otg-hawk": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/client-sse",
"http://localhost:5128/mcp"
],
"env": {
"AUTHORIZATION": "Bearer IL_TUO_TOKEN"
}
}
}
}
Nota di sicurezza: L'endpoint MCP di produzione richiede Bearer Authentication. Assicurati che le chiamate verso
/mcp includano l'header di autorizzazione generato al primo step.
Strumenti MCP Esposti
search_documents
Query
Cerca per parole chiave nel testo completo dei documenti (titolo, descrizione, tag, contenuto Markdown). Restituisce gli id corrispondenti con punteggio di rilevanza e snippet; senza risultati ritorna un set di risultati vuoto. Consente di filtrare per famiglia o prefisso di path.
read_document
Read
Legge e restituisce il contenuto completo in Markdown di un singolo documento specificando il suo ID univoco (es.
sql:42 o git:OCApi/guide.md).
list_families
Metadata
Restituisce le famiglie software (prodotti) coperte dalla knowledge base, complete di codici identificativi, nomi e descrizioni.
refresh
Admin
Ricostruisce la cache integrando e aggiornando le diverse sorgenti configurate (es. git pull + lettura SQL). Ritorna un sommario dei risultati per sorgente.