MCPサーバー

WinkのMCPツールはツールセットとして公開されています — それぞれが1つのジョブに特化したエンドポイントです。AIクライアントは作業に合った1つか2つのエンドポイントに接続し、すべてに接続するわけではありません。

すべてのエンドポイントはインタラクティブなOAuth2ログイン（PKCE認可コードフロー）を使用します：AIエージェントがブラウザタブを開き、Winkアカウントでサインインするだけです。クライアントシークレットの管理は不要です。

claude mcp add wink-channel-manager https://integrations.wink.travel/mcp/channel-manager --transport http

claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

なぜツールが複数のエンドポイントに分かれているのか

Winkは約500のツールを公開しています。すべてを一度にエージェントに渡すことは技術的には可能ですが、良いアイデアではありません。

ツール定義はコンテキストを消費します。 MCPサーバーが広告するすべてのツールは、作業を始める前にモデルのコンテキストウィンドウに読み込まれます。説明や完全なパラメータスキーマとともにです。500個もあると、実際のタスクに必要な予算の大部分を消費してしまいます。

リストが増えるほど選択の質は下がります。 500個の似た名前のツールから選ぶエージェントは、40個から選ぶエージェントよりも悪い選択をします。チャネルマネージャーを統合する場合、約20個のツールが関連し、残りの480個はノイズとなり、正しいツールを見つけにくくします。

作業は本質的に分離可能です。 PMSから空室状況を同期する人とアフィリエイトのランディングページを管理する人はほとんどツールを共有しません。ジョブごとに分割することで、各接続は1つのジョブの語彙を持ちます。

エンドポイント一覧

2つのホストがツールセットを提供しています。ツール数は概算で、時間とともに増加します。

`https://api.wink.travel` — プラットフォーム

エンドポイント	ツール数	対応範囲
`/mcp/extranet/facilities`	約64	予約可能かつ現地の在庫：客室と部屋タイプ、スパ、レストラン、会議室、アクティビティ、アトラクション、場所、その他販売可能なアイテム
`/mcp/extranet/property`	約62	物件情報と商業条件：プロフィールとコンテンツ、アドオン、キャンセルポリシー、特典、告知
`/mcp/settings`	約60	アカウント管理：管理主体のプロフィールとブランディング、マネージャーと権限、カスタマイズ、Webhook、通知設定
`/mcp/studio/embeds`	約48	キュレーションされた在庫の公開：ウィジェット、グリッドとランキンググリッド、カード、地図、在庫やサプライヤーページへのディープリンク
`/mcp/extranet/rates`	約44	価格と空室状況：在庫の料金期間と割当、料金プラン、マスターレート、特別料金やプロモーション料金
`/mcp/extranet/operations`	約39	ライブ物件の運営：予約とそのライフサイクル、ゲストレビューと返信、カレンダーフィード、スケジュールタスク
`/mcp/extranet/distribution`	約37	在庫の販売先：販売チャネルと料金修正、アフィリエイトやサプライヤーの関係リクエスト、登録、リード獲得
`/mcp/studio/curation`	約35	マーチャンダイズ可能なコレクションの構築：静的・動的リスト、ランキングリスト、保存検索、物件集計
`/mcp/link-manager`	約28	シンジケートされたリンクコレクション、そのデザイン、カテゴリとタグ、短縮URL
`/mcp/reference`	約24	読み取り専用の参照データ：国、通貨と為替レート、言語、タイムゾーン、地理的検索、IPジオロケーション
`/mcp/analytics`	約18	予約と収益の分析：概要、折れ線グラフ、リーダーボード、アフィリエイトパフォーマンス、シェア指標
`/mcp/payment`	約18	財務業務：元帳、出金と手数料見積もり、予約資金の集計
`/mcp/booking-engine`	約17	旅行者向けのショッピングパス：検索と参照、ショッピングカートとチェックアウト、バケットリスト、キャンペーンカスタマイズ
`/mcp/social`	約17	連携されたソーシャルアカウント、投稿の公開とスケジューリング、投稿インサイトの閲覧
`/mcp/travel-agent`	約8	旅行者代理の予約代行とエージェントレポート

