クライアントを接続する

Tiro MCP server のアドレスは https://mcp.tiro.ooo/mcp です。以下からご利用のクライアントの設定方法をご確認ください。

API key がない場合は Tiro Platform API Keys page で作成してください。abc123.xR7mK9pL2qW4... のように、ドットを含む文字列全体をコピーする必要があります。key の全体は作成時に一度だけ表示されます。

Claude（ウェブブラウザ）

ブラウザで claude.ai を使っている場合は、インストール不要のリモートコネクタで接続します。OAuth 専用です（API key の入力欄はありません）。

claude.ai/customize/connectors の Connectors → Discover で Tiro を検索します。
Tiro（Community、by ThePlato Inc.）のカードで Connect Tiro to Claude を押します。
Tiro アカウントでログインして権限を許可します。連携後、ツールの実行は既定で毎回承認を求めます（コネクタの設定でツールごとに Always allow に変更できます）。

サーバー URL（https://mcp.tiro.ooo/mcp）を直接入力する Add custom connector の経路も引き続き使えます。非開発者向けのステップバイステップの案内はユーザーガイドにあります。

Claude Desktop

推奨：OAuth。 一度サインインすれば、クライアントが token を管理します。

Node.js が必要です。mcp-remote パッケージが、streamable-http を Claude Desktop が期待する stdio transport に橋渡しします。

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

~/Library/Application Support/Claude/claude_desktop_config.json

%APPDATA%\Claude\claude_desktop_config.json

~/.config/Claude/claude_desktop_config.json

OAuth の設定を追加します。

claude_desktop_config.json

{
  "mcpServers": {
    "tiro": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.tiro.ooo/mcp"]
    }
  }
}

Claude Desktop を再起動します。初回接続時にブラウザが開き、Google でサインイン後、Tiro の consent 画面で許可する権限を scope 単位のチェックボックスで選択します（読み取りはデフォルトで選択、書き込みはデフォルトで解除。書き込みを選択すると同じリソースの読み取りが含まれます）。token はローカルにキャッシュされ、180 日間有効です。代替：API Key。 ブラウザフローを避けたい場合は、次の設定をご利用ください。

claude_desktop_config.json

{
  "mcpServers": {
    "tiro": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.tiro.ooo/mcp",
        "--header", "Authorization:Bearer YOUR_API_KEY"
      ]
    }
  }
}

Claude Code (CLI)

推奨：API Key。 ブラウザへの依存を避けられ、ローテーションも簡単です。

claude mcp add --transport http tiro-mcp https://mcp.tiro.ooo/mcp \
  --header "Authorization:Bearer YOUR_API_KEY"

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

claude mcp add --transport http tiro-mcp https://mcp.tiro.ooo/mcp

ChatGPT

2026 年 7 月の刷新以降、ChatGPT の外部連携はアプリ・プラグイン方式に変わりました。プラグインディレクトリにないカスタム MCP server（Tiro を含む）は developer mode でのみ接続できます。ウェブ専用（モバイル非対応）で、個人アカウントは Pro プラン以上で read/fetch 範囲の接続ができます。Business は admin/owner のみ、Enterprise・Edu は RBAC で権限を付与されたメンバーのみ developer mode を使えます。

Settings → Plugins → リスト最下部の Developer mode → セキュリティ設定で Developer mode トグルをオンにします。
サイドバーの Plugins ページで [+] → New Plugin を開き、名前と server URL https://mcp.tiro.ooo/mcp を入力し、リスク告知にチェックして Create を押します。
Sign in with Tiro → Tiro アカウントにログイン → 権限画面で Long-lived access にチェック（ChatGPT は refresh を要求するため、チェックしないと許可ボタンが有効になりません）→ Allow selected access。
チャットのツールメニューからアプリを選択して使います。選択はメッセージ単位で適用されます。（2026-09-11 実画面検証）

詳細な要件とワークスペースへの公開手順は OpenAI 公式ガイドを参照してください。UI はベータのため変わることがあります。

Codex (CLI)

