Desenvolvedores
Conecte o WŬMÙ aos seus sistemas
O WŬMÙ está aberto a integrações de três formas: apps entram com OAuth 2.0 e PKCE e trabalham com os dados pela REST API v2 com descrição OpenAPI, e assistentes de IA se conectam ao servidor MCP por uma URL.
As chaves são emitidas no console do desenvolvedor: entre no WŬMÙ, crie um app e receba seu client_id.
https://wumu.ai
- Autorização
- /api/oauth/authorize
- Tokens
- /api/oauth/token
- REST API v2
- /api/v2
- OpenAPI
- /api/v2/openapi.json
- Servidor MCP
- /mcp
Três formas de conectar
Escolha como conectar
Seu app ou serviço se conecta via OAuth e a REST API. Um assistente de IA se conecta pelo servidor MCP, sem registrar nenhum app.
OAuth 2.0 com PKCE
Para sites, serviços e apps móveis que trabalham com os dados de um usuário do WŬMÙ com o consentimento dele.
- Código de autorização com PKCE (S256) e rotação de tokens de atualização; client_credentials para chamadas entre servidores
- O usuário vê uma tela de consentimento e concede apenas as permissões necessárias: perfil, documentos, chats, contatos e mais
- Clientes públicos — apps móveis e SPAs — não recebem segredo
- Webhooks assinados com HMAC-SHA256 e registro de requisições e entregas no console do desenvolvedor
- Um app novo começa a funcionar após a revisão de um administrador do WŬMÙ
REST API v2
Uma API JSON para documentos, planilhas, chats de IA, o mensageiro, contatos, a agenda e outras seções do WŬMÙ.
- Descrição OpenAPI legível por máquina, que indica as permissões exigidas por cada operação
- O token de acesso vai no cabeçalho Authorization: Bearer
- Um limite de requisições por minuto para cada par app–usuário; ao ultrapassá-lo, a resposta é 429
Servidor MCP
Um assistente de IA se conecta a uma conta do WŬMÙ por uma URL: sem chaves, sem app de desenvolvedor e sem instalar nada.
- Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT no modo desenvolvedor, Cursor e outros clientes compatíveis com servidores MCP remotos e login via OAuth
- Você entra com a sua própria conta e escolhe as seções; leitura e alteração são chaves separadas
- Seções com dados de outras pessoas — solicitações, mensageiro, contatos — vêm desativadas por padrão
- Você pode desconectar o assistente a qualquer momento nas configurações de segurança da sua conta
URL de conexão
https://wumu.ai/mcpPara uma conta em wumu.aihttps://wumu.ru/mcpPara uma conta em wumu.ru (Rússia)
Exemplo de requisição
Sua primeira requisição
Obtenha um token de acesso via OAuth e envie-o no cabeçalho: a primeira requisição retorna seus cinco chats mais recentes com o advogado de IA e precisa da permissão read:chats. O segundo comando adiciona o servidor MCP do WŬMÙ ao Claude Code.
# seus cinco chats mais recentes com o advogado de IA
curl "https://wumu.ai/api/v2/threads?agent=lawyer&limit=5" \
-H "Authorization: Bearer $TOKEN"# adicionar o servidor MCP do WŬMÙ ao Claude Code
claude mcp add --transport http wumu https://wumu.ai/mcpPerguntas de desenvolvedores
Preciso de um plano pago para usar a API do WŬMÙ?
Apps OAuth e a REST API v2 não exigem plano pago: é possível criar um app em qualquer plano do WŬMÙ, inclusive o gratuito. Também é possível conectar um assistente de IA ao servidor MCP do WŬMÙ no plano gratuito, com acesso ao seu perfil, aos seus rascunhos na cidade e à central de ajuda; as demais seções exigem seu próprio plano Pro ou superior, e um teste do Business também vale.
Como obtenho uma chave da API do WŬMÙ?
Entre no WŬMÙ e abra o console do desenvolvedor. Crie um app com nome, URLs de redirecionamento e permissões. Você recebe um client_id e, em um app de servidor, também um client_secret — ele é exibido só uma vez, guarde-o. O app passa a emitir tokens depois da revisão de um administrador do WŬMÙ.
Onde fica a descrição da REST API do WŬMÙ?
A descrição OpenAPI da REST API v2 está aberta, sem login, em /api/v2/openapi.json: carregue-a em qualquer ferramenta que entenda OpenAPI ou gere um cliente a partir dela. Os metadados do servidor de autorização do WŬMÙ estão em /.well-known/openid-configuration.
Abrir a descrição OpenAPIA API do WŬMÙ limita o número de requisições?
Sim. A REST API v2 limita cada par app–usuário: 100 requisições por minuto por padrão, e algumas seções, como o mensageiro, têm limite próprio. Ao ultrapassá-lo, o servidor responde com o status 429 — repita a requisição mais tarde. Um assistente de IA conectado via MCP também tem um limite de requisições por minuto.
Qual a diferença entre o servidor MCP do WŬMÙ e um app OAuth?
O servidor MCP do WŬMÙ é uma conexão pronta para assistentes de IA: não há nada a registrar, basta colar a URL e entrar com a sua conta. Um app OAuth é o que você precisa ao criar sua própria integração: um site, serviço ou app móvel que chama a REST API v2 em nome dos usuários.