# 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](https://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**
   * Navigate to [app.kirha.ai](https://app.kirha.ai/)
   * Sign in to your accountwa
2. **Access API Keys Section**
   * Click on "API Keys" in the sidebar
   * You'll see any existing API keys you've created

<figure><img src="https://2404575277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5mGf3Tb65DupazHxhlT3%2Fuploads%2Fj3g0DbiE0vnOrbKcRZ5s%2FCaptura%20de%20pantalla%202025-06-10%20a%20les%2012.45.17.png?alt=media&#x26;token=26cd5957-1001-478a-a1d2-7c71faeadbdd" alt=""><figcaption></figcaption></figure>

3. **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"

<figure><img src="https://2404575277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5mGf3Tb65DupazHxhlT3%2Fuploads%2FAKvBXUFgZwMBY1DdfoGo%2FCaptura%20de%20pantalla%202025-06-10%20a%20les%2012.49.06.png?alt=media&#x26;token=43cb7915-b0c4-40aa-941e-b8c3af915cc7" alt=""><figcaption></figcaption></figure>



4. **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:

```json
{
  "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:

```bash
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

<figure><img src="https://2404575277-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5mGf3Tb65DupazHxhlT3%2Fuploads%2FuQL0s3KUeHNtPAhZMgth%2FCaptura%20de%20pantalla%202025-06-10%20a%20les%2012.51.18.png?alt=media&#x26;token=2969da31-417c-42b2-befc-c4373536633a" alt=""><figcaption></figcaption></figure>

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
