HTTP / MCP エラー一覧
現在掲載している症状は 8 件。
401
401 Unauthorized
- 症状
- tool 呼び出しが「Unauthorized」で 401 になる
- 原因
- API key が無効・失効・コピーミス
- 対処
- 設定ファイルの Bearer 値を再確認する。プレフィクス
rk_live_と空白・改行混入をチェック。漏洩疑いなら support@rakuda.co に依頼して再発行する。
429
429 Rate limit exceeded
- 症状
- "Rate limit exceeded (60/min)" 等のエラー
- 原因
- 1 API key あたり 60 req/分の上限超過
- 対処
- バーストを抑える。並列実行を絞り、リクエスト間隔を空ける。大量取得は
export_to_csvにまとめる方が速い。
403
403 / 「課金情報が未紐付け」
- 症状
- metered tool が拒否される
- 原因
- signup 完了したがカード登録が未完了
- 対処
- /signup からカード登録 (Stripe Setup Intent) を完了させる。固定月額 ¥15,000/月(税別)。カード登録は利用開始に必須。
CAP
"monthly_cap exceeded"
- 症状
- 月途中で全 tool が止まる
- 原因
- 月 10 万件の取得上限に到達
- 対処
- 翌月リセットを待つ、または support@rakuda.co で上限引き上げを相談する。
FTS
「検索可能な keyword が無い」
- 症状
- fts_search_companies が短文クエリ ("AI", "IT", "DX" 等) で拒否される
- 原因
- FTS5 trigram は ASCII 3 文字 / 日本語 2 文字以上が必要
- 対処
search_companies(name="...")を使う、または長いキーワード (「人工知能」「DX 推進」等) に書き換える。
IND
industry_type が 0 件
- 症状
- search_companies(industry_type="製造業") などが 0 件で返る
- 原因
- 完全一致でなく LIKE 部分一致なので、辞書語と DB 実値の表記ずれが起きやすい
- 対処
list_categories.industry_type_valuesで DB 実値を確認する。あるいはbusiness_queryで曖昧クエリに切り替える。
CSV
CSV 出力が大きすぎる
- 症状
- "CSV 出力が上限"
- 原因
- 1 回の出力に上限 (例 100,000 行)
- 対処
offsetで分割し、複数回に分けて呼ぶ。
DB
/health の degraded フラグ true
- 症状
- ヘルスチェックで db.degraded=true, reason に "database disk image is malformed" 等
- 原因
- FTS5 シャドウテーブル破損 (Phase 2.4.1 で検知)
- 対処
- support@rakuda.co に連絡。通常は 30 分以内に復旧する。
MCP クライアント別の症状
Claude Desktop
設定変更後に Claude を一度終了 → 再起動する。tool が見えない時は config の JSON が valid か (カンマ・括弧・引用符) を確認。
Cursor
Settings → MCP で reload する。MCP server status がConnectedになっていることを確認する。
Claude Code
claude mcp list で登録確認。接続が荒れたら claude mcp remove rakuda-atlas → 再 add でリセット。
サポート
上記で解決しない場合は support@rakuda.co まで。メールには以下を含めると最短で解決する。
- 使用している MCP クライアント (Claude Desktop / Cursor / Claude Code 等)
- エラーメッセージの全文
- リクエスト ID (response header の
X-Request-Id)