MCP

​

SDK MCP 소개

​

MCP 활용 예시

• SDK 설치 — “이 앱에 OneS1ght SDK 를 붙여 줘. 매장 지도 화면에서 측위를 시작하면 돼.”
• 에러 코드 해석 — “로그에 E3003 이라고 나오는 것을 고쳐 줘.”
• 증상으로 문제 찾기 — “앱은 실행되는데 좌표 정보가 전송되지 않아.”
• 연동 상태 확인 — “지금 SDK 연동 상태가 어떤지 확인해 줄래?”
• 버전 올리기 — “SDK 를 최신 버전으로 올려 줘.”
• 공간 확인 — “이 키로 볼 수 있는 건물과 층을 알려 줘.”

​

참고 사항

• OneS1ght MCP 는 iOS · Android · Flutter SDK 를 모두 지원합니다.
• 코딩 에이전트에 대상 플랫폼(iOS · Android · Flutter)을 함께 알려 주세요. Flutter 앱은 Flutter 로 알려 주면 Dart 코드 조각을 받고, 오류 코드는 iOS·Android 뜻을 함께 받습니다.
• MCP 는 읽기만 합니다. 콘솔 설정·구역·키를 바꾸지 않으며, 그런 작업은 OneS1ght 콘솔에서 합니다.
• 연동 상태 확인은 연결한 SDK 키로 최근 들어온 로그(기본 24시간, 최대 30일)만 봅니다.
• 등록한 API 키를 폐기하거나 서비스 이용이 중지되면 MCP 를 쓸 수 없습니다.

​

MCP 연결하기

​

Claude Code 에서 연결하기

1. 터미널에서 아래 명령을 실행합니다.

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

2. 등록됐는지 확인합니다. 목록에 onesight 가 보이면 연결된 것입니다.

claude mcp list

​

Codex 에서 연결하기

1. ~/.codex/config.toml 을 엽니다. 없으면 새로 만듭니다.
2. 아래 내용을 추가하고 저장합니다.

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

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

3. Codex 를 다시 시작합니다.

​

Cursor 에서 연결하기

1. ~/.cursor/mcp.json 을 엽니다. 이 프로젝트에서만 쓰려면 프로젝트 폴더의 .cursor/mcp.json 을 씁니다.
2. 아래 내용을 추가하고 저장합니다.

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

3. Cursor 설정의 MCP 화면에서 onesight 가 켜져 있는지 확인합니다.

​

다른 MCP 클라이언트에서 연결하기

https://console.ones1ght.com/api/sdk/v1/mcp