開発者向け

WŬMÙ を自社のシステムに接続

WŬMÙ は 3 つの方法で連携できます。アプリは 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

3 つの接続方法

接続方法を選ぶ

自社のアプリやサービスは OAuth と REST API で接続します。AI アシスタントはアプリを登録せずに MCP サーバーで接続します。

  • PKCE 対応 OAuth 2.0

    WŬMÙ ユーザーの同意を得て、そのデータを扱うウェブサイト、サービス、モバイルアプリ向け。

    • PKCE(S256)付きの認可コードとリフレッシュトークンのローテーション。サーバー間通信には client_credentials
    • ユーザーは同意画面で必要なスコープだけを許可します:プロフィール、ドキュメント、チャット、連絡先など
    • パブリッククライアント(モバイルアプリや SPA)にはシークレットを発行しません
    • HMAC-SHA256 署名付きの Webhook と、開発者コンソールでのリクエスト・配信ログ
    • 新しいアプリは WŬMÙ 管理者の審査後に利用可能になります
  • REST API v2

    ドキュメント、スプレッドシート、AI チャット、メッセンジャー、連絡先、カレンダーなど WŬMÙ の各機能にアクセスできる JSON API。

    • 各操作に必要なスコープを明記した機械可読の OpenAPI 記述
    • アクセストークンは Authorization: Bearer ヘッダーで送信します
    • アプリとユーザーの組ごとに 1 分あたりのリクエスト上限があり、超えると 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 スコープが必要です。2 つ目のコマンドは 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 はアプリとユーザーの組ごとに制限があり、既定では 1 分あたり 100 リクエストです。メッセンジャーなど一部の機能には独自の上限があります。超えるとサーバーはステータス 429 を返すので、時間をおいて再試行してください。MCP で接続した AI アシスタントにも 1 分あたりのリクエスト上限があります。

WŬMÙ の MCP サーバーと OAuth アプリの違いは?

WŬMÙ の MCP サーバーは AI アシスタント向けの既製の接続です。登録は不要で、URL を貼り付けて自分のアカウントでサインインするだけです。OAuth アプリは、ユーザーに代わって REST API v2 を呼び出すウェブサイト、サービス、モバイルアプリなど、独自の連携を作るときに必要です。

連携を始める

WŬMÙ にログインし、開発者コンソールでアプリを作成してキーを取得しましょう。