Connect Claude

Two ways to use Japan Finsight with Claude: Claude.ai (remote MCP, no install) and Claude Desktop (local app, slightly more setup).

Claude.ai (remote MCP)

Recommended for most subscribers. Nothing to install.

Works on all Claude plans, including Free. Free accounts can add one custom connector. Free-plan usage limits still apply.

Go to Claude.ai settings → Connectors → Add custom connector
Server URL — put your API key directly in the URL (replace YOUR_API_KEY with the key from your welcome email):
https://mcp.edinet.tools/mcp?api_key=YOUR_API_KEY
Leave the OAuth fields blank. Save and connect — there's no separate sign-in step.
Tools appear in any new conversation.

The connector form has no separate field for an API key, so your key goes in the URL. You can regenerate it anytime — just email data@japanfinsight.com.

Claude Desktop (local app)

Available now. Requires editing one config file.

Locate your Claude Desktop config:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Add Japan Finsight under mcpServers:

{
  "mcpServers": {
    "japan-finsight": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.edinet.tools/mcp"],
      "env": {
        "MCP_API_KEY": "your-api-key-from-welcome-email"
      }
    }
  }
}

Quit Claude Desktop completely (Cmd-Q on macOS) and reopen.
Open a new conversation. You should see Japan Finsight tools in the tool picker.

Verify the connection

Try this prompt in Claude:

"Use Japan Finsight to find the latest annual financials for Toyota."

Claude should call find_companies("Toyota") followed by get_financials(...) and return a 7-year financial summary.

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 your API key in the welcome email. Keys are case-sensitive. Email data@japanfinsight.com if you need a fresh one issued.
Anything else: Email data@japanfinsight.com.