OTG.Hawk Logo

OTG.Hawk

v1.0.2609.16
Online

Il Model Context Protocol (MCP) server che connette Claude Code alla Knowledge Base aziendale.

Connetti Claude Desktop

Step 1
Fatti emettere un token personale da un amministratore.
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", "mcp-remote", "https://hawk.otg.it/mcp",
               "--header", "Authorization: Bearer IL_TUO_TOKEN"]
    }
  }
}
Nota di sicurezza: ogni chiamata a /mcp richiede il tuo Bearer token. Senza header di autorizzazione l'endpoint risponde 401.

Amministrazione

Strumenti MCP esposti clicca una scheda per la descrizione completa

Knowledge Base

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.

OiO — Ticket e attività

oio_list_operators Query
Elenca gli operatori OiO abilitati (ruolo OPERATOR o SUPERVISOR), con ricerca per nome/cognome o risoluzione diretta per UserId.
oio_list_recipients Query
Elenca i destinatari di ticketing OiO, con ricerca per nome, indirizzo o cliente, o risoluzione diretta per Id.
oio_list_task_projects Query
Elenca i progetti attività OiO a cui un task può appartenere, con ricerca testuale e opzione per includere i progetti chiusi.
oio_list_customers Query
Elenca i clienti OiO, anche disabilitati, con ricerca per ragione sociale o risoluzione diretta per Id.
oio_search_tickets Query
Cerca nello storico dei ticket OiO per stato, priorità, canale, tipo, gruppo, cliente, operatore o data. Restituisce righe sintetiche ordinate dall'ultimo aggiornamento.
oio_read_ticket Read
Legge un ticket OiO con la sua conversazione completa, entry per entry, con troncamento automatico dei contenuti più lunghi. Le immagini incorporate nelle entry (screenshot, allegati inline) vengono risolte e restituite come immagini leggibili, non solo come link nel testo.
oio_search_timesheets Query
Cerca tra i rapportini OiO (attività e appuntamenti) per cliente, progetto, operatore, periodo, testo o stato di fatturazione. Restituisce righe sintetiche dalla più recente, con ore totali, fatturate e di viaggio.
oio_read_timesheet Read
Legge un rapportino OiO completo, con descrizione e note per esteso, chilometri e rimborsi. Ferie, malattie e permessi non sono consultabili.
oio_create_task Write
Crea un task in OiO. Il corpo HTML viene diviso sui tag <hr> in task principale e subtask, con validazione di destinatario, progetto e follower.