Skip to main content
REST API、MCP、CLI の認証方式、料金、リクエスト制限をまとめました。

​
認証

REST API・MCP・CLI は、すべて同じ認証情報のしくみを使います。
  • API Key : {id}.{secret} 形式の Bearer トークンです。REST・MCP・CLI のいずれでも動作します。
  • JWT : MCP は OAuth で発行された JWT も受け付けます。（対話型 AI クライアント向け）
登録時のログイン方法に関係なく、有効な API Key またはトークンで認証できます。 くわしい発行・利用方法は認証を参照してください。

​
キーは誰が発行できますか

platform.tiro.ooo/me/api-keys ではどのプランでもユーザー API Key を発行できます。アカウントのAPIキーは、現在アクセスできるワークスペースで本人の権限で動作します。ワークスペース・組織のAPIキーを発行できるのは、対象のワークスペースまたは組織の管理者のみです。

​
何が無料で何が有料か

ノート・フォルダ・共有リンク・ドキュメントテンプレート・スクリプト・単語帳の取得にクレジットはかかりません。
ウィキのエンドポイントには有料プランが必要です。個人ワークスペースは Pro 以上 のプラン、チームワークスペースは Team 以上 のプランが必要です。資格のないプランから呼び出すと 402 Payment Required が返ります。
ウィキのゲートは REST と MCP に同じように適用されます（MCP の search_wiki・get_wiki_page・list_wiki_mentions・get_wiki_graph）。
音声認識（STT）や大量の LLM 処理に対する課金は、まだ API・MCP を通じては発生しません。

​
レート制限

API Key 1つあたり60秒で600リクエストの上限で送れます。超えると 429 Too Many Requests が返り、レスポンスには再試行の時刻を知らせる Retry-After と X-RateLimit-* ヘッダーが含まれます。 くわしいレスポンス形式はエラー処理を参照してください。