McpServer

Paramètres et propriétés

Les champs ci-dessous couvrent toutes les variantes ; la signature précise leurs combinaisons autorisées.

• commandSelon la variante
  string
  Exécutable lancé dans la sandbox. Texte littéral ; il ne peut pas contenir ${ ni NUL.
• argumentsSelon la variante
  readonly string[] | undefined
  Arguments littéraux transmis à la commande, sans référence ${.
• environmentSelon la variante
  Readonly<Record<string, string>> | undefined
  Valeurs d’environnement non secrètes définies pour le serveur, écrites telles quelles dans la configuration.
• variablesSelon la variante
  readonly string[] | undefined
  Noms de variables déclarées transmises au serveur. Les valeurs n’apparaissent jamais dans les arguments ni dans les fichiers ; une variable manquante fait échouer avant le démarrage de l’agent.
• toolsOptionnel
  McpToolFilter | undefined
  Filtre d’outils par nom MCP exact. include ne garde que les outils listés et exclude en retire ensuite. Les harness qui ne savent pas appliquer une partie la refusent à la composition de l’agent.
• startupTimeoutMsOptionnel
  number | undefined
  Délai de démarrage du serveur en millisecondes, de 1 à 2147483647 ; 60000 par défaut dans le harness intégré. Codex et Kimi l’appliquent par serveur, Claude Code via un seul MCP_TIMEOUT qui doit être identique sur chaque serveur qui le définit, et Copilot et Antigravity le refusent.
• urlSelon la variante
  string
  URL http ou https absolue d’un point d’accès MCP Streamable HTTP, sans identifiants intégrés.
• headersSelon la variante
  Readonly<Record<string, string>> | undefined
  En-têtes HTTP non secrets envoyés avec chaque requête. Utilisez bearerTokenVariable pour un jeton Authorization.
• bearerTokenVariableSelon la variante
  string | undefined
  Nom d’une variable déclarée dont la valeur est envoyée en Authorization: Bearer. Incompatible avec un en-tête Authorization.
• oauthSelon la variante
  "login" | McpClientCredentials | undefined
  “login” copie la connexion OAuth MCP que Claude Code, Codex ou Kimi ont enregistrée sur l’hôte ; les identifiants client fonctionnent uniquement dans le harness intégré, qui demande le jeton depuis la sandbox. Exclut bearerTokenVariable et un en-tête Authorization.

Signature

export type McpServer = McpStdioServer | McpHttpServer;

Contrats associés

• McpHttpServer
• McpStdioServer