> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ones1ght.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

## SDK MCP 소개

OneS1ght SDK MCP는 코딩 에이전트가 SDK 문서를 대신 찾아서 연동 코드를 작성 해 주고 로그를 분석해 오류를 수정해 줍니다.

## MCP 활용 예시

코딩 에이전트에게 아래처럼 요청해 보세요.

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

## 참고 사항

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

> [!TIP]
>
> **권장 사항** — MCP 연결에는 **개발용(Development) 키**를 따로 발급해 쓰세요. 키는 코딩 에이전트 설정 파일에 그대로 저장되므로
> 저장소에 올리거나 다른 사람과 공유하지 마세요. 코딩 에이전트가 쓴 코드는 반드시 검토한 뒤 반영하세요.

## MCP 연결하기

콘솔의 **모바일 SDK** 메뉴에서 API 키를 발급한 뒤([모바일 SDK 키 관리](/console/sdk-keys)), 아래 예시의 `YOUR_SDK_API_KEY` 를 발급한 키로
바꿔 등록합니다. 서버 주소와 인증 헤더는 모든 클라이언트가 같습니다.

### Claude Code 에서 연결하기

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

```bash theme={null}
claude mcp add --transport http onesight https://console.ones1ght.com/api/sdk/v1/mcp --header "X-SDK-Key: YOUR_SDK_API_KEY"
```

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

```bash theme={null}
claude mcp list
```

### Codex 에서 연결하기

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

```toml theme={null}
[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. 아래 내용을 추가하고 저장합니다.

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

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

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

HTTP 방식 MCP 를 지원하는 클라이언트라면 어디서든 같은 주소로 연결할 수 있습니다. 요청 헤더 `X-SDK-Key` 에 발급한 키를 넣어 주세요.

```text theme={null}
https://console.ones1ght.com/api/sdk/v1/mcp
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.