Skip to main content

Claude Logo

Integrating Claude with Haste Health

This guide provides step-by-step instructions for integrating Anthropic's Claude with your Haste Health platform using the Model Context Protocol (MCP). Claude can access your FHIR data through OAuth authentication, enabling AI-powered healthcare applications.

Overview​

Claude integration with Haste Health involves:

  1. Registering a ClientApplication - Create OAuth credentials for Claude
  2. Installing Claude Desktop App - Set up the Claude application
  3. Configuring MCP Server - Connect Claude to Haste Health via MCP with OAuth

Prerequisites​

Before you begin, ensure you have:

  • ✅ A Haste Health account with admin access
  • ✅ Access to create ClientApplication resources
  • ✅ Your tenant and project identifiers
  • ✅ Claude Desktop application installed (download from Claude.ai)

Step 1: Register a ClientApplication​

First, create an OAuth client that Claude will use to authenticate with Haste Health.

  1. Navigate to Security/ClientApplications in your Haste Health Admin App
  2. Click New
  3. Configure the following settings:
FieldValueDescription
NameClaudeHuman-readable name
Grant Typesauthorization_code and refresh_tokenUser authentication with refresh capability
Response TypestokenOAuth response type
Scopeopenid profile email offline_access user/*.*Access level (read-only or full access)
Redirect URIshttps://claude.ai/api/mcp/auth_callbackRedirect URI for OAuth flow

Note that the redirect URI should be https://claude.ai/api/mcp/auth_callback per Claude Desktop's OAuth configuration requirements.

  1. Click Actions/Create
  2. ⚠️ Important: Copy and save the generated ID for later use.

Scope Configuration​

Choose appropriate scopes based on what Claude needs to access:

Read-Only Access (Recommended for most cases):

"scope": "openid profile email user/*.read"

Specific Resource Types:

"scope": "openid profile email user/Patient.read user/Observation.read user/Condition.read"

Full Access (Use with caution):

"scope": "openid profile email offline_access user/*.*"

For more information, see Scopes documentation.

Step 2: Install Claude Desktop App​

  1. Download Claude:

    • Visit Claude.ai
    • Download the Claude Desktop application for your operating system (macOS, Windows, or Linux)
    • Follow the installation instructions

  2. Sign in to Claude:

    • Launch the Claude Desktop application
    • Sign in with your Anthropic account

  3. Verify Installation:

    • Open Claude Desktop
    • Navigate to Settings → Developer

Step 3: Configure Claude Desktop​

Configure Claude to connect with Haste Health via MCP.

  1. Go to Settings → Connectors in Claude Desktop
  2. Click Add Custom Connector
  3. Add Name as Haste Health
  4. Set the MCP Server URL to: 
    https://api.haste.health/w/[tenant]/[project]/api/v1/mcp
    Replace [tenant] with your tenant name and [project] with your project ID.
  5. Click Advanced Settings:
    • Set ClientID to the ClientApplication ID created in Step 1
  6. Click Add

Step 4: Authenticate Claude with Haste Health​

After configuring the MCP server:

  1. Click Connect on the Haste Health connector in Claude Desktop
  2. A browser window will open prompting you to log in to Haste Health
  3. Complete the OAuth flow to authorize Claude to access your Haste Health data
  4. Upon successful authentication, Claude will connect to Haste Health and access FHIR data as per the configured scopes.

Step 5: Test the Integration​

Test that Claude can access your Haste Health data:

Example Prompts​

List Patients:

Show me the first 10 patients in the system

Search for Observations:

Find all blood pressure observations from the last 30 days

Query Patient Data:

Get patient demographics for patient ID patient-123

Analyze Conditions:

List all patients with diabetes and their latest HbA1c readings

Clinical Summaries:

Create a summary of patient-456's recent encounters and medications

Troubleshooting​

Common Issues​

1. "Invalid Client" Error​

Symptom: Claude cannot authenticate with Haste Health

Solutions:

  • ✅ Check that the ClientApplication exists: haste-health api read ClientApplication [client-id]
  • ✅ Ensure the ClientApplication has authorization_code and refresh_token grant types
  • ✅ Verify the redirect URI is exactly https://claude.ai/api/mcp/auth_callback (no port, with trailing slash)

2. "Insufficient Scope" Error​

Symptom: Authentication works but data access fails

Solutions:

  • ✅ Check the scope field in your ClientApplication resource
  • ✅ Ensure requested scopes in the config match what's configured in the ClientApplication
  • ✅ Verify access policies grant permissions to your user account

3. "Redirect URI Mismatch" Error​

Symptom: OAuth flow fails with redirect error

Solutions:

  • ✅ Ensure ClientApplication redirectUri is exactly https://claude.ai/api/mcp/auth_callback
  • ✅ Do not include a port number

Use Cases​

Clinical Decision Support​

Use Claude to provide AI-powered clinical insights:

Analyze patient-123's recent lab results and suggest potential diagnoses based on current symptoms

Clinical Documentation​

Generate clinical documentation:

Create a progress note for patient-456's encounter today, including vital signs, chief complaint, and plan

Patient Education​

Create patient-friendly explanations:

Explain the diagnosis of Type 2 Diabetes to a patient in simple terms, including lifestyle modifications

Data Quality Auditing​

Identify data quality issues:

Review all patients and identify those missing required demographic information or incomplete records

Natural Language Queries​

Ask questions in plain English:

Show me all patients with hypertension who haven't had a blood pressure reading in the last year

Care Coordination​

Coordinate patient care:

List all medications for patient-789 and check for potential interactions

Support​

For issues or questions:

  1. Check the Troubleshooting section above
  2. Review Claude Developer logs for error details
  3. Verify your ClientApplication configuration
  4. Test OAuth authentication manually
  5. File an issue on the Haste Health GitHub repository