MCPサーバー

概要

ホストされたWink MCPサーバーは以下で利用可能です：

https://docs.mcp.wink.travel/mcp

対応するAIクライアント（VS Code、Cursor、その他MCP HTTPトランスポートを実装しているもの）をこのエンドポイントに向けて、以下を可能にします：

主なストリーミング可能なHTTPエンドポイントを使用してください：

https://docs.mcp.wink.travel/mcp

クライアントがSSEのみをサポートしている場合は、以下を使用してください：

https://docs.mcp.wink.travel/sse

AnthropicはクラウドホストされたMCPサーバーに対してリモートHTTPトランスポートを推奨しています：

claude mcp add --transport http wink-docs https://docs.mcp.wink.travel/mcp
claude mcp list

Claude Code内で/mcpを実行してサーバーステータスを確認します。リポジトリ全体でサーバーを共有したい場合は、--scope projectを追加してClaude Codeが設定を.mcp.jsonに書き込むようにします。

OpenAIはCodex CLIを通じたMCP設定を文書化しており、設定はIDE拡張機能と共有されることを記載しています：

codex mcp add wink-docs --url https://docs.mcp.wink.travel/mcp
codex mcp list

Cursor MCPドキュメント: https://cursor.com/docs/context/mcp セットアップ: MCP設定でリモートサーバーを追加します。

{
  "mcpServers": {
    "wink-docs": {
      "url": "https://docs.mcp.wink.travel/mcp",
    }
  }
}

公式ドキュメント: https://code.visualstudio.com/docs/copilot/customization/mcp-servers 最小限のリモート設定（ユーザーまたはワークスペースのmcp.json）：

{
  "servers": {
    "wink-docs": {
      "type": "http",
      "url": "https://docs.mcp.wink.travel/mcp"
    }
  }
}

ヒント：

URI	説明
`wink://docs`	ドキュメントインデックス（カテゴリ別にグループ化）
`wink://docs/{path}`	特定のドキュメント記事（Markdown / MDX）
`wink://api`	Winkのswagger設定から検出されたライブOpenAPIカタログ
`wink://api/{apiName}`	認証、タグ、ヘッダー、サンプル操作を含むコンパクトなAPI概要
`wink://api/{apiName}/operations`	タグ別にグループ化された完全な操作一覧
`wink://api/{apiName}/operation/{key}`	個別操作の詳細（パラメータ、リクエストボディ、レスポンス）
`wink://api/{apiName}/schema/{schemaName}`	ネストされたフィールド、型、例を含む解決済みコンポーネントスキーマ
`wink://api/{apiName}/operation/{key}/request`	必須入力と最小限の例ペイロードを含むリクエスト中心のビュー
`wink://api/{apiName}/operation/{key}/response/{status}`	特定のステータスコードに対するレスポンス中心のビュー
`wink://api/{apiName}/operation/{key}/recipe`	その操作を正しく呼び出すためのタスク指向フロー

ツール	目的	典型的なクエリ例
`api_search`	統合対象のライブAPIまたは操作を見つける	`create affiliate`、`payment receipt`、`lookup inventory`、`invite manager`
`docs_search`	概念的なドキュメント／ガイドを見つける	`authentication`、`webhooks`、`wordPress`

queryを空にすると提案が表示されます。すべての結果には開けるMCP URIが含まれます。操作のヒットでは、api_searchは関連するリクエスト、レスポンス、スキーマ、レシピURIも返すため、エージェントは最も有用なサブリソースに直接ジャンプできます。

意図（例：「create affiliate」や「payment receipt」）でapi_searchを実行。
返されたwink://api/... URIを開くか、そのリンクされたrequest_uri、response_uris、request_schema_uris、response_schema_uris、recipe_uriフィールドをたどる。
補助的な概念（認証、webhooks、ワークフロー）にはdocs_searchを使用。

事前構築されたエージェントスキルは、このMCPサーバーを真実の情報源として使用します。スキルは、エージェントがエンドポイントを推測する代わりに、MCPサーバーから直接ライブ契約を読み取ってWink APIに対して構造化されたワークフローを提供します。

利用可能なスキルとインストール手順はAI Skillsをご覧ください。