クイックスタート

jquants-mcp を Claude に接続して日本株のクエリに答えさせるまで、約 5 分です。

前提条件

• Python 3.10 以上（python3 --version で確認）
• J-Quants アカウント（最低 Free プラン。Light 以上で 12 週遅延が解消され日次株価がリアルタイム化）
• Claude Code（CLI）/ Claude Desktop / その他 MCP 対応クライアントのいずれか

1. jquants-mcp をインストール

uv（推奨）pipxpip

uv tool install jquants-mcp

pipx install jquants-mcp

pip install --user jquants-mcp

2. J-Quants API キーを取得

最も簡単なのはブラウザログイン（PKCE フロー）：

jquants-mcp login

J-Quants の OAuth ページがブラウザで開き、承認後 API キーが ~/.config/jquants-mcp/config.ini（mode 0600）に保存されます。 クリアしたいときは jquants-mcp logout。

自分でキーを管理したい場合は、J-Quants ダッシュボード からキーをコピーして同じファイルに記述：

# ~/.config/jquants-mcp/config.ini
[jquants]
api_key = YOUR_API_KEY_HERE

設定ファイルを作りたくない場合は環境変数 JQUANTS_API_KEY でも OK です。

3. Claude に接続

claude.ai（ブラウザ / デスクトップ / スマホ）Claude Code（CLI）Claude Desktop

1. claude.ai を開き プロジェクト を作成 （左サイドバー → プロジェクト → 新規プロジェクト）。
2. プロジェクトを開く → 歯車アイコン → Integrations → Add integration → Custom → jquants-mcp サーバーの URL を入力（例：Cloud Run のエンドポイント）。 Google OAuth で認証。
3. （推奨） 指示を追加 をクリックし、 docs/claude-project-instructions.md の内容を貼り付ける。 これにより React artifact でのチャート描画パターンが Claude に伝わり、 追加のプロンプトなしで正しいレイアウトが得られる。
4. 数分以内に、ブラウザ / デスクトップ版の設定がスマホアプリに自動連携する。

claude mcp add jquants -- jquants-mcp

claude mcp list で確認。次回 claude 起動時からサーバーが利用可能。

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または Windows / Linux の対応ファイルを編集：

{
  "mcpServers": {
    "jquants": {
      "command": "jquants-mcp"
    }
  }
}

Claude Desktop を再起動して反映。

4. 試してみる

Claude を開いて聞いてみる：

今日の業種別騰落率を教えて

Claude が get_sector_performance を呼んで業種ランキング表を返します。 最初の 1 回でローカルキャッシュが温まり、以後のクエリは即時返答に。

チャートも試してみる：

キオクシア（285A）のチャートを 3 か月分

Claude が get_candlestick_data を呼んでローソク足 React artifact をチャットに inline 表示します。

次のステップ

• ツール → — Claude にできることの一覧
• FAQ → — よくあるエラー、プラン選び、マルチユーザーモード
• 完全なリファレンス: GitHub README に設定 schema、デプロイ形態（Docker / Cloud Run / セルフホスト HTTP）、 ツール別パラメータ表、OAuth 設定が網羅されています