Skip to main content
This guide gets Claude Desktop connected to Shuriken in about 2 minutes. Once set up, you can ask Claude to scan your alpha, research tokens, check your portfolio, and trade - all from a conversation. Time required: About 2 minutes.

​
Prerequisites

  • Claude Desktop installed (available for macOS and Windows)
  • An active Claude subscription (Pro, Max, or Team)
  • A Shuriken Agent Key (create one here if you haven’t already)

​
Step-by-step setup

1

Copy your Agent Key

If you just created your key, copy it from the setup screen. It starts with sk_.If you already closed that screen, you’ll need to create a new key - keys are only shown once.
2

Open the config file

Claude Desktop stores its MCP config in a file called claude_desktop_config.json.Option A: Through Claude Desktop settings
  1. Open Claude Desktop
  2. Click the Claude menu in your system menu bar (top of screen on macOS, top of window on Windows)
  3. Select Settings
  4. Go to the Developer tab
  5. Click Edit Config
This opens the config file directly.Option B: Open the file manually
%APPDATA%\Claude\claude_desktop_config.json
Press Win+R, paste the path above, and hit Enter. If the file doesn’t exist, create it.
The full path is usually: C:\Users\YOUR_USERNAME\AppData\Roaming\Claude\claude_desktop_config.json
3

Add the Shuriken server

Paste the following into your config file. Replace YOUR_AGENT_KEY with the key you copied in step 1.If the file is empty or doesn’t exist, paste this entire block:
claude_desktop_config.json
{
  "mcpServers": {
    "shuriken": {
      "url": "https://api.shuriken.trade/mcp",
      "headers": {
        "Authorization": "AgentKey YOUR_AGENT_KEY"
      }
    }
  }
}
If you already have other MCP servers, add the "shuriken" block inside the existing "mcpServers" object:
claude_desktop_config.json
{
  "mcpServers": {
    "your-existing-server": {
      "...": "..."
    },
    "shuriken": {
      "url": "https://api.shuriken.trade/mcp",
      "headers": {
        "Authorization": "AgentKey YOUR_AGENT_KEY"
      }
    }
  }
}
Make sure there’s a comma between each server entry. Missing commas are the most common cause of connection failures.
4

Save and restart Claude Desktop

Save the file, then completely quit and reopen Claude Desktop. The MCP connection won’t activate until you restart.
On macOS, make sure to quit from the menu bar (Claude > Quit Claude), not just close the window.
5

Verify the connection

After restarting, look for an MCP tools indicator (a small hammer icon) in the bottom-right corner of the chat input box. Click it to see the available Shuriken tools.Try a test prompt:
What tokens were called in my Discord today?

What's my SOL balance?
Claude will ask for your approval before using each tool for the first time. Click Allow to let it proceed.
If you see results, you’re all set. Claude is now connected to Shuriken.

​
Troubleshooting

  • Make sure you saved the config file
  • Make sure you fully quit and restarted Claude Desktop
  • Check for JSON syntax errors (missing commas, mismatched brackets)
  • Check Claude’s logs for errors:
    • macOS: ~/Library/Logs/Claude/mcp.log
    • Windows: %APPDATA%\Claude\logs\mcp.log
  • Double-check that your Agent Key is correct (starts with sk_)
  • Make sure you included the AgentKey prefix before the key (with a space)
  • Check that the key hasn’t been revoked on the Agent Keys dashboard
If you see an error mentioning ${APPDATA} in the logs, try adding the APPDATA environment variable to your config:
claude_desktop_config.json
{
  "mcpServers": {
    "shuriken": {
      "url": "https://api.shuriken.trade/mcp",
      "headers": {
        "Authorization": "AgentKey YOUR_AGENT_KEY"
      }
    }
  }
}
This shouldn’t affect Shuriken since it’s a remote server, but it can fix issues with other MCP servers in the same config file.
This is normal. Claude Desktop asks you to approve tool usage for safety. You can click Allow for this chat to approve all tool calls in the current conversation.