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.ai
    • https://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/mcp
Tutte le operazioni sono nella descrizione OpenAPI

Domande 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 OpenAPI
L’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.

Inizia la tua integrazione

Accedi a WŬMÙ, crea un’app nella console sviluppatori e ottieni la tua chiave.