개발자

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
모든 작업은 OpenAPI 명세에 있습니다

개발자 질문

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를 호출하는 웹사이트, 서비스, 모바일 앱처럼 직접 연동을 만들 때 필요합니다.

연동을 시작하세요

WŬMÙ에 로그인하고 개발자 콘솔에서 앱을 만들어 키를 받으세요.