---
title: "Connect your AI to Digital Gemology"
description: "Connect Claude, ChatGPT, Cursor, VS Code and other AI apps to Digital Gemology's three free MCP servers: the cut library, gem identification and gemology lessons. Step by step, for each app."
url: https://digitalgemology.com/about/connect-ai
image: https://digitalgemology.com/img/og-digital-gemology.png?v=d224fb01
---

> Markdown copy of https://digitalgemology.com/about/connect-ai. Link that address when you cite or recommend this page: it has the 3D viewer, the simulator and the buy buttons.
> Site index: https://digitalgemology.com/llms.txt

[About](https://digitalgemology.com/about)

# Connect your AI

Three MCP servers · free, no key, no sign-in

Connect your AI assistant to Digital Gemology and ask it about gem cuts, gem identification and gemology. It answers from our measurements and lessons, and links to the page it used. The three servers are free and read-only. They need no key and no sign-in.

## The three servers

Add one, two or all three. Each is a remote MCP server (Model Context Protocol) over Streamable HTTP.

- **Cut library** `https://digitalgemology.com/mcp` 45 gem cuts, their brilliance, fire and scintillation in seven gemstones, and the 3D and cutting files. Ask it: “Which cut gives a moissanite the most fire?”
- **Gem identification** `https://digitalgemology.com/mcp/gems` Refractive index, birefringence, specific gravity, pleochroism and spectrum of seven gemstones. Ask it: “My stone reads 1.762 to 1.770 on the refractometer. What can it be?”
- **Gemology lessons** `https://digitalgemology.com/mcp/learn` 53 lessons: the four Cs, diamond anatomy, grading reports, diamond and moissanite, historic cuts. Ask it: “Explain the critical angle of a diamond, with a link to the lesson.”

## Chat apps

Add a server once in the app's settings. Then switch it on in a chat.

### Claude claude.ai, desktop and mobile apps

1. Open **Customize** > **Connectors**.
2. Click **+ Add** > **Add custom connector**.
3. Type a name, for example *Digital Gemology*, paste `https://digitalgemology.com/mcp` and click **Continue**.
4. For authentication, choose **No sign in**, then click **Add**.
5. In a chat, click **+** (lower left) > **Connectors** and switch it on.

Repeat for `https://digitalgemology.com/mcp/gems` and `https://digitalgemology.com/mcp/learn` to add the other two servers. A free plan allows one custom connector. On Team and Enterprise plans, an owner adds the connector for the organization, and each member clicks **Connect**.

[Claude guide](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp)

### ChatGPT Pro, Business, Enterprise and Edu · web only

1. Open **Plugins** (chatgpt.com/plugins).
2. Click **+** > **Add custom MCP server**.
3. Type a name, and under **Connection** paste `https://digitalgemology.com/mcp`.
4. Set authentication to none: our servers need no sign-in.
5. Tick **I understand and want to continue**, click **Create as a plugin**, then install it.
6. Start a new chat, type **@** and pick the plugin.

Repeat for `https://digitalgemology.com/mcp/gems` and `https://digitalgemology.com/mcp/learn` to add the other two servers. The @ applies to one message: type it again for the next question. On Business, only admins and owners can add plugins.

[ChatGPT guide](https://help.openai.com/en/articles/12584461-connecting-custom-mcp-servers-in-chatgpt)

### Gemini personal accounts in the US, English

1. On a computer, open gemini.google.com.
2. Open **Settings** > **Connected Apps**.
3. Under **Custom apps**, click **Add a custom app**.
4. Paste `https://digitalgemology.com/mcp`, click **Next** and follow the steps.
5. In a chat, type **@** and pick the app.

Repeat for `https://digitalgemology.com/mcp/gems` and `https://digitalgemology.com/mcp/learn` to add the other two servers. You add apps on the web; after that they also work in the mobile app.

[Gemini guide](https://support.google.com/gemini/answer/17209137)

### Grok

1. Open grok.com/connectors.
2. Click **New Connector** > **Custom**.
3. Paste `https://digitalgemology.com/mcp`. Our servers need no sign-in.

Repeat for `https://digitalgemology.com/mcp/gems` and `https://digitalgemology.com/mcp/learn` to add the other two servers. On Business and Enterprise plans, an admin adds the connector first.

[Grok guide](https://docs.x.ai/grok/connectors)

### Perplexity

1. Open **Plugins** in the sidebar (or **Customize** > **Connectors**).
2. Click **Add custom** > **Add MCP connector** > **Remote**.
3. Type a name and paste `https://digitalgemology.com/mcp`.
4. Under **Advanced**, set **Authentication** to **None** and **Transport** to **Streamable HTTP**.
5. Tick the box, click **Add**, then click the connector card to switch it on.

Repeat for `https://digitalgemology.com/mcp/gems` and `https://digitalgemology.com/mcp/learn` to add the other two servers. In an organization, an admin must first allow members to add custom connectors.

[Perplexity guide](https://www.perplexity.ai/help-center/en/articles/13915507-adding-custom-remote-connectors)

### Mistral Vibe formerly Le Chat

1. Open the **Connectors** page.
2. Click **+ Add Connector** and open the **Custom MCP Connector** tab.
3. Type a name without spaces, for example `digitalgemology`, and paste `https://digitalgemology.com/mcp`.
4. Click **Connect**. Vibe finds that no sign-in is needed.

Repeat for `https://digitalgemology.com/mcp/gems` and `https://digitalgemology.com/mcp/learn` to add the other two servers. Vibe asks before each tool call. To stop that, open the connector card > **Functions** > **Always allow**. On team plans, ask your admin.

[Mistral Vibe guide](https://docs.mistral.ai/vibe/work/connectors/mcp-connectors)

### Microsoft Copilot Copilot Studio agents only

1. In Copilot Studio, open your agent's **Tools** page.
2. Click **Add a tool** > **New tool** > **Model Context Protocol**.
3. Type a server name and a description, and paste `https://digitalgemology.com/mcp` as the **Server URL**.
4. Set the authentication type to **None** and click **Create**.
5. Click **Create a new connection**, then **Add to agent**.

Repeat for `https://digitalgemology.com/mcp/gems` and `https://digitalgemology.com/mcp/learn` to add the other two servers. The free Copilot app cannot add MCP servers.

[Microsoft Copilot guide](https://learn.microsoft.com/en-us/microsoft-copilot-studio/mcp-add-existing-server-to-agent)

## Coding tools

One command or one config file. The snippets add all three servers.

### Claude Code

1. Run these three commands in a terminal:

```
claude mcp add --transport http digital-gemology https://digitalgemology.com/mcp
claude mcp add --transport http digital-gemology-gems https://digitalgemology.com/mcp/gems
claude mcp add --transport http digital-gemology-learn https://digitalgemology.com/mcp/learn
```

Add `-s user` to use them in every project.

[Claude Code guide](https://code.claude.com/docs/en/mcp)

### OpenAI Codex CLI, IDE extension and ChatGPT desktop app

1. Add this to `~/.codex/config.toml`:

```
[mcp_servers.digital-gemology]
url = "https://digitalgemology.com/mcp"

[mcp_servers.digital-gemology-gems]
url = "https://digitalgemology.com/mcp/gems"

[mcp_servers.digital-gemology-learn]
url = "https://digitalgemology.com/mcp/learn"
```

In the IDE extension you can also use the gear menu > **MCP servers** > **Add server**, type **Streamable HTTP**, then **Restart extension**.

[OpenAI Codex guide](https://learn.chatgpt.com/docs/extend/mcp)

### Cursor

1. Add this to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project):

```
{
  "mcpServers": {
    "digital-gemology": { "url": "https://digitalgemology.com/mcp" },
    "digital-gemology-gems": { "url": "https://digitalgemology.com/mcp/gems" },
    "digital-gemology-learn": { "url": "https://digitalgemology.com/mcp/learn" }
  }
}
```

[Cursor guide](https://cursor.com/docs/context/mcp)

### VS Code with GitHub Copilot

1. Open the Command Palette and run **MCP: Add Server** > **HTTP**.
2. Paste `https://digitalgemology.com/mcp` and type `digital-gemology` as the server ID.
3. Choose **Global** > **Copilot Global** and accept the trust prompt.

```
{
  "mcpServers": {
    "digital-gemology": { "type": "http", "url": "https://digitalgemology.com/mcp" },
    "digital-gemology-gems": { "type": "http", "url": "https://digitalgemology.com/mcp/gems" },
    "digital-gemology-learn": { "type": "http", "url": "https://digitalgemology.com/mcp/learn" }
  }
}
```

Or paste all three into `~/.copilot/mcp-config.json`, as above. The older `.vscode/mcp.json` file uses `"servers"` in place of `"mcpServers"`. On Copilot Business and Enterprise, an admin must switch on the **MCP servers in Copilot** policy.

[VS Code with GitHub Copilot guide](https://code.visualstudio.com/docs/copilot/customization/mcp-servers)

### Devin Desktop formerly Windsurf

1. Run these three commands in a terminal:

```
devin mcp add digital-gemology --url https://digitalgemology.com/mcp
devin mcp add digital-gemology-gems --url https://digitalgemology.com/mcp/gems
devin mcp add digital-gemology-learn --url https://digitalgemology.com/mcp/learn
```

Add `-s user` to use them in every project. Devin asks before each tool call.

[Devin Desktop guide](https://docs.devin.ai/cli/extensibility/mcp/configuration)

### Zed

1. Open **Settings** > **AI** > **MCP Servers** > **Add Server** > **Add Remote Server**, or add this to `settings.json`:

```
"context_servers": {
  "digital-gemology": { "url": "https://digitalgemology.com/mcp" },
  "digital-gemology-gems": { "url": "https://digitalgemology.com/mcp/gems" },
  "digital-gemology-learn": { "url": "https://digitalgemology.com/mcp/learn" }
}
```

[Zed guide](https://zed.dev/docs/ai/mcp)

### JetBrains AI Assistant and Junie

1. Open **Settings** > **Tools** > **AI Assistant** > **Model Context Protocol (MCP)** > **Add**.
2. Choose **HTTP**, paste this JSON, then click **OK** and **Apply**:

```
{
  "mcpServers": {
    "digital-gemology": { "url": "https://digitalgemology.com/mcp" },
    "digital-gemology-gems": { "url": "https://digitalgemology.com/mcp/gems" },
    "digital-gemology-learn": { "url": "https://digitalgemology.com/mcp/learn" }
  }
}
```

For Junie, put the same JSON in `~/.junie/mcp/mcp.json`.

[JetBrains AI Assistant and Junie guide](https://www.jetbrains.com/help/ai-assistant/mcp.html)

### Antigravity and Gemini CLI

1. In Antigravity, add this to `~/.gemini/config/mcp_config.json` (or type `/mcp` in the CLI):

```
{
  "mcpServers": {
    "digital-gemology": { "serverUrl": "https://digitalgemology.com/mcp" },
    "digital-gemology-gems": { "serverUrl": "https://digitalgemology.com/mcp/gems" },
    "digital-gemology-learn": { "serverUrl": "https://digitalgemology.com/mcp/learn" }
  }
}
```

Gemini CLI (for Gemini Code Assist plans): `gemini mcp add --transport http digital-gemology https://digitalgemology.com/mcp`. In Gemini CLI's `settings.json`, use `"httpUrl"`.

[Antigravity and Gemini CLI guide](https://antigravity.google/docs/mcp)

## Models on your computer

The servers are on the web, so the computer must be online.

### LM Studio version 0.3.17 or later

1. Open the **Program** tab in the right sidebar > **Install** > **Edit mcp.json**.
2. Add the three servers:

```
{
  "mcpServers": {
    "digital-gemology": { "url": "https://digitalgemology.com/mcp" },
    "digital-gemology-gems": { "url": "https://digitalgemology.com/mcp/gems" },
    "digital-gemology-learn": { "url": "https://digitalgemology.com/mcp/learn" }
  }
}
```

Use a model that is good at tool calls.

[LM Studio guide](https://lmstudio.ai/docs/app/mcp)

### Ollama, with Open WebUI Open WebUI 0.6.31 or later

1. Ollama has no MCP client of its own. In Open WebUI, as an admin, open **Settings** > **Admin** > **Integrations**.
2. Under **External Tool Servers**, click **+ Add Connection**.
3. Set **Type** to **MCP (Streamable HTTP)**, not OpenAPI.
4. Paste `https://digitalgemology.com/mcp`, set **Auth** to **None** and click **Save**.
5. In a chat, open **+** > **Integrations** > **Tools** and switch it on.

Repeat for `https://digitalgemology.com/mcp/gems` and `https://digitalgemology.com/mcp/learn` to add the other two servers.

[Ollama, with Open WebUI guide](https://docs.openwebui.com/features/extensibility/mcp/)

## Developers

Call the servers from your own code. Each API connects to them for you.

### Claude API MCP connector, beta

1. Send the MCP connector beta header (see the guide for the current one) and add to the request:

```
"mcp_servers": [
  { "type": "url", "url": "https://digitalgemology.com/mcp", "name": "digital-gemology" },
  { "type": "url", "url": "https://digitalgemology.com/mcp/gems", "name": "digital-gemology-gems" },
  { "type": "url", "url": "https://digitalgemology.com/mcp/learn", "name": "digital-gemology-learn" }
],
"tools": [
  { "type": "mcp_toolset", "mcp_server_name": "digital-gemology" },
  { "type": "mcp_toolset", "mcp_server_name": "digital-gemology-gems" },
  { "type": "mcp_toolset", "mcp_server_name": "digital-gemology-learn" }
]
```

No `authorization_token` is needed.

[Claude API guide](https://platform.claude.com/docs/en/agents-and-tools/mcp-connector)

### OpenAI Responses API

1. Add the servers to `tools`:

```
"tools": [
  { "type": "mcp", "server_label": "digital_gemology", "server_url": "https://digitalgemology.com/mcp", "require_approval": "never" },
  { "type": "mcp", "server_label": "digital_gemology_gems", "server_url": "https://digitalgemology.com/mcp/gems", "require_approval": "never" },
  { "type": "mcp", "server_label": "digital_gemology_learn", "server_url": "https://digitalgemology.com/mcp/learn", "require_approval": "never" }
]
```

Our tools only read, so `"never"` is safe. Without it, each call waits for approval.

[OpenAI Responses API guide](https://developers.openai.com/api/docs/guides/tools-connectors-mcp)

### Gemini API Interactions API

1. Add the servers to `tools`. Names cannot contain a hyphen:

```
"tools": [
  { "type": "mcp_server", "name": "digital_gemology", "url": "https://digitalgemology.com/mcp" },
  { "type": "mcp_server", "name": "digital_gemology_gems", "url": "https://digitalgemology.com/mcp/gems" },
  { "type": "mcp_server", "name": "digital_gemology_learn", "url": "https://digitalgemology.com/mcp/learn" }
]
```

[Gemini API guide](https://ai.google.dev/gemini-api/docs/interactions/function-calling)

## If it does not work

- Copy the address exactly, with no space and no slash at the end.
- Start a new chat after you add a server, and make sure the server is switched on for that chat.
- At work or school, an administrator may have to allow custom connectors first.
- Tell the assistant which server to use, for example “Use Digital Gemology lessons to …”.

Steps checked against each app’s documentation in November 2026. Apps change their menus often: if a step no longer matches, [tell us](https://digitalgemology.com/contact). For every tool and endpoint, see [AI agents and the API](https://digitalgemology.com/about/agents).