> Discover all available pages from the documentation index: https://mastra.zisheng.pro/fr/llms.txt

# Mastra.getMCPServerById()

La méthode `.getMCPServerById()` récupère une instance de serveur MCP à partir de sa propriété `id` intrinsèque. Pour récupérer un serveur par clé de registre (la clé utilisée dans la configuration), utilisez plutôt `.getMCPServer()`.

## Exemple d’utilisation

```typescript
// Register an MCP server with a registry key
const myServer = new MCPServer({
  id: 'my-mcp-server',
  name: 'My Server',
  version: '1.0.0',
  tools: {/* ... */},
})

export const mastra = new Mastra({
  mcpServers: {
    customKey: myServer, // 'customKey' is the registry key
  },
})

// Retrieve by intrinsic ID
const server = mastra.getMCPServerById('my-mcp-server')

// Alternatively, retrieve by registry key
const serverByKey = mastra.getMCPServer('customKey')
```

## Paramètres

**serverId** (`string`): Propriété id intrinsèque du serveur MCP (définie lors de l’instanciation du serveur).

**version** (`string`): Facultatif. S’il est fourni, renvoie le serveur uniquement si sa version correspond.

## Valeur renvoyée

**server** (`MCPServerBase | undefined`): Instance de serveur MCP avec l’id spécifié (et la version, si elle est fournie), ou undefined si elle est introuvable.

## Remarques

- L’`id` du serveur est transformé en slug lors de sa construction ; `'myMcpServer'` devient donc `'my-mcp-server'`
- Si plusieurs serveurs ont le même `id` mais des versions différentes, vous devez fournir le paramètre `version` pour les distinguer
- Si aucun `version` n’est fourni et que plusieurs versions existent, la méthode renvoie la première correspondance

## Méthodes associées

- [Mastra.getMCPServer()](https://mastra.zisheng.pro/fr/reference/core/getMCPServer): Récupérer un serveur MCP par clé de registre
- [Mastra.listMCPServers()](https://mastra.zisheng.pro/fr/reference/core/listMCPServers): Lister tous les serveurs MCP enregistrés

## Voir aussi

- [Présentation de MCP](https://mastra.zisheng.pro/fr/docs/mcp/overview)
- [Référence du serveur MCP](https://mastra.zisheng.pro/fr/reference/tools/mcp-server)