Claude Desktop

Overview

This guide shows you how to integrate Kirha with Claude Desktop, enabling your AI assistant to access real-time data sources using Model Context Protocols (MCPs) and Kirha's premium data platform.

Prerequisites

  • Claude Desktop installed on your system

  • A Kirha account (sign up at app.kirha.ai)

  • Node.js installed (for the MCP remote package)

  • Basic familiarity with JSON configuration

Step 1: Get Your Kirha API Key

  1. Log into Kirha Dashboard

  2. Access API Keys Section

    • Click on "API Keys" in the sidebar

    • You'll see any existing API keys you've created

  1. Create a New API Key

  • Click the "Create API Key" button

  • Enter a descriptive name (e.g., "Claude Desktop Integration")

  • Set an appropriate expiration date for security

  • Click "Create"

  1. Copy Your API Key

  • Important: Copy the API key immediately as it won't be shown again

  • Store it securely - you'll need it for the configuration

Step 2: Configure Claude Desktop

Important: Close Claude Desktop First

Before making any configuration changes, ensure Claude Desktop is completely closed. The application only reads the configuration file during startup.

Locate Configuration File

The Claude Desktop configuration file is located at:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%/Claude/claude_desktop_config.json

  • Linux: ~/.config/Claude/claude_desktop_config.json

Update Configuration

Edit the configuration file and add the following MCP server configuration:

{
  "mcpServers": {
    "kirha": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.kirha.ai/mcp",
        "--header",
        "Authorization: Bearer ${API_KEY}"
      ],
      "env": {
        "API_KEY": "your-actual-api-key-here"
      }
    }
  }
}

Replace your-actual-api-key-here with the API key you copied from Step 1.

Configuration Explanation

  • kirha: The name identifier for this MCP server

  • command: Uses npx to run the MCP remote package

  • args: Contains the Kirha MCP endpoint and authorization header

  • env: Environment variables, including your secure API key

Step 3: Install Required Dependencies

The configuration uses the mcp-remote package to connect to Kirha's remote MCP server:

npm install -g mcp-remote

Note: In the future, Claude Desktop will support direct remote MCP connections, eliminating the need for this intermediate package.

Step 4: Test the Integration

  1. Start Claude Desktop

    • Launch Claude Desktop

    • Wait for it to fully load

  2. Verify Connection

    • Look for any MCP connection indicators in the interface

    • The connection should establish automatically

  3. Test with Sample Queries

    Try these example queries to test your integration:

    Crypto/Blockchain Data:

    What is the current balance of vitalik.eth?

    Real-time Prices:

    What's the current price of Bitcoin?

Troubleshooting

Connection Issues

Problem: Claude Desktop doesn't connect to Kirha Solutions:

  • Verify your API key is correct and not expired

  • Ensure Claude Desktop was restarted after configuration changes

  • Check that mcp-remote is installed globally

  • Verify your internet connection

Problem: "Unauthorized" errors Solutions:

  • Double-check your API key in the configuration

  • Ensure the API key hasn't expired

  • Verify the API key has the correct permissions

Configuration Problems

Problem: JSON syntax errors Solutions:

  • Validate your JSON using a JSON validator

  • Ensure all quotes are properly escaped

  • Check for missing commas or brackets

Problem: Claude Desktop won't start Solutions:

  • Revert to a backup of your configuration file

  • Start with a minimal configuration and add complexity gradually

  • Check Claude Desktop logs for specific error messages

Security Best Practices

  1. API Key Management

    • Set appropriate expiration dates for API keys

    • Rotate keys regularly

    • Never commit API keys to version control

    • Use different keys for different environments

  2. Configuration Security

    • Don't share configuration files containing API keys

    • Use environment variables when possible

Usage Examples

Basic Crypto Query

User: What's the current price of Ethereum?
Claude: [Uses Kirha MCP] The current price of Ethereum is $2,145.67 USD, up 3.2% in the last 24 hours.

Wallet Balance Check

User: Check the balance of example.eth
Claude: [Uses Kirha MCP] The wallet example.eth (0x742d35Cc6Ab6...) currently holds 15.4 ETH and various tokens including 1,250 USDC.

Market Analysis

User: Compare Bitcoin and Ethereum performance today
Claude: [Uses Kirha MCP] Today's performance: Bitcoin is up 1.8% at $43,250, while Ethereum gained 3.2% to $2,145. Ethereum is outperforming Bitcoin by 1.4 percentage points.

What's Next?

We're continuously working to make AI-data integration even simpler:

  • Direct Remote MCP Support: When Claude Desktop adds native remote MCP support, we'll update this guide

  • More Data Sources: New premium APIs and databases are added regularly

  • Enhanced Security: Additional authentication and authorization options

  • Performance Improvements: Faster response times and better caching

Previousn8nNextZapier

Last updated