Skip to content

Commit d55993a

Browse files
committed
Add guides for connecting MCP server to Claude, ChatGPT, and Codex
1 parent 6e176d4 commit d55993a

File tree

4 files changed

+52
-0
lines changed

4 files changed

+52
-0
lines changed

docs/hub/_toctree.yml

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -442,6 +442,12 @@
442442
title: Agents on Hub
443443
- local: hf-mcp-server
444444
title: Hugging Face MCP Server
445+
- local: hf-mcp-claude
446+
title: Connect MCP to Claude
447+
- local: hf-mcp-chatgpt
448+
title: Connect MCP to ChatGPT
449+
- local: hf-mcp-codex-cli
450+
title: Connect MCP to Codex CLI
445451
- local: moderation
446452
title: Moderation
447453
- local: paper-pages

docs/hub/hf-mcp-chatgpt.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
# Connect the Hugging Face MCP Server to ChatGPT
2+
3+
Use ChatGPT's connector gallery to link the Hugging Face MCP Server.
4+
5+
## Steps
6+
7+
1. Open the ChatGPT web or desktop app, click your name → **Settings**, then open **Connectors**.
8+
2. Choose **Browse connectors**, search for **Hugging Face**, and click **Add**.
9+
3. Approve the sign-in window at `https://huggingface.co/mcp?login` to authorize access to your Hugging Face account.
10+
4. Back in ChatGPT, verify that **Hugging Face** is listed under **Available connectors**, then enable it in a chat to call Hub tools.
11+
12+
> [!TIP]
13+
> You can manage which Hugging Face MCP tools are exposed by visiting [your MCP settings](https://huggingface.co/settings/mcp); ChatGPT will pick up new tools automatically.

docs/hub/hf-mcp-claude.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
# Connect the Hugging Face MCP Server to Claude Desktop
2+
3+
Use the Claude connectors flow to authorize the Hugging Face MCP Server.
4+
5+
## Steps
6+
7+
1. Open the [Claude connectors settings](https://claude.ai/settings/connectors) in Claude Desktop or Claude.ai and sign in if needed.
8+
2. Select **Browse connectors**, pick **Hugging Face**, and confirm.
9+
3. When the browser opens `https://huggingface.co/mcp?login`, follow the prompts to sign in and approve access.
10+
4. Return to Claude and make sure **Hugging Face** appears under **Connected connectors** before using it in a chat.
11+
12+
> [!TIP]
13+
> Once connected you can add more Hugging Face MCP tools from [your MCP settings](https://huggingface.co/settings/mcp) and they will appear automatically in Claude.

docs/hub/hf-mcp-codex-cli.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
# Connect the Hugging Face MCP Server to Codex CLI
2+
3+
Configure the Codex CLI to launch the Hugging Face MCP Server via `mcp-remote`.
4+
5+
## Steps
6+
7+
1. Follow the [Codex CLI setup guide](https://github.com/openai/codex) to install the tool and create your `~/.codex/config.toml`.
8+
2. Add the Hugging Face MCP server block to the config:
9+
10+
```toml
11+
[mcp_servers.huggingface]
12+
command = "npx"
13+
args = ["-y", "mcp-remote@latest", "https://huggingface.co/mcp?login"]
14+
```
15+
16+
3. Save the file and restart the Codex CLI (or run `codex mcp list`) to confirm that the **huggingface** server is available.
17+
4. Invoke Hugging Face tools from Codex by asking it to use the `huggingface` MCP server in your next command or chat.
18+
19+
> [!NOTE]
20+
> The `mcp-remote` helper opens a browser window the first time to complete the Hugging Face sign-in and authorization flow.

0 commit comments

Comments
 (0)