`https://integrations.wink.travel` — チャネルマネージャー統合

このホストは1つのジョブのために存在するため、エンドポイントは1つだけです。

エンドポイント	ツール数	対応範囲
`/mcp/channel-manager`	約9	チャネルマネージャー、PMS、CRS統合の接続と検証

これらは異なるジョブであり、異なる担当者が行い、エンドポイントも共有しません。

チャネルマネージャー、PMS、CRSベンダーはintegrations.wink.travel/mcp/channel-managerを通じて一度統合し、その後は物件、料金、空室状況、予約をその統合経由でやり取りします。この単一のエンドポイントが全体のインターフェースです。

自分で料金を手動で変更するホテル経営者はapi.wink.travelのエクストラネットツールセット（/mcp/extranet/ratesなど）を使用します。これらはチャネルマネージャー統合の一部ではなく、統合者が接続する理由はありません。

アカウント管理もapi.wink.travelの/mcp/settingsにあります。統合ホストには/mcp/settingsはありません。

すべてのエンドポイントにはpingツールもあり、実際の作業を依頼する前に接続が生きているか確認できます。

どのツールセットが必要ですか？

あなたが…	接続先
チャネルマネージャー、PMS、CRSを統合する場合	`integrations.wink.travel/mcp/channel-manager` — これだけで十分
物件のコンテンツを管理する場合	`/mcp/extranet/property` + `/mcp/extranet/facilities`
部屋や部屋タイプを管理する場合	`/mcp/extranet/facilities`
価格と空室状況を管理する場合	`/mcp/extranet/rates`
日々の予約を運営する場合	`/mcp/extranet/operations`
流通を拡大する場合	`/mcp/extranet/distribution` + `/mcp/analytics`
アフィリエイトページを構築する場合	`/mcp/studio/curation` + `/mcp/studio/embeds`
リンクインバイオページを運営する場合	`/mcp/link-manager` + `/mcp/social`
旅行者の代理で予約する場合	`/mcp/travel-agent`
資金の照合をする場合	`/mcp/payment`
予約体験を構築する場合	`/mcp/booking-engine` + `/mcp/reference`

まず1つから始めてください。できないことがあれば別のツールセットを追加しましょう — 各接続は独立しており、追加しても他に影響はありません。

認証の仕組み

Wink MCPサーバーはOAuth2認可コード＋PKCEフローを使用し、**動的クライアント登録（RFC 7591）**に対応しています。初回接続時の流れは以下の通りです：

AIクライアントはMCPエンドポイントの/.well-known/oauth-protected-resourceメタデータから認可サーバーを検出します。
クライアントは動的クライアント登録を行い、手動のアプリ設定は不要です。
クライアントはhttps://iam.wink.travelのブラウザタブを開きます。Winkアカウントでサインインし、同意画面で権限を承認します。
Winkはアカウントに紐づくアクセストークンを発行します。
AIクライアントはすべてのMCPリクエストにトークンを添付します。すべてのツール結果は管理主体にスコープされます。
トークンは3時間で期限切れになります。AIクライアントはバックグラウンドで静かに更新し、再度のプロンプトはありません。

すべてのツール呼び出しはあなたのIDのもとで実行され、ウェブポータルを保護するのと同じACLルールがAIエージェントにも適用されます。

AIクライアントの接続方法

Claude Codeが最新であることを確認してください：
ターミナルウィンドウ
```
npm install -g @anthropic-ai/claude-code
```
上記のディレクトリからツールセットを選び、追加します。例：価格と空室状況の場合：
ターミナルウィンドウ
```
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http
```
Claude Codeがサーバーに接続し、認可サーバーを検出してデフォルトブラウザを開きます。
Winkにサインインし、同意画面で権限を承認します。
Claude Codeが接続を確認します。/mcpと入力してサーバーが表示され、ツールが読み込まれていることを確認してください。