推奨：API key。 Codex は stdio ベースのため、mcp-remote でラップします。~/.codex/config.toml に追加してください。

~/.codex/config.toml

[mcp_servers.tiro]
command = "npx"
args = [
  "-y", "mcp-remote",
  "https://mcp.tiro.ooo/mcp",
  "--header", "Authorization:Bearer YOUR_API_KEY"
]

代替：OAuth。 --header の 2 行を削除すると、初回接続時にブラウザが開きます。

Cursor

推奨：API Key。

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

VS Code (Copilot)

推奨：API Key。 ワークスペースに .vscode/mcp.json を作成または編集します。

.vscode/mcp.json

{
  "servers": {
    "tiro": {
      "type": "http",
      "url": "https://mcp.tiro.ooo/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

その他の 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 でラップしてください。

npx -y mcp-remote https://mcp.tiro.ooo/mcp \
  --header "Authorization:Bearer YOUR_API_KEY"

Scopes

scope は、MCP server があなたに代わってアクセスできる範囲を定義します。MCP scope は REST API scope と同じ語彙に mcp: prefix を付けたものです。クライアントがツールを取得すると、その接続で選択した scope で許可されるツールだけが表示されます。

Scope	Description
`mcp:note:read`	ノートのメタデータ、AI 要約、トランスクリプト、生成文書、共有リンク、文書テンプレート、Wiki の読み取り — Wiki・テンプレートのツールも個別の scope ではなくこの scope 一つでゲートされます
`mcp:folder:read`	ユーザーフォルダおよびワークスペースフォルダ構造の検索
`mcp:note:write`*	ノートタイトルの更新
`mcp:folder:write`*	フォルダの更新・移動・並べ替え

* 現在 MCP には、この権限スコープに対応するツールはありません（REST API 専用で、MCP ツールはすべて読み取り専用です）。

API key: key に設定した scope がそのまま適用されます。API Keys ページでは mcp: を除いた REST 表記（note:read、folder:write など）で選択します — mcp: prefix は auth_status などの MCP 表面でのみ付きます。scope 未指定の key はすべてのツールを利用でき、write scope は対応する read を含みます。
OAuth: 接続時に Tiro の consent 画面で、ノート・フォルダごとになしまたは閲覧のいずれかを選択します。MCP OAuth フローは write scope（mcp:notes:write、mcp:folders:write）を要求しないため（上表の * 参照 — 対応する MCP ツールがありません）、閲覧・編集 レベルは表示されません。選択した範囲はトークンに固定されます。

旧表記（mcp:notes:read、mcp:folders:read）で発行された既存のトークンと key も引き続き動作します。

API key の種類

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

どの key が必要ですか？ ほとんどのユーザーは user-scoped key から始めます。所属するすべてのワークスペースにわたって、ワークスペースフォルダ内のノートを含め、アクセス権のあるすべてのノートを検索・読み取りできます。workspace-scoped key は接続されたワークスペースのみを検索し、そのワークスペースの中でも全メンバーに共有されたフォルダのノートのみを読み取ります（システムAPIキーが読み取るノートの範囲）。個人フォルダのノートが必要な場合は user-scoped key をご利用ください。MCP ツールは REST API と同じ key を使い、同じ読み取り範囲のルールに従います。フォルダツール（search_private_folders、search_team_folders）には、ユーザー識別情報を持つ認証情報（user-scoped API key または OAuth token）と mcp:folder:read scope が必要です。

API key は、Tiro Platform API Keys page から無効化しない限り、有効期限はありません。key は定期的にローテーションし、開発用と本番用で別々の key を使うことをおすすめします。 OAuth token は 180 日間有効です。それより早くローテーションするには、クライアントからサインアウトして再度サインインしてください。即時に無効化したい場合は、サポートまでご連絡ください。接続できたら、利用可能なツールをご確認ください。クライアントが接続できない場合は、Troubleshooting にお進みください。

ホーム

はじめに

API

音声ファイル

Webhook

MCP

CLI

開発者リソース

クライアントを接続する

Scopes

API key の種類

​Scopes

​API key の種類

Scopes

API key の種類