> ## Documentation Index
> Fetch the complete documentation index at: https://auth0.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Tester votre serveur MCP avec MCP Inspector

> Découvrez comment tester votre serveur MCP avec MCP Inspector.

Lorsque vous développez votre serveur MCP localement, plusieurs options s'offrent à vous pour le tester. Vous pourriez le connecter à un client d'IA standard, mais cela masque souvent les détails du protocole sous-jacent, ce qui complique le débogage de requêtes précises. Vous pourriez aussi utiliser des outils en ligne de commande comme curl, mais cette approche peut s'avérer fastidieuse, surtout lorsqu'il faut gérer des flux d'authentification complexes et rédiger à la main des charges utiles JSON.

C'est là que [MCP Inspector](https://modelcontextprotocol.io/docs/tools/inspector) prend tout son sens. Cet outil graphique, conçu spécialement pour cet usage, offre le meilleur des deux mondes. Il vous propose une interface claire et interactive pour consulter les outils disponibles sur votre serveur, gère pour vous les mécanismes d'authentification complexes et vous permet d'exécuter directement des outils avec des entrées précises, sans avoir à formuler d'invites en langage naturel. Grâce à cette approche directe, il s'avère un atout inestimable pour déboguer et développer efficacement.

## Lancer MCP Inspector

Assurez-vous d'abord que votre serveur MCP est en cours d'exécution dans un autre terminal. Ouvrez ensuite une nouvelle fenêtre de terminal et exécutez la commande suivante pour lancer MCP Inspector :

```shell theme={null}
npx @modelcontextprotocol/inspector@latest
```

L'interface de MCP Inspector s'ouvrira alors dans votre navigateur par défaut.

