Sviluppatori
Collega WŬMÙ ai tuoi sistemi
WŬMÙ è aperto alle integrazioni in tre modi: le app accedono con OAuth 2.0 e PKCE e lavorano con i dati tramite la REST API v2 con descrizione OpenAPI, mentre gli assistenti IA si collegano al server MCP tramite un URL.
Le chiavi si ottengono nella console sviluppatori: accedi a WŬMÙ, crea un’app e ricevi il tuo client_id.
https://wumu.ai
- Autorizzazione
- /api/oauth/authorize
- Token
- /api/oauth/token
- REST API v2
- /api/v2
- OpenAPI
- /api/v2/openapi.json
- Server MCP
- /mcp
Tre modi per collegarsi
Scegli come collegarti
La tua app o il tuo servizio si collega tramite OAuth e la REST API. Un assistente IA si collega tramite il server MCP, senza registrare alcuna app.
OAuth 2.0 con PKCE
Per siti web, servizi e app mobili che lavorano con i dati di un utente WŬMÙ con il suo consenso.
- Codice di autorizzazione con PKCE (S256) e rotazione dei token di aggiornamento; client_credentials per le chiamate da server a server
- L’utente vede una schermata di consenso e concede solo le autorizzazioni necessarie: profilo, documenti, chat, contatti e altro
- I client pubblici — app mobili e SPA — non ricevono alcun segreto
- Webhook firmati con HMAC-SHA256 e registro di richieste e consegne nella console sviluppatori
- Una nuova app entra in funzione dopo la verifica di un amministratore WŬMÙ
REST API v2
Un’API JSON per documenti, fogli di calcolo, chat IA, messenger, contatti, calendario e altre sezioni di WŬMÙ.
- Descrizione OpenAPI leggibile dalle macchine, che indica le autorizzazioni richieste da ogni operazione
- Il token di accesso va nell’intestazione Authorization: Bearer
- Un limite di richieste al minuto per ogni coppia app–utente; superandolo si riceve la risposta 429
Server MCP
Un assistente IA si collega a un account WŬMÙ tramite un URL: senza chiavi, senza app sviluppatore e senza installare nulla.
- Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT in modalità sviluppatore, Cursor e altri client che supportano server MCP remoti con accesso OAuth
- Accedi con il tuo account e scegli tu le sezioni; lettura e modifica sono interruttori separati
- Le sezioni con dati di altre persone — richieste, messenger, contatti — sono disattivate per impostazione predefinita
- Puoi scollegare l’assistente in qualsiasi momento nelle impostazioni di sicurezza del tuo account
URL di connessione
https://wumu.ai/mcpPer un account su wumu.aihttps://wumu.ru/mcpPer un account su wumu.ru (Russia)
Richiesta di esempio
La tua prima richiesta
Ottieni un token di accesso tramite OAuth e passalo nell’intestazione: la prima richiesta restituisce le tue cinque chat più recenti con l’avvocato IA e richiede l’autorizzazione read:chats. Il secondo comando aggiunge il server MCP di WŬMÙ a Claude Code.
# le tue cinque chat più recenti con l’avvocato IA
curl "https://wumu.ai/api/v2/threads?agent=lawyer&limit=5" \
-H "Authorization: Bearer $TOKEN"# aggiungere il server MCP di WŬMÙ a Claude Code
claude mcp add --transport http wumu https://wumu.ai/mcpDomande degli sviluppatori
Serve un piano a pagamento per usare l’API di WŬMÙ?
Per le app OAuth e la REST API v2 non serve un piano a pagamento: puoi creare un’app con qualsiasi piano WŬMÙ, anche quello gratuito. Puoi collegare un assistente IA al server MCP di WŬMÙ anche con il piano gratuito, con accesso al tuo profilo, alle bozze in città e al centro assistenza; per le altre sezioni serve un tuo piano Pro o superiore, e va bene anche una prova di Business.
Come ottengo una chiave API di WŬMÙ?
Accedi a WŬMÙ e apri la console sviluppatori. Crea un’app con nome, URL di reindirizzamento e autorizzazioni. Ricevi un client_id e, per un’app lato server, anche un client_secret: viene mostrato una sola volta, conservalo. L’app inizia a emettere token dopo la verifica di un amministratore WŬMÙ.
Dove trovo la descrizione della REST API di WŬMÙ?
La descrizione OpenAPI della REST API v2 è accessibile senza login all’indirizzo /api/v2/openapi.json: caricala in qualsiasi strumento che supporti OpenAPI o genera un client a partire da essa. I metadati del server di autorizzazione WŬMÙ sono su /.well-known/openid-configuration.
Apri la descrizione OpenAPIL’API di WŬMÙ limita il numero di richieste?
Sì. La REST API v2 limita ogni coppia app–utente: 100 richieste al minuto per impostazione predefinita, e alcune sezioni, come il messenger, hanno un limite proprio. Superato il limite, il server risponde con lo stato 429: ripeti la richiesta più tardi. Anche un assistente IA collegato via MCP ha un limite di richieste al minuto.
In cosa il server MCP di WŬMÙ differisce da un’app OAuth?
Il server MCP di WŬMÙ è una connessione pronta per gli assistenti IA: non c’è nulla da registrare, basta incollare l’URL e accedere con il tuo account. Un’app OAuth serve quando sviluppi una tua integrazione: un sito, un servizio o un’app mobile che chiama la REST API v2 per conto degli utenti.