ClaudeとHugging Faceを連携する方法 — HubのモデルやGradioアプリを会話から呼ぶ

Hugging FaceはClaudeのコネクタとして追加でき、Hubのモデル・データセット・論文の検索と、MCP対応のGradioアプリ(Spaces)の呼び出しを会話の中でこなせます。接続先は https://huggingface.co/mcp?login&gradio=none で、Hugging Faceアカウントでのサインインが必要です。

この記事は、接続の手順と、接続後に何がどこまで使えるかを扱います。Gradioでデモを作る側の話はClaude CodeでGradioデモを作る手順にあります。

接続前に確認すること

ディレクトリ上のHugging Faceは「Anthropic verified」の表示つきで、カテゴリは開発者ツール、追加時期は2025年11月、サインインは必須と掲載されています。

利用の形によって、追加の入口が変わります。

Team・Enterpriseでは、組織で有効にしても全員がすぐ使えるわけではありません。各メンバーが自分のHugging Faceアカウントで認証して、はじめて使えます。

Claudeに追加する手順

接続すると、Claudeは自分のアカウントの権限の範囲でHubを引きます。コネクタは接続先で本人が持つ権限を引き継ぐ仕組みで、本人が見られないものはコネクタからも見えません。

Claude Codeから使う場合

Claude CodeではHTTPトランスポートのサーバーとして登録します。URLに & を含むため、引用符で囲みます。

claude mcp add --transport http hugging-face \
  "https://huggingface.co/mcp?login&gradio=none"

