> ## 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.

# Using the MCP tools

> OneS1ght provides MCP tools that help you install the SDK and set up positioning events.

<Info>
  **MCP (Model Context Protocol)** is the standard that lets coding agents use external tools. The OneS1ght MCP
  tools stand in for the SDK documentation so that you can write your integration code more easily.
</Info>

## Connecting the MCP tools

Access is granted with the API key you issued on the Mobile SDK page of the console. If the API key is revoked or
your subscription ends, the tools stop working. <br />
Replace `YOUR_SDK_API_KEY` with the API key you issued before running the commands below.<br /><br />
[Guide — Mobile SDK key management](/en/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"
    ```

    Once it is registered, check that the MCP tools are listed.

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

  <Tab title="Codex CLI">
    Open `config.toml` in the directory where Codex is installed and add the following.

    ```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">
    Open `mcp.json` in the directory where Cursor is installed and add the following.

    ```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>
  Issue a **Development** key for the MCP tools, and handle the API key with care.
</Warning>

## How to use the MCP tools

Once the MCP tools are registered with your coding agent, use them as in the examples below.

<AccordionGroup>
  <Accordion title="Installing the SDK">
    ```
    Add the OneS1ght SDK to this app. Start positioning on the store map screen.
    ```
  </Accordion>

  <Accordion title="Troubleshooting from an error code">
    ```
    Fix what is showing up as E3003 in the logs.
    ```
  </Accordion>

  <Accordion title="Troubleshooting from a symptom">
    ```
    The app runs but no coordinate data is being sent.
    ```
  </Accordion>

  <Accordion title="Checking the status">
    ```
    Can you check the current state of the SDK integration?
    ```
  </Accordion>

  <Accordion title="Migrating">
    ```
    Upgrade the SDK to the latest version.
    ```
  </Accordion>
</AccordionGroup>