> ## 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 キー管理](/ja/console/sdk-keys)）、以下の例の `YOUR_SDK_API_KEY` を発行したキーに
置き換えて登録します。サーバー URL と認証ヘッダーはすべてのクライアントで共通です。

### 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 をサポートするクライアントなら、どこからでも同じ URL に接続できます。リクエストヘッダー `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.