登録後、セッション内で /mcp を開くとサーバーの状態が見え、認証もここから進めます。ここに示したのはClaude Code共通のHTTPサーバー登録の形です。Hugging Face側の設定ページ(https://huggingface.co/settings/mcp)にはクライアントごとの手順と、そのままコピーできる設定が用意されています。手書きせず、このページが生成する設定を使うのが推奨なので、迷ったときはそちらを優先します。設定ページはログインが必要です。

使えるツールの一覧

ディレクトリの掲載ページには、次の10個のツールが載っています。

Gradio系のツール名は、ツール化したSpaceの順番と名前から作られた形に見えます。自分のアカウントで見えるツールは、接続後にClaudeのコネクタ設定のツール一覧で確かめられます。

Hubを検索する依頼の例

接続後に試せる依頼文の例を日本語にすると、次のような形です。

• 「Qwen 3の量子化モデルをHugging Faceで探して」
• 「音声ファイルを文字起こしできるSpaceを探して」
• 「気象の時系列を扱うデータセットを見せて」

結果として返るのは、タイトル、所有者、ダウンロード数、リンクなどです。Claudeが返すリンクからHubで開くか、同じ会話で条件を足して絞り込めます。

検索の質は依頼の具体さで決まります。モデル探しなら「対象タスク」「言語」「サイズの上限」「ライセンス」を依頼文に入れると、候補が減って比べやすくなります。ただしHub側の絞り込み条件がすべてツールの引数として公開されているかは、掲載ページからは分かりません。条件が効かないと感じたら、Claudeに「どの条件で検索したか」を答えさせると、渡った引数が見えます。

Gradioアプリを呼び出す仕組み

Spacesのうち、公開されていてMCPバッジが付いたものは、そのままツールとして使えます。Gradioのアプリは関数を引数と説明つきのツールとして公開するので、Claudeが直接呼べます。

自分の会話に足す手順は次のとおりです。

1. MCP対応のSpacesの一覧を開く(Hubのフィルターで mcp-server を選ぶ)。Spaceカードのグレーの「MCP」バッジでも見分けられる
2. バッジを押して「Add to MCP tools」を選び、確認する
3. MCP設定ページの「Spaces Tools」欄に、そのSpaceが載っていることを確かめる

追加したSpaceは、設定を変えずに使えるようになるとされています。ツールが出てこないときは、クライアントを再起動します。

掲載ページのコネクタURLには gradio=none が付いています。このパラメータの意味はドキュメントに説明がありません。Spaceを足したのにClaudeに出てこない場合は、設定ページの手順どおりに登録した設定を使っているか、Claude側でコネクタを一度切って接続し直すと状況を切り分けられます。

ZeroGPUの枠に注意する

ZeroGPUのSpaceを呼ぶと、ツールを呼び出した時点で自分の枠が消費されます。枠を使い切ったときはPROに加入すると、毎日40分の枠が得られ、無料ユーザーの8倍にあたります。PROならFLUX.1-schnellで1日に最大600枚の画像を生成できます。

画像生成を会話で何度も試すと、枠はすぐ減ります。生成を繰り返す前に、必要な枚数を決めておくと枠の切れを避けられます。

自分のGradioアプリをツールにする

Claudeから呼べるツールは、自作もできます。Gradioに mcp の追加依存を入れ、launch() に mcp_server=True を渡します。コード例は次のとおりです。

import gradio as gr
 
def letter_counter(word: str, letter: str) -> int:
    """Count occurrences of a letter in a word.
 
    Args:
        word: The word to search in
        letter: The letter to count
 
    Returns:
        Number of times the letter appears in the word
    """
    return word.lower().count(letter.lower())
 
demo = gr.Interface(fn=letter_counter,
                    inputs=["text", "text"],
                    outputs="number")
demo.launch(mcp_server=True)

型ヒントとdocstringがツールの引数と説明になるため、Claudeが使い道を判断する材料もここから来ます。関数には明確な型ヒントとdocstringを付けるのが前提です。Gradio Spaceとして公開するとMCPバッジが自動で付き、誰でもワンクリックでツールに追加できます。既存のGradio SpaceをMCP化するときは、複製して launch() に mcp_server=True を足します。

インストールは pip install "gradio[mcp]" です。Claude Codeに作らせる流れなら、docstringの書き方まで含めて依頼すると、ツール化に必要な部分が揃います。たとえば次のように頼みます。

このPythonの関数をGradioアプリにして、MCPサーバーとして
公開できるようにして。引数の型ヒントとdocstringも付けて。

扱うデータと共有の範囲

接続すると、検索の依頼文と結果がHugging Faceのサーバーとやり取りされます。ディレクトリの掲載ページは、コネクタの提供元が提供するツールをAnthropicは管理しておらず、意図どおり動く保証も変更されない保証もないと注意しています。信頼できる提供元のものだけを使う前提です。

Gradioアプリを呼ぶと、入力した文章や画像は、そのSpaceを動かす第三者の環境に渡ります。社内の文書や個人情報を、コミュニティのSpaceに渡す前に、Spaceの作者と運用元を確かめてください。

ツール単位の権限も設定でき、「Always allow」「Needs approval」「Blocked」から選べます。Team・Enterpriseでは、Ownerが組織全体で書き込み系の動作を制限できます。Hugging Faceの検索系ツールが中心なので、ここで困る場面は多くありません。

つながらない・ツールが出ないとき

アクセストークンについても触れておきます。MCPのツールを使うには、READ権限の有効なHugging Faceトークンが要ります。これはMCPクライアントを設定ページの手順で設定する場面の説明です。ディレクトリから追加するコネクタはサインインで接続するので、通常はトークンを自分で貼る場面はありません。

向き不向きの目安

Hugging Faceのコネクタは、検索と呼び出しに寄っています。モデルの重みを手元に落とす、学習を走らせる、といった操作は掲載ツールにありません。Hub上のモデルの比較検討と、画像生成のような単機能のSpaceの呼び出しが主な用途です。

まとめ

接続はディレクトリからの追加か claude mcp add の1コマンドで済みます。見ておきたいのは、掲載ツール名だけで説明が載らないものがあることと、ZeroGPUの枠がツール呼び出しのたびに減ることの2点です。まずは検索系の依頼で動作を確かめ、Gradioアプリは提供元を確認してから足す進め方なら、データの渡し先を把握したまま広げられます。接続全般の考え方はClaudeのコネクタ解説にまとめています。