Claude Desktop Setup
Connect FHIRfly to Claude Desktop using MCP.
Prerequisites
- Claude Desktop installed
- FHIRfly account with an MCP credential
Step 1: Create an MCP Credential
- Go to Dashboard → Credentials
- Click Create Credential
- Select MCP (AI Assistant)
- Name your credential (e.g., "Claude Desktop")
- Copy the configuration JSON shown
Step 2: Configure Claude Desktop
macOS
- Open Finder
- Press
Cmd + Shift + G - Go to:
~/Library/Application Support/Claude/ - Open or create
claude_desktop_config.json - Add the FHIRfly server configuration:
{
"mcpServers": {
"fhirfly": {
"url": "https://api.fhirfly.io/mcp",
"headers": {
"x-api-key": "YOUR_API_KEY"
}
}
}
}
Windows
- Open File Explorer
- Go to:
%APPDATA%\Claude\ - Open or create
claude_desktop_config.json - 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