개발자
WŬMÙ를 내 시스템에 연결하세요
WŬMÙ는 세 가지 방식으로 연동할 수 있습니다. 앱은 PKCE를 사용하는 OAuth 2.0으로 로그인하고 OpenAPI 명세가 있는 REST API v2로 데이터를 다루며, AI 어시스턴트는 URL로 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로 연결합니다. AI 어시스턴트는 앱 등록 없이 MCP 서버로 연결합니다.
PKCE를 지원하는 OAuth 2.0
WŬMÙ 사용자의 동의를 받아 그 데이터를 다루는 웹사이트, 서비스, 모바일 앱을 위한 방식입니다.
- PKCE(S256) 인가 코드와 리프레시 토큰 순환, 서버 간 호출에는 client_credentials
- 사용자는 동의 화면에서 필요한 권한만 허용합니다: 프로필, 문서, 채팅, 연락처 등
- 공개 클라이언트(모바일 앱, SPA)에는 시크릿을 발급하지 않습니다
- HMAC-SHA256으로 서명된 웹훅과 개발자 콘솔의 요청·전송 로그
- 새 앱은 WŬMÙ 관리자의 검토를 거친 뒤 사용할 수 있습니다
REST API v2
문서, 스프레드시트, AI 채팅, 메신저, 연락처, 캘린더 등 WŬMÙ의 여러 영역을 다루는 JSON API입니다.
- 각 작업에 필요한 권한이 명시된 기계 판독형 OpenAPI 명세
- 액세스 토큰은 Authorization: Bearer 헤더로 전달합니다
- 앱과 사용자 쌍마다 분당 요청 한도가 있으며, 초과하면 429가 반환됩니다
MCP 서버
AI 어시스턴트는 URL만으로 WŬMÙ 계정에 연결됩니다. 키도, 개발자 앱도, 설치도 필요 없습니다.
- Claude(claude.ai, Claude Desktop, Claude Code), 개발자 모드의 ChatGPT, Cursor 및 원격 MCP 서버와 OAuth 로그인을 지원하는 기타 클라이언트
- 본인 계정으로 로그인하고 허용할 영역을 직접 고릅니다. 읽기와 변경은 별도의 스위치입니다
- 다른 사람의 데이터가 담긴 영역(문의, 메신저, 연락처)은 기본적으로 꺼져 있습니다
- 계정 보안 설정에서 언제든지 어시스턴트 연결을 해제할 수 있습니다
연결 URL
https://wumu.ai/mcpwumu.ai 계정용https://wumu.ru/mcpwumu.ru 계정용(러시아)
요청 예시
첫 번째 요청
OAuth로 액세스 토큰을 받아 헤더에 담아 보내세요. 첫 번째 요청은 AI 변호사와 나눈 최근 채팅 5개를 반환하며 read:chats 권한이 필요합니다. 두 번째 명령은 WŬMÙ MCP 서버를 Claude Code에 추가합니다.
# AI 변호사와 나눈 최근 채팅 5개
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개발자 질문
WŬMÙ API를 쓰려면 유료 요금제가 필요한가요?
OAuth 앱과 REST API v2에는 유료 요금제가 필요 없습니다. 무료 요금제를 포함한 모든 WŬMÙ 요금제에서 앱을 만들 수 있습니다. 무료 요금제에서도 AI 어시스턴트를 WŬMÙ MCP 서버에 연결해 프로필, 도시 초안, 도움말 센터에 접근하게 할 수 있습니다. 그 밖의 섹션에는 본인의 Pro 이상 요금제가 필요하며, Business 체험 기간도 해당됩니다.
WŬMÙ API 키는 어떻게 받나요?
WŬMÙ에 로그인해 개발자 콘솔을 열고 이름, 리디렉션 URL, 권한을 지정해 앱을 만드세요. client_id가 발급되며, 서버 측 앱에는 client_secret도 발급됩니다. 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로 연결한 AI 어시스턴트에도 분당 요청 한도가 있습니다.
WŬMÙ MCP 서버와 OAuth 앱은 무엇이 다른가요?
WŬMÙ MCP 서버는 AI 어시스턴트를 위한 기성 연결입니다. 등록할 것 없이 URL을 붙여 넣고 본인 계정으로 로그인하면 됩니다. OAuth 앱은 사용자를 대신해 REST API v2를 호출하는 웹사이트, 서비스, 모바일 앱처럼 직접 연동을 만들 때 필요합니다.