Әзірлеушілерге

WŬMÙ-ді өз жүйелеріңізге қосыңыз

WŬMÙ интеграцияларға үш жолмен ашық: қолданбалар PKCE бар OAuth 2.0 арқылы кіреді және OpenAPI сипаттамасы бар REST API v2 арқылы деректермен жұмыс істейді, ал ЖИ көмекшілері MCP серверіне сілтеме арқылы қосылады.

Кілт әзірлеуші кабинетінде беріледі: WŬMÙ-ге кіріп, қолданба жасаңыз да client_id алыңыз.

https://wumu.ai

Авторизация
/api/oauth/authorize
Токендер
/api/oauth/token
REST API v2
/api/v2
OpenAPI
/api/v2/openapi.json
MCP сервері
/mcp

Қосылудың үш жолы

Қалай қосылатыныңызды таңдаңыз

Өз қолданбаңыз немесе сервисіңіз OAuth және REST API арқылы қосылады. ЖИ көмекшісі — қолданбаны тіркемей, MCP сервері арқылы.

  • PKCE бар OAuth 2.0

    WŬMÙ пайдаланушысының деректерімен оның келісімімен жұмыс істейтін сайттар, сервистер мен мобильді қолданбалар үшін.

    • PKCE (S256) бар авторизация коды және жаңарту токендерінің ротациясы; сервер мен сервер арасындағы байланыс үшін — client_credentials
    • Пайдаланушы келісім экранын көріп, тек қажетті рұқсаттарды береді: профиль, құжаттар, чаттар, контактілер және басқалар
    • Ашық клиенттерге — мобильді қолданбалар мен SPA-ға — құпия кілт берілмейді
    • HMAC-SHA256 қолтаңбасы бар вебхуктар және әзірлеуші кабинетіндегі сұраулар мен жеткізулер журналы
    • Жаңа қолданба WŬMÙ әкімшісі тексергеннен кейін жұмыс істей бастайды
  • REST API v2

    Құжаттарға, кестелерге, ЖИ чаттарына, мессенджерге, контактілерге, күнтізбеге және WŬMÙ-дің басқа бөлімдеріне арналған JSON API.

    • Машина оқитын OpenAPI сипаттамасы: әр операцияға қажетті рұқсаттар көрсетілген
    • Қатынас токені Authorization: Bearer тақырыбында беріледі
    • Әр «қолданба — пайдаланушы» жұбы үшін минутына сұраулар шегі; асып кетсе — 429 жауабы
  • MCP сервері

    ЖИ көмекшісі WŬMÙ аккаунтына сілтеме арқылы қосылады — кілтсіз, әзірлеуші қолданбасынсыз және бағдарлама орнатпай.

    • Claude (claude.ai, Claude Desktop, Claude Code), әзірлеуші режиміндегі ChatGPT, Cursor және қашықтағы MCP серверлері мен OAuth арқылы кіруді қолдайтын басқа клиенттер
    • Сіз өз аккаунтыңызбен кіріп, бөлімдерді өзіңіз қосасыз; оқу мен өзгерту — бөлек ауыстырғыштар
    • Басқа адамдардың деректері бар бөлімдер — өтінімдер, мессенджер, контактілер — әдепкі бойынша өшірулі
    • Көмекшіні кез келген уақытта аккаунттың қауіпсіздік параметрлерінде ажыратуға болады

    Қосылу мекенжайы

    • https://wumu.ai/mcpwumu.ai аккаунты үшін
    • https://wumu.ru/mcpwumu.ru аккаунты үшін (Ресей)

Сұрау мысалы

Алғашқы сұрау

OAuth арқылы қатынас токенін алып, оны тақырыпта беріңіз: бірінші сұрау ЖИ заңгерімен соңғы бес чатыңызды қайтарады, ол үшін read:chats рұқсаты керек. Екінші команда WŬMÙ MCP серверін Claude Code-қа қосады.

# ЖИ заңгерімен соңғы бес чат
curl "https://wumu.ai/api/v2/threads?agent=lawyer&limit=5" \
  -H "Authorization: Bearer $TOKEN"
# WŬMÙ MCP серверін Claude Code-қа қосу
claude mcp add --transport http wumu https://wumu.ai/mcp
Барлық операциялар — OpenAPI сипаттамасында

Әзірлеушілер сұрақтары

WŬMÙ API-мен жұмыс істеу үшін ақылы тариф керек пе?

OAuth қолданбалары мен REST API v2 үшін ақылы тариф қажет емес: қолданбаны WŬMÙ-дің кез келген тарифінде, соның ішінде тегін тарифте де жасауға болады. ЖИ көмекшісін WŬMÙ MCP серверіне тегін тарифте де қосуға болады — профиліңізге, қаладағы жобаларыңызға және анықтама орталығына қолжетімділікпен; қалған бөлімдер үшін өзіңіздің Pro немесе одан жоғары тарифіңіз керек, Business сынақ кезеңі де жарайды.

WŬMÙ API кілтін қалай аламын?

WŬMÙ-ге кіріп, әзірлеуші кабинетін ашыңыз. Қолданба жасаңыз: атауы, қайтару мекенжайлары және рұқсаттар. Сіз client_id аласыз, ал сервер қолданбасы client_secret те алады — ол бір рет қана көрсетіледі, сақтап қойыңыз. Қолданба WŬMÙ әкімшісі тексергеннен кейін токендер бере бастайды.

WŬMÙ REST API сипаттамасын қайдан табамын?

REST API v2-нің OpenAPI форматындағы сипаттамасы кірусіз /api/v2/openapi.json мекенжайында ашық: оны OpenAPI-ді түсінетін кез келген құралға жүктеуге немесе ол бойынша клиент жасауға болады. WŬMÙ авторизация серверінің параметрлері — /.well-known/openid-configuration мекенжайында.

OpenAPI сипаттамасын ашу
WŬMÙ API-де сұраулар санына шектеу бар ма?

Иә. REST API v2 әр «қолданба — пайдаланушы» жұбын шектейді: әдепкі бойынша минутына 100 сұрау, кейбір бөлімдерде, мысалы мессенджерде, өз шегі бар. Асып кетсе, сервер 429 мәртебесімен жауап береді — сұрауды кейінірек қайталаңыз. MCP арқылы қосылған ЖИ көмекшісінде де минуттық сұраулар шегі бар.

WŬMÙ MCP серверінің OAuth қолданбасынан айырмашылығы неде?

WŬMÙ MCP сервері — ЖИ көмекшілеріне арналған дайын қосылым: ештеңе тіркеудің қажеті жоқ, мекенжайды қойып, өз аккаунтыңызбен кіру жеткілікті. OAuth қолданбасы өз интеграцияңызды жазғанда керек — пайдаланушылар атынан REST API v2-ге жүгінетін сайт, сервис немесе мобильді қолданба.

Интеграцияны бастаңыз

WŬMÙ-ге кіріп, әзірлеуші кабинетінде қолданба жасаңыз және кілт алыңыз.