Claude Desktop Setup

Connect FHIRfly to Claude Desktop using MCP.

Prerequisites

1. Claude Desktop installed
2. FHIRfly account with an MCP credential

Step 1: Create an MCP Credential

1. Go to Dashboard → Credentials
2. Click Create Credential
3. Select MCP (AI Assistant)
4. Name your credential (e.g., "Claude Desktop")
5. Copy the configuration JSON shown

Step 2: Configure Claude Desktop

macOS

1. Open Finder
2. Press Cmd + Shift + G
3. Go to: ~/Library/Application Support/Claude/
4. Open or create claude_desktop_config.json
5. Add the FHIRfly server configuration:

{
  "mcpServers": {
    "fhirfly": {
      "url": "https://api.fhirfly.io/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY"
      }
    }
  }
}

Windows

1. Open File Explorer
2. Go to: %APPDATA%\Claude\
3. Open or create claude_desktop_config.json
4. Add the same configuration as above

Step 3: Restart Claude Desktop

Close and reopen Claude Desktop to load the new configuration.

Step 4: Verify Connection

Ask Claude a healthcare question to test the connection:

"What is NDC 0069-0151-01?"

If configured correctly, Claude will use the FHIRfly tool and return detailed drug information.

Configuration Options

Full Configuration

{
  "mcpServers": {
    "fhirfly": {
      "url": "https://api.fhirfly.io/mcp",
      "headers": {
        "x-api-key": "ffly_sk_live_abc123..."
      }
    }
  }
}

Development Environment

{
  "mcpServers": {
    "fhirfly-dev": {
      "url": "https://devapi.fhirfly.io/mcp",
      "headers": {
        "x-api-key": "ffly_sk_test_abc123..."
      }
    }
  }
}

Troubleshooting

"Tool not available" Error

• Verify your API key is correct
• Check that your credential has the required scopes
• Restart Claude Desktop

"Unauthorized" Error

• Your API key may be expired or revoked
• Generate a new MCP credential in the dashboard

No Response from Tool

• Check your internet connection
• Verify the FHIRfly API is operational at status.fhirfly.io

Security Notes

• Your API key is stored locally on your machine
• API calls are made directly from Claude Desktop to FHIRfly
• Use separate credentials for different purposes
• Rotate credentials if you suspect compromise