MCP 서버

개요

호스팅된 Wink MCP 서버는 다음에서 이용할 수 있습니다:

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

호환되는 AI 클라이언트(VS Code, Cursor, MCP HTTP 전송을 구현한 기타 클라이언트)를 이 엔드포인트로 지정하여 다음을 수행할 수 있습니다:

제품 및 플랫폼 문서 탐색 (wink://docs/...)
실시간 OpenAPI 사양 및 작업 문서 탐색 (wink://api/...)
문서 및 실시간 API에 대한 경량 의미/키워드 검색 수행

전송

기본 스트리밍 가능한 HTTP 엔드포인트를 사용하세요:

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

클라이언트가 SSE만 지원하는 경우 다음을 사용하세요:

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

Claude Code

공식 문서: MCP를 통해 Claude Code를 도구에 연결하기

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에 기록하도록 하세요.

Codex

공식 문서: Codex용 Docs MCP 빠른 시작

OpenAI는 Codex CLI를 통해 MCP 설정을 문서화하며, 이 구성이 IDE 확장과 공유된다고 명시합니다:

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

Cursor

Cursor MCP 문서: https://cursor.com/docs/context/mcp 설정: MCP 설정을 통해 원격 서버 추가.

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

VS Code

공식 문서: https://code.visualstudio.com/docs/copilot/customization/mcp-servers 최소 원격 구성(사용자 또는 작업공간 mcp.json):

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

팁:

명령 팔레트에서 “MCP: List Servers”를 사용하여 연결 확인 및 도구 탐색.
도구 선택기에서 api_search 및 docs_search 활성화/비활성화 가능.
컨텍스트 추가: 채팅 뷰 → 컨텍스트 추가 → MCP 리소스를 선택하여 문서 페이지 첨부.

핵심 리소스 URI

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도 반환하여 에이전트가 가장 유용한 하위 리소스로 바로 이동할 수 있습니다.

일반 사용 패턴

의도에 맞는 api_search 실행 (예: “create affiliate” 또는 “payment receipt”).
반환된 wink://api/... URI를 열거나 연결된 request_uri, response_uris, request_schema_uris, response_schema_uris, recipe_uri 필드를 따라가세요.
지원 개념(인증, 웹훅, 워크플로우)을 위해 docs_search 사용.

AI 스킬

사전 구축된 에이전트 스킬은 이 MCP 서버를 진실의 출처로 사용합니다. 스킬은 Wink API를 구축하기 위한 구조화된 워크플로우를 에이전트에 제공하여, 엔드포인트를 추측하는 대신 에이전트가 MCP 서버에서 직접 실시간 계약을 읽도록 합니다.

사용 가능한 스킬과 설치 지침은 AI Skills에서 확인하세요.

참고 사항

반환된 각 URI는 에이전트가 전체 콘텐츠를 열 수 있습니다.
wink://api 트리는 실시간이며 생성된 저장소 인덱스 대신 현재 상위 OpenAPI 카탈로그를 따릅니다.
쿼리가 비어 있으면 제안이 자동으로 표시됩니다.

GitHub의 Wink