MCP 도구 사용

MCP(Model Context Protocol) 는 코딩 에이전트가 외부 도구를 쓰게 하는 표준이며 OneS1ght MCP 도구는 SDK 문서를 대신하고 쉽게 코드 작성을 하실 수 있습니다.

MCP 도구 연결하기

콘솔페이지의 모바일 SDK 페이지에서 발급한 API 키로 접근이 가능합니다. API 키를 폐기하거나 서비스 이용이 중지되면 도구를 사용하실 수 없습니다.
발급한 API 키는 YOUR_SDK_API_KEY로 교체하여 실행해 주세요.

가이드 문서 - 모바일 SDK 키 관리

Claude Code
Codex CLI
Cursor

claude mcp add --transport http onesight \
  https://console.ones1ght.com/api/sdk/v1/mcp \
  --header "X-SDK-Key: YOUR_SDK_API_KEY"

성공적으로 등록했다면 MCP 도구가 등록되었는지 확인합니다.

claude mcp list

Codex가 설치된 디렉토리에 config.toml 을 열고 아래 내용을 추가합니다.

[mcp_servers.onesight]
url = "https://console.ones1ght.com/api/sdk/v1/mcp"

[mcp_servers.onesight.http_headers]
X-SDK-Key = "YOUR_SDK_API_KEY"

Cursor 가 설치된 디렉토리에서 mcp.json 을 열고 아래 내용을 추가합니다.

{
  "mcpServers": {
    "onesight": {
      "url": "https://console.ones1ght.com/api/sdk/v1/mcp",
      "headers": { "X-SDK-Key": "YOUR_SDK_API_KEY" }
    }
  }
}

MCP 도구용 키 발급시 **개발용 키(Development)**로 발급하여 사용하시고, API 키 사용에 주의해 주세요.

MCP 도구 사용 방법

성공적으로 MCP 도구를 코딩 에이전트에 등록하였다면 다음의 예시를 참고하여 사용해 주세요.

SDK 설치

이 앱에 OneS1ght SDK를 붙여 줘. 매장 지도 화면에서 측위를 시작하면 돼.

에러 코드를 통한 트러블슈팅

로그에 E3003이라고 나오는 것을 고쳐줘

증상을 통한 트러블슈팅

앱은 실행되는데 좌표 정보가 전송되지 않아

상태 확인

지금 SDK 연동 상태 어떤지 확인해 줄래?

마이그레이션시

SDK를 최신 버전으로 올려 줘.

시작하기

측위 인프라 (GeoSpace)(모바일)

측위 인프라 (GeoSpace)(태그)

OneS1ght 콘솔

개발자 가이드 (SDK)

MCP 도구 사용

MCP 도구 연결하기

MCP 도구 사용 방법

​MCP 도구 연결하기

​MCP 도구 사용 방법

MCP 도구 연결하기

MCP 도구 사용 방법