コンテンツにスキップ
SendWOW Docs

MCP とは

SendWOW MCP サーバーは、AI エージェントが SendWOW API を操作するための Model Context Protocol (MCP) インターフェースを提供するサーバーです。

ユースケース

Section titled “ユースケース”
  • Claude Desktop / Claude Code — AI アシスタントから SendWOW を操作 (オーダー作成、コンタクト検索、配送日確認など)
  • Salesforce Agentforce — Salesforce 顧客が Agentforce から SendWOW を操作
  • SendWOW 内部エージェント — フロントエンドに組み込む AI チャット機能

アーキテクチャ

Section titled “アーキテクチャ”
┌──────────────────────┐     ┌───────────────┐
│ Salesforce Agentforce│     │ Claude Desktop│
│   (MCP Client)       │     │ / Claude Code │
└──────────┬───────────┘     └──────┬────────┘
           │ MCP (Streamable HTTP)  │
           ▼                        ▼
┌──────────────────────────────────────────────────────────────────┐
│                    SendWOW MCP Server                            │
│  Streamable HTTP + OAuth 2.0 (DCR)                              │
├──────────────────────────────────────────────────────────────────┤
│  Django OAuth Authorization Server                               │
│  (register / authorize / login / token / introspect / revoke)    │
├──────────────────────────────────────────────────────────────────┤
│  Django External API  (Bearer 専用)                              │
│  /api/v1/external/* — orders / contacts / touches / campaigns    │
│                       / teams / users                            │
└──────────────────────────────────────────────────────────────────┘

MCP サーバーは内部で SendWOW External API を呼び出す薄いラッパーで、認証は同じ OAuth 2.0 + Dynamic Client Registration を使います。

認証モデル

Section titled “認証モデル”
  1. MCP クライアント (Claude Desktop 等) が MCP サーバー URL を指定するだけで クライアント自動登録 (DCR)
  2. ブラウザで SendWOW にログイン → 同意画面でアクセス範囲 (scope) を許可 → Bearer token 取得
  3. 既定チームが自動適用される (未設定・切替時は sendwow_list_teams / sendwow_switch_team)
  4. ツールを実行

詳細な認証フローは 認証ガイド を参照してください。

次のステップ

Section titled “次のステップ”