Skip to main content

​
What is Hosted MCP?

OMOPHub runs an MCP server for you at mcp.omophub.com. Connect your AI client directly - no npm install, no Docker, no infrastructure to manage. Just your API key and a URL. All 9 tools are available: concept search, semantic search, hierarchy navigation, cross-vocabulary mapping, and more.

​
Endpoint

URLDescription
https://mcp.omophub.comMCP protocol endpoint

​
Client Compatibility

ClientHosted MCPHow
Claude CodeYesCustom headers supported natively
VS CodeYesheaders field in mcp.json
CursorYesheaders field in MCP config
WindsurfYesSame as Cursor
Claude DesktopUse npxCustom Connectors UI only supports OAuth, not Bearer tokens. Use the self-hosted npx setup instead.
Claude.ai (web)Use npxSame limitation as Claude Desktop.

​
Quick Setup

You need two things: the endpoint URL and your API key (get one at dashboard.omophub.com).

​
Claude Code

claude mcp add omophub --transport http \
  -H "Authorization: Bearer oh_your_key_here" \
  https://mcp.omophub.com

​
VS Code

Add to .vscode/mcp.json: 
{
  "servers": {
    "omophub": {
      "type": "http",
      "url": "https://mcp.omophub.com",
      "headers": {
        "Authorization": "Bearer oh_your_key_here"
      }
    }
  }
}

​
Cursor

Add to your Cursor MCP configuration: 
{
  "mcpServers": {
    "omophub": {
      "url": "https://mcp.omophub.com",
      "headers": {
        "Authorization": "Bearer oh_your_key_here"
      }
    }
  }
}

​
Windsurf

Same configuration pattern as Cursor: 
{
  "mcpServers": {
    "omophub": {
      "url": "https://mcp.omophub.com",
      "headers": {
        "Authorization": "Bearer oh_your_key_here"
      }
    }
  }
}

​
Claude Desktop

Claude Desktop’s Custom Connectors UI only supports OAuth authentication and cannot send custom Bearer tokens. Use the self-hosted npx approach instead - it works identically and requires no infrastructure: 
{
  "mcpServers": {
    "omophub": {
      "command": "npx",
      "args": ["-y", "@omophub/omophub-mcp"],
      "env": {
        "OMOPHUB_API_KEY": "oh_your_key_here"
      }
    }
  }
}

​
Verify Connection

curl https://mcp.omophub.com/health
# {"status":"ok","version":"1.3.0"}

Self-Hosted Installation

Prefer to run the MCP server yourself? See the self-hosted installation guide.

​
Troubleshooting

IssueSolution
Connection refusedVerify the URL is https://mcp.omophub.com (not just /)
401 UnauthorizedCheck your API key is valid and prefixed with oh_