作業に必要なだけツールセットを追加してください — それぞれが独立したサーバーエントリで名前も別です：

claude mcp add wink-operations https://api.wink.travel/mcp/extranet/operations --transport http
claude mcp add wink-analytics  https://api.wink.travel/mcp/analytics           --transport http

サインインは1回だけです。最初のブラウザ承認後、Claude Codeは追加のWinkエンドポイントでもWinkセッションを再利用します。

Claude Desktopの設定ファイルを編集します：
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json

MCPサーバーエントリを追加します：

{
  "mcpServers": {
    "wink-extranet-rates": {
      "type": "http",
      "url": "https://api.wink.travel/mcp/extranet/rates"
    },
    "wink-extranet-operations": {
      "type": "http",
      "url": "https://api.wink.travel/mcp/extranet/operations"
    }
  }
}

完全に終了して再起動してください（メニューバーのQuitを使うこと。ウィンドウを閉じるだけでは不十分です）。
Claude Desktopは新しいサーバーごとにブラウザタブを開きます。Winkにサインインし、権限を承認してください。
下部ツールバーのプラグアイコンが両方のサーバーが接続済みであることを示します。

Codex CLIがインストールされていることを確認してください：
ターミナルウィンドウ
```
npm install -g @openai/codex
```
Codex設定ファイルを開くか作成します：
- macOS / Linux: ~/.codex/config.json
- Windows: %USERPROFILE%\.codex\config.json

Wink MCPサーバーエントリを追加します：

{
  "mcpServers": {
    "wink-extranet-rates": {
      "type": "http",
      "url": "https://api.wink.travel/mcp/extranet/rates"
    },
    "wink-extranet-operations": {
      "type": "http",
      "url": "https://api.wink.travel/mcp/extranet/operations"
    }
  }
}

Codexを起動します。初回使用時にhttps://iam.wink.travelのブラウザタブが開きます。
Winkにサインインし、権限を承認します。
Codexが接続を確認します。codexを実行し、利用可能なツールをリストアップしてWinkサーバーが有効か確認してください。

MCPサーバーのサポートは、Plus、Pro、Team、Enterpriseのサブスクライバー向けのChatGPTデスクトップアプリで利用可能です。

まだの場合はChatGPTデスクトップアプリをダウンロードしてインストールしてください。
アプリを開き、右上のプロフィールアイコンをクリックして設定を選択します。
Connectors（またはアプリバージョンによってはMCP Servers）に移動し、追加をクリックします。
上記のディレクトリからツールセットのURLを入力します。例：
```
https://api.wink.travel/mcp/extranet/rates
```
そして接続をクリックします。
ChatGPTがhttps://iam.wink.travelのブラウザタブを開きます。Winkにサインインし、権限を承認してください。
作業に必要な他のツールセットも同様に4〜5の手順を繰り返します。例：
```
https://api.wink.travel/mcp/extranet/operations
```
各ツールセットがConnectorsリストに表示されます。新しいチャットを開始するとWinkツールが自動的に利用可能です。

Cursor MCP設定ファイルを開くか作成します：
- macOS / Linux: ~/.cursor/mcp.json
- Windows: %USERPROFILE%\.cursor\mcp.json

Wink MCPサーバーエントリを追加します：

{
  "mcpServers": {
    "wink-extranet-rates": {
      "type": "http",
      "url": "https://api.wink.travel/mcp/extranet/rates"
    },
    "wink-extranet-operations": {
      "type": "http",
      "url": "https://api.wink.travel/mcp/extranet/operations"
    }
  }
}

Cursorを開き、設定 → Cursor設定 → MCPに移動し、両方のサーバーが緑のステータスで表示されていることを確認します。赤の場合は更新をクリックしてください。
Cursorがhttps://iam.wink.travelのブラウザタブを開きます。Winkにサインインし、権限を承認します。
チャットを開き（Ctrl+L / Cmd+L）、Cursorに利用可能なWinkツールをリストアップさせて接続を確認します。

