MT5開発依頼前に用意する資料まとめ｜仕様書・setファイル・ログ・スクリーンショット

MT5のEA・インジケーター開発や既存改修を依頼する前には、仕様書、setファイル、Expertsログ、Journalログ、スクリーンショット、再現条件を整理しておくことが重要です。

開発相談では、「EAを作りたい」「インジケーターを直したい」「通知を追加したい」「動かない原因を見てほしい」という内容だけでは、確認範囲が広くなります。対象ファイル、現在の設定、発生している症状、希望する動作、ログ、画面状態が分かると、確認すべき箇所を絞りやすくなります。

この記事では、MT5開発依頼前に用意したい資料を、仕様書、setファイル、Expertsログ、Journalログ、スクリーンショット、不具合調査、外部連携、送信しない方がよい情報、相談前に確認する関連ページに分けて整理します。

なお、この記事はMT4/MT5、MQL4/MQL5、EA、インジケーター、コピーEA、通知・診断・補助ツールの導入、設定、確認、検証、不具合調査、開発依頼前整理を目的とした技術記事です。投資助言、売買指示、利益保証、勝率保証、損失回避保証、推奨ロット、推奨銘柄、推奨エントリー、特定ブローカー誘導を目的としたものではありません。

この記事で確認すること

開発依頼前に資料を整理する理由

開発依頼前に資料を整理しておくと、見積範囲、確認範囲、実装範囲、検証範囲を分けやすくなります。

同じ「MT5開発」でも、新規EA作成、既存EA改修、インジケーター作成、Discord通知追加、Google Sheets連携、コピーEA、ログ追加、不具合調査では必要な情報が異なります。

また、不具合調査では再現条件が重要です。「動かない」「通知が届かない」「注文しない」だけでは、EA本体、MT5設定、setファイル、ログ、外部連携、VPS、ブローカー側応答のどこを見るべきか判断しにくくなります。

最初に用意したい基本資料

開発依頼や既存改修では、まず対象ファイルと利用環境を明確にします。似た名前のEAや複数バージョンがある場合は、どのファイルが現在の確認対象なのかを分けてください。

既存EAや既存インジケーターを改修する場合は、原則としてソースコードの有無を確認してください。`ex4` や `ex5` のみの場合、内部処理を直接確認できないため、仕様を再整理して作り直す扱いになる場合があります。

仕様書に書くこと

仕様書には、目的、動作条件、ON/OFF、対象銘柄、時間足、表示、通知、発注、決済、ログ、外部連携の有無を整理します。

EA、インジケーター、コピーEA、通知ツール、診断補助ツールでは必要な仕様が異なります。どこまでを自動化し、どこからを利用者が確認するのかを分けることが重要です。

ON/OFF設定が多すぎると、利用者側で設定を誤りやすくなります。実際に操作する項目、固定でよい項目、AdminDev用に残す項目、UserLiveでは非表示にする項目を分けて整理すると確認しやすくなります。

setファイルを送る時の注意点

setファイルは、EAやインジケーターのInputs設定を保存したファイルです。ロット、Magic Number、取引時間、通知設定、WebRequest設定、ログ設定、外部連携設定などが含まれる場合があります。

setファイルを送る場合は、現在使用中のset、変更前のset、変更後のset、検証用setを分けて保存してください。どのsetが現在の確認対象なのか分かるようにしておくと、不具合調査や再現確認が進めやすくなります。

setファイルだけでEAやインジケーターの内部仕様が分かるわけではありません。エントリー条件や決済条件がソースコード内に固定されている場合、setファイルには表示されないことがあります。

ExpertsログとJournalログを整理する

ExpertsログとJournalログは、不具合調査や既存改修で重要です。EAやインジケーター側の動作を見る場合はExpertsログ、MT5端末やサーバー応答を見る場合はJournalログを確認します。

ログを送る時は、該当行だけでなく、発生時刻前後の流れが分かる範囲を残してください。エラー行の直前に設定読込エラー、認証エラー、WebRequest失敗、初期化失敗が出ている場合があります。

ログ量が多い場合は、発生時刻、最初に出たエラー、繰り返し出ている行、直前に行った操作をまとめると確認しやすくなります。

スクリーンショットで残すべき画面

スクリーンショットは、設置状態、表示状態、設定状態、ログ表示を確認するために役立ちます。ただし、口座番号、Webhook URL、APIキー、認証トークンなどが映り込まないように注意してください。

不具合調査で必要な情報

不具合調査では、発生時刻、再現手順、変更前後、使用環境、ログ、スクリーンショットを整理してください。

「いつから動かないか」「どの操作の直後に起きたか」「設定変更後に起きたか」「VPS移行後に起きたか」「時間足変更後に起きたか」などを分けると、原因候補を絞りやすくなります。

依頼内容別に用意する資料

依頼内容によって必要な資料は変わります。新規EA作成、インジケーター作成、既存改修、外部連携追加、不具合調査、コピーEA相談で、確認する資料を分けてください。

ファイル名の付け方

資料を送る場合は、ファイル名に日付、用途、対象EA名、銘柄、変更前後が分かる情報を入れておくと確認しやすくなります。

長すぎるファイル名にする必要はありませんが、後から見ても「何の資料か」「いつの資料か」「どの状態の資料か」が分かるようにしてください。

送らない方がよい情報

安全管理のため、以下の情報はそのまま送らないでください。ログ、スクリーンショット、setファイル、設定資料に含まれる場合は、必要に応じてマスクしてください。

相談前に確認する関連ページ

開発依頼前の資料整理では、仕様書、setファイル、ログ、診断、開発相談、不具合報告を分けて確認すると整理しやすくなります。

よくある質問

仕様書がない状態でも相談できますか？

相談は可能です。ただし、仕様書がない場合は、目的、対象ファイル、希望する動作、現在の動作、ログ、スクリーンショットなどを分かる範囲で整理してください。内容が曖昧な場合は、まず仕様整理から進める形になります。

ex5ファイルだけでも改修できますか？

通常、ex5のみでは内部ロジックを直接改修できません。mq5やmqhなどのソースコードがあるか確認してください。ソースがない場合は、仕様を聞き取りながら再作成する形になる場合があります。

setファイルだけ送れば原因が分かりますか？

setファイルだけでは不十分な場合があります。EA名、バージョン、銘柄、時間足、発生時刻、Expertsログ、Journalログ、スクリーンショット、再現手順も合わせて整理してください。

ログはどの範囲を送ればよいですか？

発生時刻前後を中心に、エラー行だけでなく前後の流れが分かる範囲を残してください。初期化時点のエラー、設定読込、認証、WebRequest失敗、注文前チェックが原因になる場合があります。

Webhook URLやAPIキーは送ってよいですか？

原則として実値は送らないでください。必要な場合でも、先頭・末尾以外を伏せる、ドメインだけ残す、サービス名だけ伝えるなど、共有範囲を絞ってください。

まとめ

MT5開発依頼前には、仕様書、対象ファイル、setファイル、Expertsログ、Journalログ、スクリーンショット、再現条件を整理しておくと、確認範囲や見積範囲を分けやすくなります。

新規EA作成、インジケーター作成、既存改修、外部連携追加、不具合調査、コピーEA相談では、必要な資料が異なります。依頼内容に合わせて、希望する動作、現在の動作、設定、ログ、画面状態を整理してください。

Webhook URL、GAS URL、APIキー、認証トークン、口座番号、個人情報などは、そのまま送らないようにしてください。技術確認に必要な情報と、共有すべきでない情報を分けて整理することが重要です。