> ## 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 도구 사용

> OneS1ght는 SDK 를 설치하거나 측위 이벤트 설정을 돕는 MCP 도구를 제공합니다.

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

## MCP 도구 연결하기

콘솔페이지의 모바일 SDK 페이지에서 발급한 API 키로 접근이 가능합니다. API 키를 폐기하거나 서비스 이용이 중지되면 도구를 사용하실 수 없습니다. <br />
발급한 API 키는 `YOUR_SDK_API_KEY`로 교체하여 실행해 주세요.<br /><br />
[가이드 문서 - 모바일 SDK 키 관리](/locator/sdk-keys)

<Tabs>
  <Tab title="Claude Code">
    ```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"
    ```

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

    ```bash theme={null}
    claude mcp list
    ```
  </Tab>

  <Tab title="Codex CLI">
    Codex가 설치된 디렉토리에 `config.toml` 을 열고 아래 내용을 추가합니다.

    ```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"
    ```
  </Tab>

  <Tab title="Cursor">
    Cursor 가 설치된 디렉토리에서 `mcp.json` 을 열고 아래 내용을 추가합니다.

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

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

## MCP 도구 사용 방법

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

<AccordionGroup>
  <Accordion title="SDK 설치">
    ```
    이 앱에 OneS1ght SDK를 붙여 줘. 매장 지도 화면에서 측위를 시작하면 돼.
    ```
  </Accordion>

  <Accordion title="에러 코드를 통한 트러블슈팅">
    ```
    로그에 E3003이라고 나오는 것을 고쳐줘
    ```
  </Accordion>

  <Accordion title="증상을 통한 트러블슈팅">
    ```
    앱은 실행되는데 좌표 정보가 전송되지 않아
    ```
  </Accordion>

  <Accordion title="상태 확인">
    ```
    지금 SDK 연동 상태 어떤지 확인해 줄래?
    ```
  </Accordion>

  <Accordion title="마이그레이션시">
    ```
    SDK를 최신 버전으로 올려 줘.
    ```
  </Accordion>
</AccordionGroup>