TradeOnyx について
TradeOnyxは、個人のトレードジャーナルと分析機能をMCP対応アシスタントに接続するMCPサーバーです。自分の取引を振り返るトレーダー向けで、音声による記録と取引履歴のパターン検出に対応します。
主な機能
- 01自然な文で取引を記録
- 02ジャーナルの閲覧と検索
- 03取引履歴からパターンを検出
- 04日次ブリーフィングと計画済みプレイブックの取得
- 05戦略プレイブックの管理
- 06パフォーマンスとタグ別統計の確認
活用シーン
- 01音声で取引と理由を記録
- 02当日の取引を振り返り、ジャーナルに追記
- 03成績の低い戦略やタグを調べる
- 04取引開始前にブリーフィングと計画を確認
MCP 対応
HTTP上のJSON-RPC 2.0を通じて、ジャーナルや関連データを扱う49個のツールをMCPクライアントに提供します。接続にはBearerトークンが必要です。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
エンドポイント
https://tradeonyx.io/mcpインストールコマンドをコピー
Claude CodeTerminal
claude mcp add --transport http io-tradeonyx-tradeonyx https://tradeonyx.io/mcpCursor.cursor/mcp.json
{"mcpServers":{"io-tradeonyx-tradeonyx":{"type":"http","url":"https://tradeonyx.io/mcp"}}}Cursor で開くVS Code.vscode/mcp.json
{"servers":{"io-tradeonyx-tradeonyx":{"type":"http","url":"https://tradeonyx.io/mcp"}}}VS Code で開くClaude Desktopclaude_desktop_config.json
{"mcpServers":{"io-tradeonyx-tradeonyx":{"type":"http","url":"https://tradeonyx.io/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"io-tradeonyx-tradeonyx":{"serverUrl":"https://tradeonyx.io/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
詳細
TradeOnyx MCP Server
TradeOnyx を Claude、ChatGPT、Gemini、その他の MCP 対応アシスタントに接続します。音声で取引を記録したり、アシスタントにジャーナルを読み上げてもらったり、推測ではなく実際の取引履歴に基づいて回答してもらったりできます。
TradeOnyx は、パターン検出機能を備えた取引ジャーナルです。40 のブローカーから取引をインポートし、28 の検出器でご自身の履歴を分析して、取引で繰り返し見られるパターンを明らかにします。このリポジトリでは、その MCP サーバーについて説明します。製品コードは含まれていません。
49 個のツール · HTTP 上の JSON-RPC 2.0 · ドイツでホスト
エンドポイント
https://tradeonyx.io/mcp
トランスポートには JSON-RPC 2.0 を使用する HTTP を使います。認証には Authorization ヘッダーの Bearer トークンを使用します。サーバーは initialize、tools/list、tools/call を実装し、プロトコルバージョン 2025-06-18 に対応しています。
認証されていない呼び出しには、応答せずに待ち続けるのではなく、正直に状況を返します。
curl -s -X POST https://tradeonyx.io/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# {"jsonrpc":"2.0","id":null,"error":{"code":-32001,"message":"Unauthorized"}}
トークンの取得
- tradeonyx.io でアカウントを作成します。アカウントは無料で、支払い情報の入力も不要です。
- Settings → Integrations を開き、7 日間のコネクタトライアルを開始します。無料アカウントで開始できるのは 1 回です。トライアル終了後は、コネクタの利用に Pro または Pro Plus が必要になります。どちらの場合も、ジャーナル、ブローカーからのインポート、税務エクスポートは引き続き無料です。アクティブなトライアルまたはプランがない状態で呼び出すと、その旨を示すメッセージが返され、空の結果が黙って返されることはありません。
- 同じ画面で MCP トークンを作成します。
- すぐにコピーします。トークンの生の値が表示されるのは 1 回だけです。保存されるのは SHA-256 ハッシュのみのため、紛失したトークンは復元できず、再発行が必要です。
- 同じ画面から、いつでもトークンを取り消せます。
トークンのエントロピーは 256 ビットです。パスワードと同様に扱ってください。トークンを使うと、ご自身がジャーナルにアクセスできるのと同じ権限が付与されます。
アシスタントの接続
HTTP 上の MCP に対応するクライアントであれば、どれでも利用できます。JSON ファイルで設定するクライアントの場合、形式は次のとおりです。
{
"mcpServers": {
"tradeonyx": {
"url": "https://tradeonyx.io/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN_HERE"
}
}
}
}
リモート MCP コネクタに直接対応しているアシスタント（たとえば、Claude の Connectors）では、OAuth フローなどを含め、各自の UI からエンドポイントを追加できるため、トークンを手動で貼り付ける必要はありません。
できること
実際によく使われている例をいくつか紹介します。
- 一言で取引を記録する。 「EURUSD を 0.5 ロット、1.0840 で買いました。ロンドン時間のレンジを上抜けしたためです。ストップは 1.0810 です。」アシスタントが項目を埋め、取引と一緒に理由をジャーナルに記録します。
- 話しながら夜の振り返りを書く。 アシスタントがその日の取引を読み上げ、何を考えていたかを尋ね、その回答をジャーナルの記録として保存します。
- 実際に何が起きたかを尋ねる。 「今月、どのセットアップで損失が出て、そうした取引に共通していたことは何ですか？」推測ではなく、ご自身の実際の記録に基づいて回答します。
- セッションの準備をする。 寄り付き前に、日次ブリーフィングと予定しているプレイブックを取得します。
ツール
ツールは 49 個です。45 個の利用にはアクティブなコネクタトライアル、Pro、または Pro Plus が必要です。4 個の一括集計ツールには Pro Plus が必要です。必要なプランは、以下の Plan 列をご確認ください。
1 日あたりのツール呼び出し上限は UTC 日単位で集計され、アプリに表示されます。
| プラン | 1 日あたりの呼び出し回数 |
|---|---|
| 7 日間トライアル | 30 |
| Pro | 150 |
| Pro Plus | 2000 |
上限を超えた呼び出しには、isError: true を含む通常のツール結果が返されます。上限とリセット時刻が示されるため、アシスタントは失敗を黙って扱うのではなく、何が起きたかを説明できます。HTTP 200 が返されます。上限はビジネスルールであり、不正なリクエストではありません。また、仕様書にあるツール実行エラーの例では、上流のレート制限が扱われています。
エラーの返され方
2 つのレベルがあり、どちらが返されるかで、修正すべきなのが引数かデータかがわかります。
- 引数が正しくない場合は、コード
-32602、data.code = "invalid_arguments"の JSON-RPC エラーが返されます。該当するのは、存在しないツール、ツールが受け付けない引数名、宣言されたenumの範囲外の値、宣言されたmaxLength／maxItems／maximumを超える値です。これらはすべて、すでに手元にあるinputSchemaで宣言されているため、クライアントは問い合わせなくても修正できます。 - それ以外の場合は、
isError: trueを含むツール結果と、content内のメッセージが返されます。たとえば、存在しない行、データベースに保存できない値、そのツールが含まれていないプラン、1 日あたりの上限などです。
どちらも HTTP 200 です。トランスポートでは、リクエストごとに JSON オブジェクトをちょうど 1 つ返す必要があるためです。宣言された上限を超える値は、拒否され、短縮されません。たとえば、5000 文字のメモは最初の 2000 文字だけが保存されるのではなく、上限が示されて拒否されるため、保存されるのは送信した内容そのものです。
アカウント
| ツール | プラン | 説明 |
|---|---|---|
account_list | Trial / Pro | ユーザーの取引口座（id / name / type / is_active / FIFO と LIFO の別）を一覧表示します。is_active フラグは、ダッシュボードでアクティブな口座を示します。... |
settings_get | Trial / Pro | 規律チェックと週次ダイジェストで適用される口座単位の上限（資金、1 回の取引あたりのリスク、1 日および 1 週間の損失上限、月間目標、オーバーナイトポジションが許可されているかどうか、タイムゾーン）を読み取ります。パーセンテージは、口座通貨での risk_per_trade_amount とともにパーセンテージとして返されます。読み取り専用です。これらはコネクター経由では変更できません。また、戦略ツールの risk_per_trade は戦略ごとの注釈であり、この予算には影響しません。 |
添付ファイル
| ツール | プラン | 説明 |
|---|---|---|
attachment_upload_link_create | Trial / Pro | スクリーンショット用の、1 回限りで有効期限 10 分のブラウザーアップロードリンクを作成します。ユーザーが、エンコードできない、または URL を取得できない画像データを共有した場合に使用します。... |
ブローカー同期
| ツール | プラン | 説明 |
|---|---|---|
broker_sync_trigger | Trial / Pro | 既存のブローカー接続（Bybit、Alpaca、Binance など）で同期を手動で開始します。最新の約定を取得し、FIFO 方式で買い／売りのレッグをペアにして、通常の... |
デイリーブリーフィング
| ツール | プラン | 説明 |
|---|---|---|
briefing_get | Trial / Pro | 市場カテゴリー（gbpusd、eurusd、forex、general、crypto）のキャッシュ済みデイリー AI ブリーフィングを読み取ります。ブリーフィングがない場合は {briefing: null} を返します。... |
経済イベント
| ツール | プラン | 説明 |
|---|---|---|
econ_analysis_get | Trial / Pro | event_id で指定した経済カレンダーイベント 1 件のキャッシュ済み AI 分析を読み取ります。そのイベントについて AI の処理結果がない場合は {analysis: null} を返します。... |
econ_analysis_list | Trial / Pro | キャッシュ済みの経済イベント AI 分析を新しい順に一覧表示します。省略可能な symbol は、pairs_affected に対して大文字と小文字を区別しない部分一致で絞り込みます。u... |
ジャーナル
| ツール | プラン | 説明 |
|---|---|---|
journal_attachment_list | Trial / Pro | ユーザーのジャーナルエントリーに添付されたスクリーンショットをすべて一覧表示します。各添付ファイルの ID、公開 URL、キャプション、MIME タイプ、アップロード日時を返します。 |
journal_attachment_upload | Trial / Pro | ユーザーのジャーナルエントリーにスクリーンショットを添付します。推奨される方法（優先順）：1. ユーザーが画像の HTTPS URL を共有した場合（Tra... |
journal_entry_get | Trial / Pro | 特定の日付のジャーナルエントリーを読み込みます（該当するものがない場合は null を返します）。 |
journal_entry_list | Pro Plus | 日付範囲内のジャーナルエントリーを一覧表示します。Pro Plus 専用です。 |
journal_entry_search | Trial / Pro | ユーザー自身のジャーナルエントリーを単語またはフレーズで検索します。複数の単語は AND 検索されます。フレーズを順序どおりに一致させるには、二重引用符で囲みます。検索... |
journal_entry_upsert | Trial / Pro | 日付のジャーナルエントリーを作成または更新します。必須：日付（YYYY-MM-DD）。6 つの Markdown セクションのうち任意のものを指定できます。指定しないセクションは変更されません... |
journal_planned_playbook_clear | Trial / Pro | カレンダー上の1日について、予定されているプレイブックをすべて削除します。冪等です。予定がない場合は removed_count=0 を返します。該当するものがない場合は journal_id=null を返します... |
journal_planned_playbook_set | Trial / Pro | カレンダー上の1日の朝の計画に含めるプレイブックを設定します。既存のセットをアトミックに置き換えます。再度呼び出しても冪等です。JournalEntry がない場合は作成します... |
市場データ
| ツール | プラン | 説明 |
|---|---|---|
market_heat_get | Trial / Pro | カテゴリと日付を指定して、キャッシュされた AI 市場ヒート（強気／中立／弱気）を読み込みます。briefing_get と連携し、市場ヒートはカレンダーの圧力（h... |
ニュース
| ツール | プラン | 説明 |
|---|---|---|
news_analysis_get | Trial / Pro | news_id で指定したニュース見出しのキャッシュ済み AI 分析を読み込みます。分析キャッシュはグローバル（ユーザー間で共有）なので、ほかのユーザーが作成した分析が表示されることがあります... |
news_analysis_list | Trial / Pro | キャッシュ済みの最近のニュース分析を、新しい順に一覧表示します。省略可能な symbol を指定すると、pairs_affected 列を大文字・小文字を区別せず部分一致で絞り込みます（例：'EURUS... |
パターン
| ツール | プラン | 説明 |
|---|---|---|
pattern_narrative_get | Trial / Pro | 呼び出し元の週次クロスパターン Onyx-Engine AI ナラティブを読み込みます。（ユーザー、ISO 週）ごとに1つのアーティファクトがあり、キャッシュは毎週月曜日に自動更新されます... |
pattern_recos_get | Trial / Pro | 呼び出し元の週次クロスディテクター・アクション推奨を読み込みます。pattern_narrative_get の姉妹機能で、キャッシュの更新タイミングは同じですが、出力は厳密なリストです... |
プレイブック
| ツール | プラン | 説明 |
|---|---|---|
playbook_create | Trial / Pro | エントリー／エグジット条件を設定した新しい戦略プレイブックを作成します。必須：名前（最大80文字）。description / rules / entry_criteria / exit_criteria は任意です... |
playbook_delete | Trial / Pro | プレイブックをソフト削除します（active=false に設定）。過去の取引への紐付けは保持され、プレイブックがアクティブな選択肢から非表示になるだけです。冪等です。 |
playbook_list | Trial / Pro | ユーザーの戦略プレイブックを一覧表示します。省略可能な account_id を指定すると、そのアカウントで表示可能なプレイブック（グローバルなものとそのアカウントのもの）に絞り込みます。省略するとすべ... |
playbook_update | Trial / Pro | 既存のプレイブックを変更します。必須：playbook_id。省略されたフィールドは変更されません。active=false を指定すると、履歴を失わずにアーカイブできます（同じ... |
統計
| ツール | プラン | 説明 |
|---|---|---|
stats_summary | Pro Plus | 直近の期間（デフォルトは30日）におけるパフォーマンス統計を集計します：勝率、期待値、合計。tag_ids を指定すると、該当するタグのいずれかが付いた取引にすべての数値を絞り込めます。また、月を指定するには date_from / date_to を使用します。Pro Plus 限定です。 |
tag_performance_get | Pro Plus | 決済済み取引について、タグごとのパフォーマンスを取得します：取引数、勝率、損益（グロスおよびネット）、プロフィットファクター、平均利益、平均損失、期待値。「実際に利益を生んでいるセットアップはどれか」という質問に答えます。タグにはサンプル数が必要なため、デフォルトでは全履歴が対象です。決済済み取引が min_trades（デフォルトは5）未満のタグも、除外されず、数値なしで名前が返されます。2つのタグが付いた取引は両方に計上されるため、各行の合計は口座全体の結果と一致しません。Pro Plus 限定です。 |
ストラテジー
| ツール | プラン | 説明 |
|---|---|---|
strategy_create | Trial / Pro | 名前付きストラテジーを新規作成します。ユーザーが最初に作成したストラテジーは自動的にデフォルトになります（新規取引とインポートに割り当てられます）。すべてのペイロードフィールドは... |
strategy_delete | Trial / Pro | ストラテジーを完全に削除します。そのストラテジーが付いた取引の strategy_id は NULL にリセットされます（履歴は保持されます）。削除した行がデフォルトだった場合、次の... |
strategy_list | Trial / Pro | ユーザーの名前付き取引ストラテジー（例：'Forex-Swing'、'Crypto-Scalp'）を一覧表示します。各行には、説明 / 優位性 / セットアップ / 注目シンボル / ルール /... が含まれます。 |
strategy_set_default | Trial / Pro | ストラテジーをユーザーのデフォルトとして設定します。新規取引とインポートには、デフォルトが自動的にタグ付けされます。他のすべてのストラテジーの is_default はオフになります。 |
strategy_update | Trial / Pro | 名前付きストラテジーを変更します。strategy_id と、ペイロードフィールドの任意の組み合わせを渡します。指定したリスト（setups、symbols_focus、rules、trading_hours）は保存済みの内容を置き換えるため、保持するすべての項目を送信してください。フィールドを省略すると、そのフィールドは変更されません。このため、このツールには destructiveHint: true の注釈が付いていますが、strategy_create には付いていません。フィールドを編集すると、参照していた AI コンテキストのキャッシュが無効になります... |
タグ
| ツール | プラン | 説明 |
|---|---|---|
tag_create | Trial / Pro | ユーザーのライブラリに新しいタグを作成します。必須：name（最大40文字）。名前が同じ場合は冪等で、タグがすでに存在するときは created=false とともに既存の行を返します。 |
tag_delete | Trial / Pro | タグを完全に削除します。取引にタグが付いたままの場合は削除を拒否し、エラーメッセージに削除を妨げている紐付けの数が示されます。 |
tag_list | Trial / Pro | ユーザーのタグ（セットアップ / ミス / 心理 / カスタム）を一覧表示します。 |
tag_update | Trial / Pro | タグの名前、カテゴリ、または色を変更します。必須：tag_id。更新されたフィールドを updated_fields として返すため、呼び出し元はどのキーが保存されたかを確認できます。エラー時には '... |
取引
| ツール | プラン | 説明 |
|---|---|---|
trade_ai_analysis_get | Trial / Pro | ユーザーの取引のうち1件について、キャッシュされたコーチ形式のAI分析を読み取ります。分析は取引ごとに1回のみです。ダッシュボードから一度書き込まれると、すべての再... |
trade_attachment_list | Trial / Pro | ユーザーの取引1件に添付されたスクリーンショットをすべて一覧表示します。各添付ファイルについて、id、公開URL、キャプション、MIMEタイプ、アップロード日時を返します。 |
trade_attachment_upload | Trial / Pro | ユーザーの取引1件にスクリーンショットを添付します。推奨される方法（優先順位順）：1. ユーザーが画像のHTTPS URLを共有した場合（TradingView... |
trade_create | Trial / Pro | 取引（オープンまたはクローズ）を手動で登録します。必須項目：symbol、trade_type、volume、open_price。trade_typeには「BUY」または「SELL」（大文字）を指定してください。open_ti... |
trade_delete | Trial / Pro | 手動またはこのコネクター経由で記録された取引を、レビュー、タグ、添付ファイル、AI分析とともに削除します。ブローカーからインポートされた取引は削除できません。次回の同期時に、再び明細書と照合されるためです。値を誤って入力した取引を取り消す場合に使用してください。gross_plは後から編集できません。 |
trade_get | Trial / Pro | ユーザーが所有する取引1件の詳細を取得します。 |
trade_list | Pro Plus | ユーザーの取引を一覧表示します。日付範囲、symbol、タグ（tag_ids、いずれかに一致）、方向（trade_type）、またはオープン／クローズ状態で絞り込めます。最大limit件（デフォルト100件、最大500件）を、open_time...の順に並べて返します。 |
trade_review_update | Trial / Pro | 取引後レビューを作成または更新します。必須項目：trade_id。よくある間違い：mood_before/mood_afterには、列挙値の文字列（「calm...」など）ではなく、1～5の整数を指定してください。 |
trade_update | Trial / Pro | 既存の取引でユーザーが変更できるフィールドを編集します：sl、tp、comment、external_url、playbook_id、strategy_id、target_rr、mfe_price、mae_price。また、オープンポジションをクローズします。まだオープンでブローカーからインポートされていない取引に対し、close_priceとclose_timeを同時に指定してください。銘柄の価格が口座通貨建ての場合、2つの価格からgross_plが算出されます。ブローカーが管理するフィールド（gr...） |
取引ルール
| ツール | プラン | 説明 |
|---|---|---|
trading_rule_create | Trial / Pro | 規律／取引ルールを新規作成します。必須項目：text（ルールのラベル、最大200文字）。account_idを指定するとルールを1つの口座に限定できます。省略... |
trading_rule_delete | Trial / Pro | ユーザーの取引ルールを1件削除します。ルール違反の記録もすべて削除されます。ジャーナルのルール違反エントリーはルールに連動して削除されるためです。履歴を残したままルールの適用をやめるには、代わりにtrading_rule_updateでactive=falseを設定してください。 |
trading_rule_list | Trial / Pro | ユーザーの規律／取引ルールを一覧表示します。account_idを指定すると、その口座で表示されるルール（全体共通＋その口座のルール）に絞り込まれます。 |
trading_rule_update | Trial / Pro | 取引ルールを変更または無効化します。必須項目：rule_id。active=falseを指定すると論理削除されます（選択リストからは消えますが、履歴は保持されます）。account_... |
週間ダイジェスト
| ツール | プラン | 説明 |
|---|---|---|
weekly_digest_get | Trial / Pro | 呼び出し元の週間AIダイジェストを1件読み取ります。ダイジェストは、日曜日の夜に作成される編集者による600～800語のブリーフィングです。weekにはISO形式の月曜日の日付を指定します（例...）。 |
プラン
| 無料 | 無料、トライアル中 | Pro | Pro Plus | |
|---|---|---|---|---|
| コネクターへのアクセス | いいえ | はい、7 日間、アカウントごとに 1 回 | はい | はい |
| 1 日あたりのツール呼び出し回数 | — | 30 | 150 | 2000 |
| ログ記録およびジャーナルツール | — | はい | はい | はい |
一括集計（trade_list、journal_entry_list、stats_summary、tag_performance_get） | — | いいえ | いいえ | はい |
| ウェブアプリでのジャーナル、ブローカーからのインポート、税務エクスポート | はい | はい | はい | はい |
無料アカウントでは、設定 → 連携からコネクターのトライアルを 1 回開始できます。開始前および 利用期間終了後は、コネクターはすべての呼び出しに対し、何をすべきかを明示した拒否を返します。空の結果は返しません。ウェブアプリは引き続き無料で利用できます。
料金と現在の上限は料金ページをご覧ください。
プライバシーとセキュリティ
- サーバーはドイツにあり、ジャーナルと取引データは EU 内に保管されます。AI 機能では、分析対象のテキストが米国の処理業者に送信されます。 すべての処理業者はプライバシーポリシーに記載されており、 これが正式な一覧です。
- トークンは SHA-256 ハッシュとして保存されます。生の値が存在するのはクリップボード上だけです。
- すべてのツールは、認証済みユーザーを通じてデータを取得します。トークンは、必ずそのトークンに紐づくアカウントにアクセスします。
- TradeOnyx アカウントを削除すると、リクエストのアクセスログを含む関連データが消去されます。
セキュリティ上の問題を発見した場合は、公開のイシューを作成せず、 security.txt （[email protected]）に記載されたアドレスへ非公開でご報告ください。
リンク
免責事項
TradeOnyx は、記録および分析のためのツールです。投資助言や投資仲介を提供せず、取引シグナルも生成しません。金融商品の取引により、投資した資金をすべて失う可能性があります。
ライセンス
このリポジトリのドキュメントは MIT ライセンスです。TradeOnyx 自体は商用製品であり、オープンソースではありません。
コメント
Markdown 対応
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。