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

# クライアントを接続する

> Claude、ChatGPT、Cursor、Claude Code、または MCP 対応の任意の AI クライアントで Tiro MCP server をセットアップします。

export const ClientSetupAccordion = ({children}) => <div className="tiro-client-setup">
    <AccordionGroup>{children}</AccordionGroup>
  </div>;

Tiro MCP server は `https://mcp.tiro.ooo/mcp` にあります。ご利用のクライアントを選び、手順に従えば接続完了です。各クライアントには推奨される認証方法があり、ほとんどは別の方法にも対応しています。

<Note>
  **まだ API key をお持ちでないですか？** [Tiro Platform API Keys page](https://platform.tiro.ooo/dashboard/api-keys) で作成してください。key は `abc123.xR7mK9pL2qW4...` のような形式です。**ドットを含む文字列全体**をコピーしてください。ダッシュボードには参照用に「Key ID」（例：`abc123`）が表示されますが、Bearer token は作成時に一度だけ表示される**完全な文字列**です。紛失した場合は、新しい key を生成してください。
</Note>

<ClientSetupAccordion>
  <Accordion title="Claude Desktop" defaultOpen>
    **推奨：OAuth。** 一度サインインすれば、クライアントが token を管理します。

    <Note>
      [Node.js](https://nodejs.org/) が必要です。`mcp-remote` パッケージが、streamable-http を Claude Desktop が期待する stdio transport に橋渡しします。
    </Note>

    ご利用のプラットフォームに合わせて設定ファイルを開きます。

    <CodeGroup>
      ```bash macOS theme={"system"}
      ~/Library/Application Support/Claude/claude_desktop_config.json
      ```

      ```bash Windows theme={"system"}
      %APPDATA%\Claude\claude_desktop_config.json
      ```

      ```bash Linux theme={"system"}
      ~/.config/Claude/claude_desktop_config.json
      ```
    </CodeGroup>

    OAuth の設定を追加します。

    ```json claude_desktop_config.json theme={"system"}
    {
      "mcpServers": {
        "tiro": {
          "command": "npx",
          "args": ["-y", "mcp-remote", "https://mcp.tiro.ooo/mcp"]
        }
      }
    }
    ```

    Claude Desktop を再起動します。初回接続時にブラウザが開き、Google でサインインします。token はローカルにキャッシュされ、180 日間有効です。

    **代替：API Key。** ブラウザフローを避けたい場合は、次の設定をご利用ください。

    ```json claude_desktop_config.json theme={"system"}
    {
      "mcpServers": {
        "tiro": {
          "command": "npx",
          "args": [
            "-y", "mcp-remote",
            "https://mcp.tiro.ooo/mcp",
            "--header", "Authorization:Bearer YOUR_API_KEY"
          ]
        }
      }
    }
    ```
  </Accordion>

  <Accordion title="Claude Code (CLI)">
    **推奨：API Key。** ブラウザへの依存を避けられ、ローテーションも簡単です。

    ```bash theme={"system"}
    claude mcp add --transport http tiro-mcp https://mcp.tiro.ooo/mcp \
      --header "Authorization:Bearer YOUR_API_KEY"
    ```

    **代替：OAuth。** `--header` を省略します。Claude Code が初回接続時にブラウザを開きます。

    ```bash theme={"system"}
    claude mcp add --transport http tiro-mcp https://mcp.tiro.ooo/mcp
    ```
  </Accordion>

  <Accordion title="ChatGPT">
    **推奨：OAuth。** ブラウザに対応したほとんどの MCP クライアントは、標準で OAuth に対応しています。

    1. server URL `https://mcp.tiro.ooo/mcp` を追加します。
    2. ChatGPT がブラウザウィンドウを開き、Google でサインインします。
    3. クライアントが access token をキャッシュします。

    ブラウザフローが組み込まれていないクライアントでは、`mcp-remote` をローカルの stdio プロキシとして実行し、ChatGPT をそのローカルプロセスに向けてください。

    ```bash theme={"system"}
    npx -y mcp-remote https://mcp.tiro.ooo/mcp
    ```
  </Accordion>

  <Accordion title="Cursor">
    **推奨：API Key。**

    1. **Settings** > **MCP** を開きます。
    2. **Add new MCP server** をクリックします。
    3. transport を **HTTP** に設定します。
    4. server URL を入力します：`https://mcp.tiro.ooo/mcp`。
    5. ヘッダーを追加します：`Authorization: Bearer YOUR_API_KEY`。
  </Accordion>

  <Accordion title="VS Code (Copilot)">
    **推奨：API Key。** ワークスペースに `.vscode/mcp.json` を作成または編集します。

    ```json .vscode/mcp.json theme={"system"}
    {
      "servers": {
        "tiro": {
          "type": "http",
          "url": "https://mcp.tiro.ooo/mcp",
          "headers": {
            "Authorization": "Bearer YOUR_API_KEY"
          }
        }
      }
    }
    ```
  </Accordion>

  <Accordion title="その他の MCP クライアント">
    streamable-http に対応した任意の MCP クライアントは、次の生の値で動作します。

    | Field        | Value                                                         |
    | ------------ | ------------------------------------------------------------- |
    | Server URL   | `https://mcp.tiro.ooo/mcp`                                    |
    | Transport    | HTTP (streamable)                                             |
    | Auth header  | `Authorization: Bearer YOUR_API_KEY`                          |
    | OAuth issuer | `https://mcp.tiro.ooo`（クライアントが OAuth 2.0 with PKCE に対応している場合） |

    stdio のみのクライアントでは、endpoint を `mcp-remote` でラップしてください。

    ```bash theme={"system"}
    npx -y mcp-remote https://mcp.tiro.ooo/mcp \
      --header "Authorization:Bearer YOUR_API_KEY"
    ```
  </Accordion>
</ClientSetupAccordion>

***

## Scopes

scope は、MCP server があなたに代わってアクセスできる範囲を定義します。現在、API key はすべての scope を自動的に付与します。

| Scope              | Description                        |
| ------------------ | ---------------------------------- |
| `mcp:notes:read`   | ノート、トランスクリプト、要約、ドキュメント、テンプレートの読み取り |
| `mcp:folders:read` | ユーザーフォルダおよびチームフォルダ構造の検索            |

<Note>
  scope の細かな選択はまだご利用いただけません。認証されたすべての接続にフルアクセスが付与されます。きめ細かい scope 制御は将来のリリースで予定しています。
</Note>

***

## API key の種類

| Key Kind                 | Tied To    | Access                                                        |
| ------------------------ | ---------- | ------------------------------------------------------------- |
| **User-scoped key**      | ユーザー       | そのユーザーがアクセスできるすべてのノート、要約、ドキュメント、フォルダ — 複数のワークスペースにまたがることができます |
| **Workspace-scoped key** | 単一のワークスペース | その単一ワークスペース内のすべて。ユーザー識別情報を持ちません                               |

<Info>
  **どの key が必要ですか？** ほとんどのユーザーは **user-scoped key** から始めます。所属するすべてのワークスペースにわたって、チームフォルダ内のノートを含め、アクセス権のあるすべてのノートを検索・読み取りできます。**workspace-scoped key** は単一のワークスペースに紐づき、そのワークスペースを自動的に検索します。どちらの種類でもフォルダツール（`search_private_folders`、`search_team_folders`）を使用でき、必要なスコープは `mcp:folders:read` のみです。個人／チームの区別はフォルダの種類であって、key の種類ではありません。
</Info>

API key は、[Tiro Platform API Keys page](https://platform.tiro.ooo/dashboard/api-keys) から無効化しない限り、有効期限はありません。key は定期的にローテーションし、開発用と本番用で別々の key を使うことをおすすめします。

OAuth token は **180 日間**有効です。それより早くローテーションするには、クライアントからサインアウトして再度サインインしてください。即時に無効化したい場合は、サポートまでご連絡ください。

接続できたら、[利用可能なツール](/ja/developers/mcp/tools/overview)をご確認ください。クライアントが接続できない場合は、[Troubleshooting](/ja/developers/mcp/troubleshooting) にお進みください。