Windsurf MCP設定ファイルを開くか作成します：
- macOS / Linux: ~/.codeium/windsurf/mcp_config.json
- Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

Wink MCPサーバーエントリを追加します：

{
  "mcpServers": {
    "wink-extranet-rates": {
      "type": "http",
      "url": "https://api.wink.travel/mcp/extranet/rates"
    },
    "wink-extranet-operations": {
      "type": "http",
      "url": "https://api.wink.travel/mcp/extranet/operations"
    }
  }
}

Windsurfを完全に再起動してください（ファイルメニューのQuitを使い、再度開く）。
設定 → MCPサーバーに移動し、両方のサーバーが接続済みであることを確認します。初回使用時にWindsurfはhttps://iam.wink.travelのブラウザタブを開きます。
Winkにサインインし、権限を承認します。認証後、設定パネルのサーバーが緑色になります。

ClineはVS Code拡張機能で、MCPサーバーマネージャーを内蔵しています。手動でJSONを編集する必要はありません。

VS Code MarketplaceからClineをインストールします：
- VS Codeを開き、Ctrl+Shift+X / Cmd+Shift+Xを押す
- Clineを検索し、インストールをクリック
アクティビティバー（左サイドバー）のClineアイコンをクリックしてClineパネルを開きます。
ClineツールバーのMCPサーバーアイコン（プラグアイコン）をクリックし、MCP設定を編集を選択します。

VS Codeがcline_mcp_settings.jsonを開きます。Winkのエントリを追加します：

{
  "mcpServers": {
    "wink-extranet-rates": {
      "type": "http",
      "url": "https://api.wink.travel/mcp/extranet/rates"
    },
    "wink-extranet-operations": {
      "type": "http",
      "url": "https://api.wink.travel/mcp/extranet/operations"
    }
  }
}

ファイルを保存します。Clineは自動的にリロードし、https://iam.wink.travelのブラウザタブを開きます。
Winkにサインインし、権限を承認します。MCPサーバーパネルに両方のサーバーがアクティブとして表示されます。

スコープ

同意画面でエージェントが要求している内容の内訳が表示されます。MCPクライアントはプラットフォームの他の部分と同じ権限語彙を使います — 詳細は認証ページのスコープリファレンスを参照してください。

MCP特有の点は2つあります：

mcp.read mcp.write mcp.removeスコープはMCPトランスポートを開くために追加で必要です。 mcp.*スコープを持つクライアントは任意のWink MCPエンドポイントにアクセスできますが、呼び出すツールはそれぞれのエンドポイントのセクションスコープ（例：booking.read）を依然として強制します。
AIクライアントは必要なスコープだけを要求します。 同意画面で個別の権限を拒否できます — 拒否されたスコープを必要とするツールは呼び出すとエラーを返します。

ツールセットはこれらを変更しません。 接続するエンドポイントがリストされるツールを決め、許可される内容は決めません。/mcp/paymentに接続しても新たな財務権限は付与されず、/mcp/referenceに接続してもツールが独自のスコープを強制するのを止めません。認可はツール呼び出しごとに、トークンとアカウントの権限から決まります。

トラブルシューティング

ブラウザタブが開かない

AIクライアントがまだインタラクティブなPKCEフローをサポートしていない可能性があります。最新版を使っているか確認してください：

Claude Code: npm install -g @anthropic-ai/claude-code
Codex CLI: npm install -g @openai/codex
Claude Desktop / ChatGPTデスクトップ: アプリ内のアップデーターで更新

サインイン後に401 Unauthorizedが出る

キャッシュされたトークンが古い可能性があります。サーバーを削除して再追加し、新しいサインインを促してください：

# Claude Code
claude mcp remove wink-rates
claude mcp add wink-rates https://api.wink.travel/mcp/extranet/rates --transport http

Claude DesktopやChatGPTでは設定からサーバーを削除し、アプリを再起動して再追加してください。

特定のツール呼び出しで403 Forbiddenが出る

