Model Context Protocol

Connect to the
MCP Server

Get conversational access to Roche terminologies, ontologies, master data and the enterprise Knowledge Graph. Connect instantly in the browser, or via Claude Code (build-cli) on Windows or macOS.

Get Connected See Example Questions
Browser chat Claude Code · Windows Claude Code · macOS

Setup

Choose how you want to connect

The Roche Semantic Hub is exposed over the Model Context Protocol (MCP) via HTTP. Pick the option that suits you — use it instantly in the browser, or register it once with build-cli on Windows or macOS.

1

Open the Semantic Hub chat

The quickest way in — no install, no config. Open the hosted chat in your browser and start asking questions straight away.

Open Semantic Hub Chat VPN required

2

Just ask

The Roche Semantic Hub tools are already wired into the chat. Jump to the example questions below for inspiration.

Before you start

Set up Claude Code (build-cli) first by following the build-cli quickstart — it walks you through WSL, Roche certificates, build-cli, VS Code, and SSO login.

1

Add the Roche Semantic Hub server

Register the Semantic Hub (rsh) over HTTP:

Ubuntu — bash
$ claude mcp add --transport http rsh https://rsh-int-mcp.kubemea-gw.roche.com/mcp

Tip: rsh is the local name for the server — you'll see it prefix every tool.

2

Start Claude Code

Launch the CLI as normal. The Roche Semantic Hub tools are loaded automatically at startup.

Ubuntu — bash
$ claude
3

Verify with /context

Run /context inside Claude Code. You should see the rsh tools listed under MCP tools — that's the result confirming the server is connected.

claude code — /context
> /context MCP tools · /mcp ├ mcp__rsh__fullTextSearchOnConcept ├ mcp__rsh__getAllTerminologies ├ mcp__rsh__getTopLevelConcepts └ mcp__rsh__execute

What are MCP tools? Think of the MCP server as an app that Claude can use, and each tool as one action that app can perform — like searching a vocabulary or fetching a record. The list above (each line starting with mcp__rsh__) is simply the menu of actions the Roche Semantic Hub gives Claude. If you see them, you're connected and ready to ask questions.

macOS · Terminal (zsh)

Before you start

Set up Claude Code (build-cli) first by following the build-cli quickstart — it walks you through installing build-cli, Roche certificates, and SSO login.

1

Register the MCP server

Open Terminal and add the Roche Semantic Hub (rsh) using the HTTP transport:

zsh — terminal
$ claude mcp add --transport http rsh https://rsh-int-mcp.kubemea-gw.roche.com/mcp

Tip: rsh is the local name for the server — you'll see it prefix every tool.

2

Start Claude Code

Launch the CLI as normal. The Roche Semantic Hub tools are loaded automatically at startup.

zsh — terminal
$ claude
3

Verify with /context

Run /context inside Claude Code. You should see the rsh tools listed under MCP tools — that's the result confirming the server is connected.

claude code — /context
> /context MCP tools · /mcp ├ mcp__rsh__fullTextSearchOnConcept ├ mcp__rsh__getAllTerminologies ├ mcp__rsh__getTopLevelConcepts └ mcp__rsh__execute

What are MCP tools? Think of the MCP server as an app that Claude can use, and each tool as one action that app can perform — like searching a vocabulary or fetching a record. The list above (each line starting with mcp__rsh__) is simply the menu of actions the Roche Semantic Hub gives Claude. If you see them, you're connected and ready to ask questions.

Capabilities

What the connection gives you

Nine tools cover discovery, hierarchy traversal, keyword search and direct GraphQL — everything Claude needs to resolve human terms to concept IRIs and answer in plain language.

getAllTerminologies
List every terminology in the semantic layer to find the IRI you need.
getTopLevelConcepts
Browse the root categories of a terminology to understand its structure.
getNarrowerConcepts
Drill down into the children and subtypes of any concept.
fullTextSearchOnConcept
Typo-tolerant keyword search scoped to concepts within a terminology.
fullTextSearchOnObjects
Search across applications, terminologies and concepts at once.
getObjectsByIRI
Fetch full metadata and a 10-level broader hierarchy for known IRIs.
execute
Run a validated GraphQL operation directly against the Knowledge Graph.
introspect
Explore the GraphQL schema starting from the root Query type.
search
Search the schema for types needed to construct GraphQL operations.

In Action

Now just ask

With Roche Semantic Hub connected, ask in plain language and get answers in seconds. Try one of these:

▸ Show me all changes and the reason for change for study BO25126?
▸ What are the synonyms for the Product Family Tecentriq?
▸ Show all GLP-1 studies and their indications?

Why this matters

Questions like "show me all changes and reason for change for study BO25126" were previously only accessible via the database. The business could never get an answer to this type of question without IT support — now it's a single prompt.