Claude Code

Configure Clinical Terminology MCP servers in Claude Code CLI.

Claude Code is Anthropic’s CLI tool for using Claude in the terminal. It registers MCP servers through CLI commands.

Basic Setup

Add a single server:

claude mcp add snomed /usr/local/bin/snomed-mcp

Complete Configuration

# Servers without authentication
claude mcp add snomed /usr/local/bin/snomed-mcp
claude mcp add rxnorm /usr/local/bin/rxnorm-mcp
claude mcp add icd10 /usr/local/bin/icd10-mcp
claude mcp add ucum /usr/local/bin/ucum-mcp

# Servers requiring credentials
claude mcp add icd11 \
  --env ICD11_CLIENT_ID="your-client-id" \
  --env ICD11_CLIENT_SECRET="your-client-secret" \
  -- /usr/local/bin/icd11-mcp

claude mcp add loinc \
  --env LOINC_USERNAME="your-username" \
  --env LOINC_PASSWORD="your-password" \
  -- /usr/local/bin/loinc-mcp

claude mcp add umls \
  --env UMLS_API_KEY="your-api-key" \
  -- /usr/local/bin/umls-mcp

To customize the SNOMED edition:

claude mcp add snomed \
  --env SNOWSTORM_BRANCH="MAIN/SNOMEDCT-US" \
  -- /usr/local/bin/snomed-mcp

Servers Requiring Credentials

Three servers need credentials configured via environment variables or system keyring:

Server	Environment Variables
ICD-11	`ICD11_CLIENT_ID`, `ICD11_CLIENT_SECRET`
LOINC	`LOINC_USERNAME`, `LOINC_PASSWORD`
UMLS	`UMLS_API_KEY`

Start with servers that don’t require authentication (snomed, rxnorm, icd10, ucum) and add authenticated services as needed.

Managing Servers

# List registered servers
claude mcp list

# Remove a server
claude mcp remove snomed

Remote / HTTP Setup

Connect to a remote server running in HTTP mode:

claude mcp add snomed --transport streamable-http https://your-server.com/mcp

See HTTP Transport for server-side setup and Remote Deployment for deployment guides.