メインコンテンツへスキップ
MCP のセットアップに関する問題のほとんどは、3 つのカテゴリーに分類されます。auth ヘッダー、transport、そしてクライアントのキャッシュです。これらを順番に確認してください。各ステップの間にクライアントを再起動すると、設定が確実に読み込み直されます。

​
接続の問題

​
Server Not Found

MCP server の URL が正しいか確認してください：https://mcp.tiro.ooo/mcp よくある間違い：
  • /mcp のパス末尾が欠けている
  • https:// ではなく http:// を使っている
接続をテストします。 
curl https://mcp.tiro.ooo/mcp
期待されるレスポンス：405 Method Not Allowed（GET リクエストでは正常です）。

​
ツールが表示されない

  1. MCP クライアントを完全に再起動する（ウィンドウの更新だけでなく）
  2. AI に「List all available MCP servers」と尋ね、Tiro が表示されるか確認する
  3. それでも表示されない場合は、client setup をやり直す

​
認証エラー

​
API Key の問題

API Key の形式が無効 API Key は {id}.{secret} の形式（ドットで区切られた 2 つの部分）に従う必要があります。よくある間違い：
  • key の一部だけをコピーしている（ドットの前または後の部分が欠けている）
  • key に余分な空白や改行文字が含まれている
  • 実際の key ではなくプレースホルダーの値を使っている
# Correct format
TIRO_API_KEY=abc123.xyz789secretvalue

# Wrong — missing the dot separator
TIRO_API_KEY=abc123xyz789secretvalue
期限切れまたは無効化された Key API Key は Tiro Dashboard から期限切れにしたり無効化したりできます。以前に使用していた API key で 401 UNAUTHORIZED エラーが発生した場合：
  1. Tiro Platform API Keys にアクセスする
  2. key がまだ有効か確認する。必要であれば新しい key を生成する
  3. MCP クライアントの設定を新しい key で更新する
Key の種類の間違い（User と Team） 一部のツールには特定の key の種類が必要です。
  • User API Key — 個人アカウントに紐づきます。ユーザー固有のツール（例：ユーザーフォルダ）に必要です
  • Team API Key — チームに紐づきます。チーム固有のツール（例：チームフォルダ）に必要です
ツールが USER_REQUIRED または TEAM_REQUIRED を返す場合は、その操作に正しい種類の key を使っているか確認してください。

​
401 Unauthorized / 403 Forbidden

API Key を使う場合： key が有効で、期限切れでなく、呼び出すツールに必要な scope を持っているか確認してください。すべての scope の表については Setup page をご覧ください。 OAuth を使う場合： MCP クライアントを再起動して、新しい OAuth フローを起動してください。
  • Claude Code：CLI セッションを再起動する
  • Claude Desktop：アプリを完全に終了して再起動する
  • Cursor：エディタを再起動するか、MCP 拡張機能を再読み込みする
  • VS Code：エディタを再起動するか、MCP 拡張機能を再読み込みする
OAuth は、正しい scope を持つ新しい token を自動的に発行します。token は 180 日間有効です。

​
設定の問題

​
Claude Code が接続できない

  1. 設定が Claude Code setup と一致しているか確認する
  2. CLI セッションを再起動する
  3. OAuth を使っていてブラウザウィンドウが開かない場合は、デフォルトのブラウザ設定を確認する
  4. API Key を使っている場合は、key の値に末尾の空白がないか確認する

​
Claude Desktop が接続できない

  1. 設定が Claude Desktop setup と一致しているか確認する
  2. JSON の構文を検証する。カンマの欠け、対応していない括弧、引用符の欠けがないか確認する（JSONLint）
  3. Node.js がインストールされているか確認する（ターミナルで npx が動作する必要があります）
  4. Claude Desktop を完全に終了して再起動する（macOS では Cmd+Q。ウィンドウを閉じるだけではありません）

​
Cursor が接続できない

  1. Cursor の設定で MCP server の設定を確認する
  2. server URL が https://mcp.tiro.ooo/mcp であることを確認する
  3. API Key を使っている場合は、設定に正しく入力されているか確認する（余分な引用符や空白がないこと）
  4. Cursor を完全に再起動し、MCP パネルで接続状態を確認する

​
VS Code が接続できない

  1. MCP 拡張機能の設定（例：Continue の設定や Copilot MCP の設定）を確認する
  2. server URL が https://mcp.tiro.ooo/mcp であることを確認する
  3. API Key を使っている場合は、正しい設定フィールドに入力されているか確認する
  4. VS Code のウィンドウを再読み込みし（Cmd+Shift+P → 「Reload Window」）、拡張機能のログにエラーがないか確認する

​
検索とデータの問題

  • 結果が出ない？ より広い検索条件を試してください。content に一般的なキーワードを 1 つだけ使うか、createdAt の日付範囲を広げてください
  • 日付形式のエラー？ タイムゾーン付きの ISO 8601 を使ってください：2025-11-22T00:00:00Z（日付のみの形式は受け付けられません）
  • 最近のノートが見つからない？ キャッシュのため、ノートが表示されるまで最大 15 分かかることがあります。ノートが Tiro Dashboard で「Completed」になっているか確認してください
  • リクエストがタイムアウトする？ 長い会議では、get_note_transcript の代わりに get_note(include: ['summary']) を使ってください

​
エラーリファレンス

CodeHTTPDescriptionSolution
UNAUTHORIZED401有効な認証がないAPI key を確認するか、クライアントを再起動して OAuth で再認証する
TOKEN_EXPIRED401token が期限切れ新しい API key を生成するか、クライアントを再起動して OAuth で再認証する
FORBIDDEN403必要な scope がないAPI key の scope を確認するか、クライアントを再起動して OAuth で再認証する
INSUFFICIENT_SCOPE403認証された key/token に、このツールに必要な scope がないSetup page の scope 表を確認し、正しい scope を持つ key を使う
USER_REQUIRED403ツールが user-based API key を必要とするが、team-only key が指定されたこの操作には user API key に切り替える
TEAM_REQUIRED403ツールが team API key を必要とするが、user-only key が指定されたこの操作には team API key に切り替える
MISSING_PARAMETERS400必須パラメータが欠けているパラメータの要件を確認する
INVALID_NOTE_ID400note ID が無効正の整数を使う
INVALID_DATE_FORMAT400日付形式が間違っているISO 8601 datetime を使う
NOTE_NOT_FOUND404ノートが存在しないnote ID を確認する
INTERNAL_SERVER_ERROR500サーバーエラー再試行するか、サポートに連絡する
REQUEST_TIMEOUT504リクエストがタイムアウトした要約を使うか、再試行する

​
サポート

GitHub で issue を作成するか、support@tiro.ooo までメールでご連絡ください。