# Spaces en tant que serveurs MCP

Vous pouvez **exposer n’importe quel Space public affichant un badge `MCP` visible en tant qu’outil appelable**, utilisable dans n’importe quel client compatible MCP, en ajoutant autant de Spaces que vous le souhaitez et sans écrire la moindre ligne de code.

## Configurer votre client MCP

Depuis vos [paramètres MCP du Hub](https://huggingface.co/settings/mcp), sélectionnez votre client MCP (VSCode, Cursor, Claude Code, etc.) puis suivez les instructions de configuration.

![image/png](https://cdn-uploads.huggingface.co/production/uploads/5f17f0a0925b9863e28ad517/wWm_GeuWF17OrMyJT4tMx.png)

> [!WARNING]
> Vous avez besoin d'un jeton Hugging Face valide avec des autorisations de lecture (READ) pour utiliser les outils MCP. Si vous n'en avez pas, créez un nouveau jeton d'accès « Read » ici.

## Ajouter un Space existant à vos outils MCP

![image/png](https://cdn-uploads.huggingface.co/production/uploads/5f17f0a0925b9863e28ad517/ex9KRpvamn84ZaOlSp_Bj.png)

1. Parcourez les [Spaces](https://huggingface.co/spaces?filter=mcp-server) compatibles pour trouver les Spaces utilisables via MCP. Vous pouvez également rechercher le badge gris **MCP** sur n’importe quelle carte de Space.
2. Cliquez sur le badge et choisissez **Add to MCP tools**, puis confirmez lorsque demandé.
3. Le Space doit être répertorié dans vos paramètres de serveur MCP, dans la section Spaces Tools.

![image/png](https://cdn-uploads.huggingface.co/production/uploads/5f17f0a0925b9863e28ad517/uI4PsneUZoWn_TExhNJyt.png)

## Utiliser Spaces depuis votre client MCP 

Si votre client MCP est correctement configuré, les Spaces que vous avez ajoutés seront immédiatement disponibles sans aucune modification (si votre client ne redémarre pas, ils devraient apparaître). La plupart des clients MCP affichent la liste des outils actuellement chargés, ce qui vous permet de vérifier que le Space est bien disponible.

> [!TIP]
> Pour les Spaces ZeroGPU, votre quota est utilisé lorsque l’outil est appelé. Si vous épuisez votre quota, vous pouvez souscrire à PRO pour obtenir 40 minutes de quota quotidien (8 fois plus de quota que les utilisateurs gratuits). Par exemple, votre compte PRO vous permet de générer jusqu’à 600 images par jour en utilisant FLUX.1-schnell.

## Créez votre propre Space Gradio compatible MCP

Pour créer votre propre Space compatible MCP, vous devez [créer un nouvel espace Gradio](https://huggingface.co/new-space?sdk=gradio) puis vous assurer d’activer la prise en charge de MCP dans le code. Commencez par [les espaces Gradio](https://huggingface.co/docs/hub/en/spaces-sdks-gradio) et consultez le [guide détaillé sur MCP](https://www.gradio.app/guides/building-mcp-server-with-gradio) pour plus de détails.

Installez d'abord Gradio avec la prise en charge de MCP :
```bash
pip install "gradio[mcp]"
```

Créez ensuite votre application avec des annotations de types claires et des docstrings :

```python
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)   # exposes an MCP schema automatically
```

Poussez l'application vers un **Gradio Space** et elle recevra automatiquement le badge **MCP**. N'importe qui pourra ensuite l'ajouter comme outil en un seul clic.

> [!TIP]
> Il est également assez facile de convertir un Space Gradio existant en serveur MCP. Dupliquez-le depuis le menu contextuel, puis ajoutez simplement le paramètre mcp_server=True à votre méthode launch(), et assurez-vous que vos fonctions disposent d'indices de type clairs et de docstrings - vous pouvez utiliser des outils d'IA pour automatiser cela assez facilement (exemple de docstrings générées par IA).

## Faites preuve de créativité en mélangeant des Spaces !

Étant donné que Hugging Face Spaces est le plus grand annuaire d’applications IA, vous y trouverez de nombreux outils créatifs qui peuvent être utilisés comme outils MCP. Combiner et associer différents Spaces peut donner lieu à des flux de travail puissants et créatifs.

  
    
    
  
    Cette vidéo illustre l'utilisation de Lightricks/ltx-video-distilled et ResembleAI/Chatterbox dans Claude Code pour générer une vidéo avec audio.