ツールが同意画面で承認されなかったスコープや、アカウントにない権限を必要としています。サーバーを再接続すると同意画面が再表示され、権限を承認できます。失敗が続く場合は、ツールが必要とするアカウント権限が不足しています。ツールセットを変えても権限は付与されません。

必要なツールがリストにない

おそらくそのジョブをカバーしないツールセットに接続しています。エンドポイント一覧を確認し、該当するツールセットを追加してください。接続は独立しているため、追加しても他に影響はありません。どれにあるか分からない場合は、一時的にhttps://api.wink.travel/mcpに接続してツールを探し、どのツールセットにあるか調べてください。

ツールセットエンドポイントで404 Not Foundが出る

パスをよく確認してください。ネストされたツールセットは2つのセグメントがあります（例：/mcp/extranet/rates、/mcp/extranet-ratesではありません）、フラットなものは1つです（例：/mcp/link-manager）。認証されていないリクエストは/mcp以下のどのパスでも401を返すため、401だけではエンドポイントの存在は判断できません。

api.wink.travel/mcp/channel-managerに接続しても何も起きない

そのエンドポイントは存在しません。チャネルマネージャー統合はhttps://integrations.wink.travel/mcp/channel-managerのみで提供されています。物件の料金を手動で読み書きする必要がある場合は別のジョブで別のエンドポイントです — /mcp/extranet/ratesを参照してください。

サーバーは表示されるがツール呼び出しで「アカウントが見つかりません」と出る

管理主体のないWinkアカウントでサインインしています。必ずWink Portalでアカウントを設定してからMCPサーバーを使用してください。

セッション中にトークンが期限切れになる

トークンは3時間有効です。Claude CodeとClaude Desktopはトークンを静かに更新し、セッションを中断しません。長時間アイドル後に認証エラーが出たら、新しいメッセージを入力してください。クライアントが自動的に再認証します。

Codex CLIで「MCP server unreachable」と表示される

~/.codex/config.jsonが有効なJSON（末尾のカンマなし）で、"type": "http"が設定されているか確認してください。CodexはリモートサーバーにHTTPトランスポートを要求します。stdioトランスポートはローカルバイナリ用です。

ChatGPTの「Connectors」メニューがない

MCPサポートはChatGPTデスクトップアプリのバージョン1.2024.352以降かつPlus、Pro、Team、Enterpriseのサブスクリプションが必要です。アプリを更新し、設定→アカウントでプランを確認してください。

Cursorサーバーが赤表示 / 「接続失敗」

~/.cursor/mcp.jsonが有効なJSONで"type": "http"を含むか確認してください。次に設定 → Cursor設定 → MCPで更新をクリック。エラーが続く場合はCursorを完全に再起動してください。設定変更は再起動なしでは反映されないことがあります。

Windsurf MCPサーバーが設定に表示されない

Windsurfはmcp_config.jsonの変更を反映するのに完全な再起動が必要です（ウィンドウのリロードだけでは不十分）。ファイル → Quitで終了し、再起動してください。まだ表示されない場合はWindsurfのバージョンが1.4以上かHelp → About Windsurfで確認し、必要に応じてアップデートしてください。

Clineで「サーバーを追加」オプションが見えない

MCPサーバーマネージャーはClineのバージョン2.0以降が必要です。VS Codeの拡張機能パネルでClineを探し、更新があればクリックしてください。更新後、VS Codeをリロードしてください（Ctrl+Shift+P → 「Developer: Reload Window」）。

Winkポータルを開く GitHubのWink

MCPサーバー

なぜツールが複数のエンドポイントに分かれているのか

エンドポイント一覧

https://api.wink.travel — プラットフォーム

https://integrations.wink.travel — チャネルマネージャー統合

どのツールセットが必要ですか？

認証の仕組み

AIクライアントの接続方法

スコープ

トラブルシューティング

`https://api.wink.travel` — プラットフォーム

`https://integrations.wink.travel` — チャネルマネージャー統合