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.ai
    • https://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/mcp
Todas as operações estão na descrição OpenAPI

Perguntas 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 OpenAPI
A 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.

Comece sua integração

Entre no WŬMÙ, crie um app no console do desenvolvedor e obtenha sua chave.