This guide is for local testing and experimentation only. For production integrations, see the Implementation Guide for complete examples with OpenAI and Anthropic.
Desktop chat clients like Claude Desktop provide an easy way to test MCP capabilities and experiment with health data queries locally.

Claude Desktop Setup

Download Claude Desktop from https://claude.ai/download.

Step 1: Install MCP Proxy

Install the open-source MCP proxy tool:
brew install mcp-proxy

Step 2: Configure Claude Desktop

  1. Open Claude Desktop and navigate to SettingsDeveloper
  2. Click the button to edit the configuration file
Claude config menus
  1. Add the following configuration to the file (replace <SPIKE_ACCESS_TOKEN> with your actual token):
{
  "mcpServers": {
    "mcp-proxy": {
      "command": "mcp-proxy",
      "args": [
        "-H",
        "Authorization",
        "Bearer <SPIKE_ACCESS_TOKEN>",
        "--transport",
        "streamablehttp",
        "https://app-api.spikeapi.com/v3/mcp"
      ]
    }
  }
}
  1. Save the file and restart Claude Desktop

Step 3: Test the Connection

Try a simple query to verify everything is working:
How well did I sleep last night?
You should see the query_sleep tool being used and may be prompted for approval:
Claude config menus
Allow the connection to get personalized results based on your JWT token:
Claude config menus

Next Steps

For production integrations and complete implementation examples, see the Implementation Guide which includes:
  • Complete OpenAI integration examples (Python, Go, Node.js, cURL)
  • Anthropic/Claude integration examples
  • Authentication setup
  • Error handling
  • Available MCP tools and endpoints