提供ツール一覧

SendWOW MCP サーバーが提供する全ツールの一覧です。各ツールは内部的に SendWOW External API を呼び出します。

セッション管理

ツール	説明	必要 scope
`sendwow_whoami`	現在のユーザー情報を取得	`users:read`
`sendwow_list_teams`	利用可能なチーム一覧を取得	`teams:read`
`sendwow_switch_team`	アクティブチームを切り替え	`teams:read` + `users:write`

オーダー管理

ツール	説明	必要 scope
`sendwow_list_orders`	オーダー一覧取得 (フィルタ対応)	`orders:read`
`sendwow_get_order`	オーダー詳細取得	`orders:read`
`sendwow_get_fastest_delivery_date`	最短配送可能日を取得	`orders:read`
`sendwow_get_holidays`	営業日カレンダー取得	`orders:read`
`sendwow_create_order`	コンタクト埋め込みでオーダー作成	`orders:write`

連絡先

ツール	説明	必要 scope
`sendwow_list_contacts`	連絡先一覧取得	`contacts:read`
`sendwow_get_contact`	連絡先詳細取得	`contacts:read`

タッチ (商品)

ツール	説明	必要 scope
`sendwow_list_touches`	タッチ一覧取得	`touches:read`
`sendwow_get_touch`	タッチ詳細取得	`touches:read`
`sendwow_create_touch`	商品 (variant) を選んでタッチを作成	`touches:write`

商品

ツール	説明	必要 scope
`sendwow_list_products`	タッチとして送付できる商品一覧を取得 (`sendwow_create_touch` の `variant_id` はここで確認)	`products:read`

キャンペーン

ツール	説明	必要 scope
`sendwow_list_campaigns`	キャンペーン一覧取得	`campaigns:read`

ツール	説明	必要 scope
`sendwow_add_order_comment`	オーダーにコメント追加	`comments:write`
`sendwow_list_order_comments`	オーダーのコメント一覧取得	`comments:read`

オーダー作成 (コンタクト埋め込み)

sendwow_create_order はコンタクト情報を直接指定し、その内容で新しいコンタクトが作成されます (既存コンタクトとの自動マッチングは行われません。既存コンタクトを指定する場合は REST External API の contact.id を使用してください)。

sendwow_create_order(
    contact={
        "last_name": "山田",
        "first_name": "太郎",
        "shipping_addresses": [{
            "postcode": "1000001",
            "pref": "東京都",
            "city": "千代田区",
            "street1": "丸の内1-1-1"
        }],
        "account": {"name": "株式会社サンプル"},
    },
    touch_ids=["<touch-uuid>"],
    shipping_date="2026-05-01"
)

詳細はオーダー作成ガイドを参照してください。

セキュリティ仕様

OAuth 2.0 + PKCE: DCR によるクライアント自動登録、認可コードフロー
レート制限: DCR 20/hour、introspection 120/min
fail-closed scope check: access token なしでツール実行を拒否
操作別 scope: 汎用 write はなく、orders:write / comments:write / users:write / touches:write に分かれる。write 系は対応する read scope を自動内包する (認証ガイドの scope 一覧)
トークン漏洩防止: エラーメッセージから自動マスク
コンタクトフィールドサニタイズ: allowlist で不正フィールドを除去

詳細は認証ガイドと API リファレンスを参照してください。