Connect Claude
Two ways to connect. Most subscribers should use Claude.ai in the browser: nothing to install, done in a couple of minutes, works on all Claude plans including Free. Claude Desktop needs a settings file edited and is best if you've done that kind of thing before.
You'll need your API key. It's the long string starting with jfs_ in the onboarding email the founder sends within 24 hours of your subscription. Copy it rather than retyping it. Haven't received it yet? Email data@japanfinsight.com.
Claude.ai (in your browser)
Works on all Claude plans, including Free. Free accounts can add one custom connector, and Free-plan usage limits still apply.
- In Claude.ai, open Settings, then Connectors, then Add custom connector.
- In the Server URL field, paste:
https://mcp.edinet.tools/mcp?api_key=YOUR_API_KEY
ReplaceYOUR_API_KEYwith your key. The connector form has no separate field for an API key, which is why the key goes in the URL. - Leave the OAuth fields blank and save. There is no separate sign-in step. Japan Finsight now shows in your connector list.
- Open a new conversation. The tools are available to Claude automatically.
That's the whole setup. Jump to Verify below to confirm it works.
Because the key sits in a URL, you can have it replaced anytime. Email data@japanfinsight.com and a fresh key goes out.
Claude Desktop (the installed app)
This route means editing one settings file by hand. If that's not familiar territory, use Claude.ai above instead. Same data, same tools.
- Locate your Claude Desktop config:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
In Finder, choose Go, then Go to Folder, and paste the path. - Windows:
%APPDATA%\Claude\claude_desktop_config.json
Paste the path into the File Explorer address bar.
- macOS:
- Open the file in a plain-text editor (TextEdit on macOS, Notepad on Windows). If the file doesn't exist or is empty, paste the whole block below and replace the key. If it already has content, the easiest safe path is to paste your existing file and the block below into Claude and ask it to merge them.
{
"mcpServers": {
"japan-finsight": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.edinet.tools/mcp",
"--header",
"Authorization:${AUTH_HEADER}"
],
"env": {
"AUTH_HEADER": "Bearer your-api-key-from-onboarding-email"
}
}
}
}
AUTH_HEADER is the word Bearer, a space, then your API key from the onboarding email. Keep the "Authorization:${AUTH_HEADER}" entry exactly as written, with no spaces: some clients mangle spaces inside args entries, so the key rides in the environment variable instead.
- Save the file, then quit Claude Desktop completely and reopen it. On macOS press Cmd-Q; closing the window is not enough. On Windows, make sure the app has fully exited (quit it from the system tray icon if it keeps running in the background).
- Open a new conversation. You should see Japan Finsight in Claude's tools list.
Verify the connection
Try this prompt in Claude:
"Use Japan Finsight to find the latest annual financials for Toyota."
Claude should visibly call Japan Finsight tools while answering and come back with a multi-year financial summary. If Claude answers instantly from general knowledge, or says it doesn't have that tool, the connection isn't active. See Troubleshooting below.
Once it works, ask the kind of question the connection is actually for:
"Which companies announced a buyback this year while an activist investor held a 5%+ stake?"
That's one question across every buyback filing and every large-shareholder filing in the record. It's what this data is built to do.
Troubleshooting
- Connector stuck on "checking connection" (Claude.ai): refresh the browser page. The connector has usually connected fine and the spinner is stale.
- Tools don't appear after editing the config: Fully quit Claude Desktop (Cmd-Q on macOS: closing the window isn't enough), then reopen.
- "Authentication failed": check the key against your onboarding email. Keys are case-sensitive, so copy and paste rather than retyping. Need a fresh one? Email data@japanfinsight.com.
- Anything else: email data@japanfinsight.com and say which step you're on and what you see on screen. The founder answers within 24 hours.