> ## 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 キーの管理](/ja/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>