{"id":10,"date":"2026-04-24T01:32:19","date_gmt":"2026-04-24T01:32:19","guid":{"rendered":"http:\/\/docs.traderis.me\/en\/docs\/mcp-claude-desktop-setup\/"},"modified":"2026-04-24T01:32:19","modified_gmt":"2026-04-24T01:32:19","password":"","slug":"mcp-claude-desktop-setup","status":"publish","type":"docs","link":"https:\/\/docs.traderis.me\/en\/docs\/mcp-claude-desktop-setup\/","title":{"rendered":"Access Your Trade Data from Claude Desktop via MCP"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">This guide explains how to reference and analyze your TraderIsMe trade data directly from an AI chat client like Claude Desktop, using <strong>MCP (Model Context Protocol) integration<\/strong>. All you need to do is issue a single API key and paste it into Claude Desktop&#8217;s config file \u2014 then you can hand your trade history to the AI in natural language, with prompts like &#8220;Analyze my USDJPY trades from last month&#8221; or &#8220;What time of day has the highest win rate?&#8221;<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">MCP integration is <strong>free on every plan<\/strong>, including the Basic plan.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">What You Can Do with This Guide<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Retrieve TraderIsMe trade data from Claude Desktop using natural language<\/li>\n<li>List your accounts, select an account, and pull filtered trade history<\/li>\n<li>Since history is handed directly to the AI, you can run any analysis the UI does not expose<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Requirements<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>A TraderIsMe account (<a href=\"https:\/\/app.traderis.me\/\">app.traderis.me<\/a>)<\/li>\n<li><a href=\"https:\/\/claude.ai\/download\">Claude Desktop<\/a> (macOS \/ Windows)<\/li>\n<li>Node.js 18 or later (an environment where <code>npx<\/code> can run) \u2014 available at <a href=\"https:\/\/nodejs.org\/\">nodejs.org<\/a><\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Step 1: Issue an MCP API Key<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Log in to TraderIsMe and open &#8220;<strong>Settings<\/strong>&#8221; in the left sidebar.<\/li>\n<li>Open the &#8220;<strong>MCP Integration<\/strong>&#8221; section on the page and click &#8220;<strong>Generate API Key<\/strong>.&#8221;<\/li>\n<li>Click the &#8220;<strong>Copy<\/strong>&#8221; button to the right of the generated MCP API key to copy it.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">The MCP API key is a <strong>different key<\/strong> from the &#8220;account identifier API key&#8221; used by the Data Sync EA or the &#8220;account API key&#8221; used by feature EAs. Manage it separately as dedicated to MCP integration. If the key leaks, you can invalidate it with the &#8220;Regenerate&#8221; button on the same screen (regeneration immediately invalidates the previous key).<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Step 2: Add It to the Claude Desktop Config File<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Claude Desktop loads external MCP servers via a config file called <code>claude_desktop_config.json<\/code>. Its location by OS is:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table>\n<thead><tr><th>OS<\/th><th>Config file location<\/th><\/tr><\/thead>\n<tbody>\n<tr><td>macOS<\/td><td><code>~\/Library\/Application Support\/Claude\/claude_desktop_config.json<\/code><\/td><\/tr>\n<tr><td>Windows<\/td><td><code>%APPDATA%\\Claude\\claude_desktop_config.json<\/code><\/td><\/tr>\n<\/tbody>\n<\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">When you issue a key in the &#8220;MCP Integration&#8221; section of the TraderIsMe settings screen, a ready-to-paste JSON snippet is auto-generated below it. Click &#8220;Copy&#8221; and paste it into the config file above.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The snippet looks like this (the MCP API key issued in Step 1 is automatically filled into the <code>YOUR_API_KEY<\/code> placeholder):<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>{\n  \"mcpServers\": {\n    \"traderisme\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"traderisme-mcp\"],\n      \"env\": {\n        \"TRADERISME_API_KEY\": \"YOUR_API_KEY\"\n      }\n    }\n  }\n}<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">If you have already registered other MCP servers (e.g., filesystem, github), merge the <code>\"traderisme\": { ... }<\/code> entry into the existing <code>mcpServers<\/code> object. A JSON syntax error will prevent Claude Desktop from loading MCP servers, so watch your commas carefully.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Step 3: Restart Claude Desktop and Verify<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">After saving the config file, fully quit and relaunch Claude Desktop. On first launch, <code>npx -y traderisme-mcp<\/code> downloads the package, which can take tens of seconds.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">After it starts, look at the tools list in the input area (the \ud83d\udd27 icon). If a <strong>traderisme<\/strong> server appears with the following tools registered, the connection is successful:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table>\n<thead><tr><th>Tool name<\/th><th>Purpose<\/th><\/tr><\/thead>\n<tbody>\n<tr><td><code>get-accounts<\/code><\/td><td>List registered trading accounts<\/td><\/tr>\n<tr><td><code>select-account<\/code><\/td><td>Select the active account for the session (target of other tools)<\/td><\/tr>\n<tr><td><code>get-trades<\/code><\/td><td>Fetch trade history for the selected account (filter by symbol \/ period \/ direction \/ count)<\/td><\/tr>\n<\/tbody>\n<\/table><\/figure>\n\n\n\n<p class=\"wp-block-paragraph\">Try talking to the chat window like this:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>&#8220;Show me my registered accounts&#8221; \u2192 <code>get-accounts<\/code> is called and returns the account list<\/li>\n<li>&#8220;Select account ID 1&#8221; \u2192 <code>select-account<\/code> locks the target account<\/li>\n<li>&#8220;Give me 100 USDJPY trades from last month&#8221; \u2192 <code>get-trades<\/code> filters by period and symbol<\/li>\n<li>&#8220;From this history, break down win rate by day of the week&#8221; \u2192 the AI can analyze the fetched history freely<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Troubleshooting<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>traderisme does not appear in the tools list<\/strong> \u2014 Possible JSON syntax error in the config file, or Claude Desktop was not restarted. Validate the file with a JSON validator and fully quit Claude Desktop (Cmd+Q \/ quit from the task tray) before relaunching.<\/li>\n<li><strong>&#8220;Authentication error&#8221; or &#8220;Invalid API key&#8221; is returned<\/strong> \u2014 Regenerate the MCP API key from the settings screen and replace <code>TRADERISME_API_KEY<\/code> in <code>claude_desktop_config.json<\/code> with the new key.<\/li>\n<li><strong><code>npx: command not found<\/code><\/strong> \u2014 Node.js is not installed. Install the LTS version from <a href=\"https:\/\/nodejs.org\/\">nodejs.org<\/a>.<\/li>\n<li><strong>Accounts list works, but trades come back empty<\/strong> \u2014 First check that you have selected an account with <code>select-account<\/code>. Without selection, <code>get-trades<\/code> returns empty. Also check that the account has any synced trade history (verify your Data Sync EA setup).<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\">Related Documents<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/docs.traderis.me\/en\/docs\/mt-data-sync-setup\/\">Set Up MT4\/MT5 Data Sync<\/a> \u2014 How to auto-sync the trade data referenced via MCP<\/li>\n<\/ul>\n\n","protected":false},"excerpt":{"rendered":"<p>This guide explains how to reference and analyze your TraderIsMe trade data directly from an AI chat client li &#8230; <a title=\"Access Your Trade Data from Claude Desktop via MCP\" class=\"read-more\" href=\"https:\/\/docs.traderis.me\/en\/docs\/mcp-claude-desktop-setup\/\" aria-label=\"Access Your Trade Data from Claude Desktop via MCP \u306b\u3064\u3044\u3066\u3055\u3089\u306b\u8aad\u3080\">\u7d9a\u304d\u3092\u8aad\u3080<\/a><\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"doc_category":[2],"doc_tag":[],"class_list":["post-10","docs","type-docs","status-publish","hentry","doc_category-getting-started"],"year_month":"2026-06","word_count":719,"total_views":0,"reactions":{"happy":0,"normal":0,"sad":0},"author_info":[],"doc_category_info":[{"term_name":"Getting Started","term_url":"https:\/\/docs.traderis.me\/en\/docs-category\/getting-started\/"}],"doc_tag_info":[],"_links":{"self":[{"href":"https:\/\/docs.traderis.me\/en\/wp-json\/wp\/v2\/docs\/10","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/docs.traderis.me\/en\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/docs.traderis.me\/en\/wp-json\/wp\/v2\/types\/docs"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.traderis.me\/en\/wp-json\/wp\/v2\/comments?post=10"}],"version-history":[{"count":0,"href":"https:\/\/docs.traderis.me\/en\/wp-json\/wp\/v2\/docs\/10\/revisions"}],"wp:attachment":[{"href":"https:\/\/docs.traderis.me\/en\/wp-json\/wp\/v2\/media?parent=10"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/docs.traderis.me\/en\/wp-json\/wp\/v2\/doc_category?post=10"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/docs.traderis.me\/en\/wp-json\/wp\/v2\/doc_tag?post=10"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}