August MCP

August espone un server pubblico Model Context Protocol (MCP) all'indirizzo /api/mcp nell'app web August a cui accedi. Indica quell'endpoint a qualsiasi client MCP che supporti Streamable HTTP ed esegui l'autenticazione con una chiave API August o un token di accesso OAuth. È l'opposto di MCP Support, che riguarda la connessione in uscita di August ad altri server MCP come client.

L'endpoint

Il server MCP utilizza Streamable HTTP, quindi il client si connette direttamente a /api/mcp nell'app web August, senza bisogno di configurare un trasporto separato.

1. Nel client MCP, aggiungi un nuovo server MCP remoto e imposta il relativo URL su /api/mcp nell'app web August.

2. Scegli il metodo di autenticazione del client: una chiave API August o un token di accesso OAuth.

Esegui l'autenticazione con una chiave API

Una chiave API August identifica il tuo account utente ed è il modo più semplice per connettere un client sotto il tuo controllo.

1. Nelle impostazioni del tuo account August, apri la scheda API Keys e crea una chiave. Le chiavi iniziano con ak_ e sono associate al tuo account utente, quindi una chiave a livello di organizzazione non funzionerà in questo caso.

2. Configura il client MCP affinché invii la chiave nell'header Authorization come token bearer: Authorization: Bearer ak_....

Esegui l'autenticazione con OAuth

Se invece il client esegue l'accesso tramite OAuth, utilizza un token di accesso OAuth come token bearer nello stesso header Authorization. Il flusso OAuth richiede l'ambito email.

Rilevamento OAuth

I client che supportano il rilevamento OAuth possono trovare automaticamente il server di autorizzazione. Se un client si connette senza credenziali, l'endpoint risponde con una richiesta di autorizzazione che rimanda ai metadati della risorsa protetta disponibili all'indirizzo /.well-known/oauth-protected-resource/api/mcp. Questo documento è disponibile pubblicamente e indica a un client compatibile da dove avviare il flusso OAuth, quindi non è necessario configurare manualmente il server di autorizzazione.

Strumenti disponibili

Il server MCP espone la superficie dell'API pubblica di August come strumenti MCP, così il client può utilizzare le operazioni pubbliche rilasciate senza dover gestire un elenco di strumenti separato. Le stesse operazioni sono disponibili tramite l'API REST; consulta August API. Le aree coperte includono progetti, cartelle, documenti, chat, ricerca legale, flussi di lavoro, competenze, tag, ricerca e caricamenti.

I nomi degli strumenti seguono i percorsi delle procedure API. Ad esempio, l'operazione dell'API pubblica projects.list è esposta come projects_list.