最初の1リクエストはもう叩けましたか?

昨日 jpcite API ({{tier}} プラン / 鍵末尾 {{key_last4}}) をお申し込みいただきました。経験上、最初の 1 リクエストが通れば一気に流れに乗れるので、今日はクライアントごとの最短セットアップとよくある詰まりどころだけお送りします。

使うクライアントを1つ選んでください

A. Claude Desktop / Claude Code

MCP 対応 LLM クライアント。claude_desktop_config.json に追記するだけで 139 ツール (programs.search / search_tax_incentives / check_invoice_registrant ほか) が自然言語から呼べます。

{
  "mcpServers": {
    "autonomath": {
      "command": "uvx",
      "args": ["autonomath-mcp"],
      "env": { "JPCITE_API_KEY": "YOUR_KEY" }
    }
  }
}

Claude セットアップ詳細

B. Cursor

設定 → MCP → Add new MCP server に同じ block を追加します。

Cursor セットアップ詳細

C. Cline (VS Code)

Cline の MCP Servers タブで同じ JSON を貼り付けます。

Cline セットアップ詳細

D. 直接 curl / SDK

MCP を経由せず REST で叩く場合の最小例:

curl -H "X-API-Key: YOUR_KEY" \
  "https://api.jpcite.com/v1/programs/search?prefecture=東京都&target_type=中小企業&limit=10"

よくある詰まりどころ

• 401 Unauthorized — ヘッダ名は X-API-Key です(Authorization: Bearer YOUR_KEY でも受けます)。Api-Key や X-Api-Token は通りません。
• 429 Too Many Requests — Retry-After ヘッダの秒数を待ってください。Paid キーは月次課金で上限なし、匿名は 3 req/日 (JST 翌日 00:00 リセット) です。
• FTS の単一漢字ノイズ — q=税額控除 は「税」だけ含む行も拾います。2文字以上の熟語は q="税額控除" のように引用符で囲ってください。
• MCP が起動しない — uvx autonomath-mcp は初回 30 秒程度かかります。タイムアウトを 60s に伸ばしてください。
• 環境変数が読まれない — Claude Desktop は config.json の env ブロックのみ読みます。シェルの export は無視されます。

それでも止まっていれば、このメールに「こう書いたがこう返る」の1行だけでも返信ください。人間が読みます。

税理士法 §52 / 弁護士法 §72 該当の業務はおこないません

jpcite は日本の制度情報の検索インデックス API です。税務助言・法律相談・申請代行・社会保険労務士業務はおこないません。出力結果は士業による確認の代替にはなりません。

— Bookyou 株式会社 / jpcite

jpcite — 日本の制度情報 API + MCP
このメールは jpcite の活性化シーケンス (D+1) としてお送りしています。
お問い合わせ: info@bookyou.net
運営: Bookyou 株式会社 (T8010001213708) / 東京都文京区小日向2-22-1
ライセンス: ご利用は 利用規約 / プライバシーポリシーに基づきます。
配信停止: ここをクリック