Desarrolladores

Conecta WŬMÙ a tus sistemas

WŬMÙ está abierto a integraciones de tres formas: las apps inician sesión con OAuth 2.0 y PKCE y trabajan con los datos a través de la REST API v2 con descripción OpenAPI, y los asistentes de IA se conectan al servidor MCP mediante una URL.

Las claves se emiten en la consola de desarrolladores: inicia sesión en WŬMÙ, crea una app y obtén tu client_id.

https://wumu.ai

Autorización
/api/oauth/authorize
Tokens
/api/oauth/token
REST API v2
/api/v2
OpenAPI
/api/v2/openapi.json
Servidor MCP
/mcp

Tres formas de conectarse

Elige cómo conectarte

Tu propia app o servicio se conecta mediante OAuth y la REST API. Un asistente de IA se conecta mediante el servidor MCP, sin registrar ninguna app.

  • OAuth 2.0 con PKCE

    Para sitios web, servicios y apps móviles que trabajan con los datos de un usuario de WŬMÙ con su consentimiento.

    • Código de autorización con PKCE (S256) y rotación de tokens de actualización; client_credentials para llamadas entre servidores
    • El usuario ve una pantalla de consentimiento y concede solo los permisos necesarios: perfil, documentos, chats, contactos y más
    • Los clientes públicos — apps móviles y SPA — no reciben secreto
    • Webhooks firmados con HMAC-SHA256 y un registro de solicitudes y entregas en la consola de desarrolladores
    • Una app nueva empieza a funcionar tras la revisión de un administrador de WŬMÙ
  • REST API v2

    Una API JSON para documentos, hojas de cálculo, chats de IA, el mensajero, contactos, el calendario y otras secciones de WŬMÙ.

    • Descripción OpenAPI legible por máquina que indica los permisos que necesita cada operación
    • El token de acceso se envía en el encabezado Authorization: Bearer
    • Un límite de solicitudes por minuto para cada par de app y usuario; al superarlo, la respuesta es 429
  • Servidor MCP

    Un asistente de IA se conecta a una cuenta de WŬMÙ mediante una URL: sin claves, sin app de desarrollador y sin instalar nada.

    • Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT en modo desarrollador, Cursor y otros clientes compatibles con servidores MCP remotos e inicio de sesión OAuth
    • Inicias sesión con tu propia cuenta y eliges tú las secciones; leer y modificar son interruptores separados
    • Las secciones con datos de otras personas — solicitudes, mensajero, contactos — están desactivadas por defecto
    • Puedes desconectar el asistente en cualquier momento en la configuración de seguridad de tu cuenta

    URL de conexión

    • https://wumu.ai/mcpPara una cuenta en wumu.ai
    • https://wumu.ru/mcpPara una cuenta en wumu.ru (Rusia)

Solicitud de ejemplo

Tu primera solicitud

Obtén un token de acceso mediante OAuth y envíalo en el encabezado: la primera solicitud devuelve tus cinco chats más recientes con el abogado de IA y necesita el permiso read:chats. El segundo comando añade el servidor MCP de WŬMÙ a Claude Code.

# tus cinco chats más recientes con el abogado de IA
curl "https://wumu.ai/api/v2/threads?agent=lawyer&limit=5" \
  -H "Authorization: Bearer $TOKEN"
# añadir el servidor MCP de WŬMÙ a Claude Code
claude mcp add --transport http wumu https://wumu.ai/mcp
Todas las operaciones están en la descripción OpenAPI

Preguntas de desarrolladores

¿Necesito un plan de pago para usar la API de WŬMÙ?

Las apps OAuth y la REST API v2 no requieren plan de pago: puedes crear una app con cualquier plan de WŬMÙ, incluido el gratuito. También puedes conectar un asistente de IA al servidor MCP de WŬMÙ con el plan gratuito, con acceso a tu perfil, a tus borradores de la ciudad y al centro de ayuda; para las demás secciones necesitas tu propio plan Pro o superior, y una prueba de Business también sirve.

¿Cómo obtengo una clave de la API de WŬMÙ?

Inicia sesión en WŬMÙ y abre la consola de desarrolladores. Crea una app con nombre, URL de redirección y permisos. Recibirás un client_id y, si la app es de servidor, también un client_secret: solo se muestra una vez, guárdalo. La app empieza a emitir tokens cuando un administrador de WŬMÙ la revisa.

¿Dónde está la descripción de la REST API de WŬMÙ?

La descripción OpenAPI de la REST API v2 está abierta sin iniciar sesión en /api/v2/openapi.json: cárgala en cualquier herramienta que entienda OpenAPI o genera un cliente a partir de ella. Los metadatos del servidor de autorización de WŬMÙ están en /.well-known/openid-configuration.

Abrir la descripción OpenAPI
¿La API de WŬMÙ limita el número de solicitudes?

Sí. La REST API v2 limita cada par de app y usuario: 100 solicitudes por minuto por defecto, y algunas secciones, como el mensajero, tienen su propio límite. Si se supera, el servidor responde con el estado 429: repite la solicitud más tarde. Un asistente de IA conectado por MCP también tiene un límite de solicitudes por minuto.

¿En qué se diferencia el servidor MCP de WŬMÙ de una app OAuth?

El servidor MCP de WŬMÙ es una conexión lista para asistentes de IA: no hay que registrar nada, basta con pegar la URL e iniciar sesión con tu cuenta. Una app OAuth es lo que necesitas cuando creas tu propia integración: un sitio web, un servicio o una app móvil que llama a la REST API v2 en nombre de los usuarios.

Empieza tu integración

Inicia sesión en WŬMÙ, crea una app en la consola de desarrolladores y obtén tu clave.