![Page de MCP Inspector après son lancement](https://mintlify.s3.us-west-1.amazonaws.com/auth0/docs/images/ai/mcp/mcp_inspector_configured.png)

## Se connecter à votre serveur MCP

Une fois l'Inspector ouvert, vous devez le configurer pour qu'il se connecte à votre serveur MCP local.

1. Réglez le **Transport Type** sur `Streamable HTTP`.
2. Saisissez l'URL de votre serveur, généralement `http://localhost:3001/mcp`.

Pour que le MCP Inspector puisse se connecter à votre serveur MCP, vous pouvez utiliser l'enregistrement statique du client (recommandé) ou le Dynamic Client Registration (DCR). Choisissez la méthode qui vous convient ci-dessous et suivez les instructions.

**Static Client Registration**

## Create an Application to Represent Your MCP Client

Run this command to create the client:

```shell wrap lines theme={null}
auth0 api post clients --data '{
  "name": "MCP Inspector",
  "app_type": "regular_web",
  "is_first_party": false,
  "callbacks": ["http://localhost:6274/oauth/callback"],
  "grant_types": ["authorization_code"],
  "token_endpoint_auth_method": "client_secret_post",
  "oidc_conformant": true,
  "jwt_configuration": { "alg": "RS256" },
  "logo_uri": "https://avatars.githubusercontent.com/u/182288589"
}' | jq -r '"\nClient ID:     " + .client_id + "\nClient Secret: " +  .client_secret'
```

Save the `Client ID` and `Client Secret` from the command output.

In the left navigation menu, click on **Authentication** and enter the **Client ID** and **Client Secret** you obtained when you registered your application.

**Dynamic Client Registration**

## Enable Dynamic Client Registration (DCR)

Set the tenant-level flag required for Dynamic Client Registration (DCR):

```shell wrap lines theme={null}
auth0 tenant-settings update set flags.enable_dynamic_client_registration
```

Enabling `enable_dynamic_client_registration` allows MCP tools to register themselves as applications automatically through Dynamic Client Registration (DCR).

> [!WARNING]
>
> Auth0 supports Open Dynamic Registration, which means that if you enable this feature, anyone will be able to create applications in your tenant without a token. Read [Securing an Open DCR Endpoint](/ai/docs/mcp/guides/registering-your-mcp-client-application/dynamic-client-registration.md#securing-an-open-dcr-endpoint) to learn strategies to mitigate risks with Open DCR.

Your MCP server is now ready to use!

3. Cliquez sur **Connect**.

Vous serez redirigé vers un écran de connexion et de consentement. Connectez-vous avec un compte utilisateur disposant des autorisations nécessaires pour utiliser les outils.

Lors de votre première connexion au serveur, vous serez guidé tout au long du processus d'authentification par la [connexion universelle d'Auth0](https://auth0.com/features/universal-login). L'écran de consentement s'affichera alors et vous permettra de vérifier les outils auxquels vous avez accès :

![Fenêtre modale de consentement lors de l'authentification](https://mintlify.s3.us-west-1.amazonaws.com/auth0/docs/images/ai/mcp/consent_screen_while_logging_in.png)

Après avoir cliqué sur **Accept** pour accorder les autorisations demandées, vous serez redirigé vers MCP Inspector. L'interface indiquera alors que votre serveur est connecté et affichera la liste des outils à votre disposition :

![Page de MCP Inspector après son exécution](https://mintlify.s3.us-west-1.amazonaws.com/auth0/docs/images/ai/mcp/mcp_inspector_after_login.png)

## Exécuter vos outils

Une fois authentifié, vous pouvez exécuter les outils que le serveur MCP met à la disposition de votre utilisateur. Ces outils peuvent varier d'un utilisateur à l'autre selon la configuration de votre serveur.

![Liste des outils pour un utilisateur ayant le rôle Tool Administrator](https://mintlify.s3.us-west-1.amazonaws.com/auth0/docs/images/ai/mcp/tools_list_tool_administrator_role.png)

Liste des outils disponibles dans le serveur MCP

Pour exécuter un outil, cliquez dessus dans la liste, puis cliquez sur **Run Tool**.

![Réponse à l'appel de l'outil WhoAmI dans MCP Inspector](https://mintlify.s3.us-west-1.amazonaws.com/auth0/docs/images/ai/mcp/whoami_tool_call_through_mcp_inspector.png)

## Résolution des problèmes courants

Si vous éprouvez des difficultés, voici quelques points à vérifier d'abord :

### Échec de la connexion :

* Assurez-vous que votre serveur MCP est en cours d'exécution dans un terminal distinct.
* Vérifiez que l'URL ([http://localhost:3001/mcp](http://localhost:3001/mcp)) indiquée dans l'Inspector correspond bien au port et au terminal configurés pour votre serveur.

### Erreurs d'authentification :

* Vérifiez que l'identifiant du client et le secret client saisis dans l'Inspector sont exacts et ne contiennent aucun espace superflu.
* Assurez-vous de vous connecter avec un compte utilisateur existant chez votre fournisseur d'authentification (p. ex., Auth0).

### Aucun outil n'apparaît après la connexion :

* Cela signifie généralement que l'utilisateur avec lequel vous vous êtes connecté ne possède pas les rôles ou les autorisations nécessaires.
* Vérifiez dans votre fournisseur d'authentification que les bons rôles ont été attribués à l'utilisateur (p. ex., « Tool User » ou « Tool Administrator »).
* Assurez-vous que les permissions définies dans la configuration OAuth de votre serveur correspondent aux autorisations requises par les outils.

## Conclusion

Vous avez maintenant parcouru l'ensemble du processus, du lancement de MCP Inspector jusqu'à la connexion à un serveur sécurisé et à l'exécution de votre premier outil. En intégrant Inspector à votre flux de production de développement, vous disposez d'un moyen direct et efficace de tester votre implémentation, de vérifier les règles de sécurité et de déboguer la logique de vos outils, sans la lourdeur d'un client d'IA complet. Gardez cet utilitaire essentiel dans votre coffre à outils pour continuer à créer et à faire évoluer en toute confiance vos applications propulsées par MCP.
