Configuration du serveur MCP Codex

MCP (Model Context Protocol) permet à Codex de s'intégrer à des outils et services externes.

Cette section fournit des instructions détaillées sur la configuration et l'utilisation des serveurs MCP.


Qu'est-ce que MCP ?

MCP est un protocole ouvert qui permet une interaction standardisée entre les modèles d'IA et des outils et services externes. Grâce aux serveurs MCP, vous pouvez étendre les capacités de Codex :

  • Connexion au système de fichiers
  • Accès à la base de données
  • Intégrer des outils de gestion de projet
  • Appeler une API externe
MCP basé sur le protocole ouvertModel Context ProtocolBuild, avec prise en charge d'une intégration standardisée entre différents outils.

Configuration de base MCP

Menu de configuration de Codex

Vous pouvez gérer ou ajouter des services MCP via le menu des paramètres :

Se connecter à un MCP personnalisé :

Emplacement du fichier de configuration

Serveur MCP à~/.codex/config.tomldemcp_serversConfiguration partielle.

Serveur de type stdio

Configurer un serveur MCP stdio

[mcp_servers.filesystem]
# Commande de démarrage du serveur
command = "npx"

# Arguments passés à la commande
args = ["-y", "@modelcontextprotocol/server-filesystem", "./docs"]

# Répertoire de travail du serveur
cwd = "/path/to/workdir"

# Passer les variables d'environnement
env = {
    NODE_ENV = "production"
}

Serveur de type HTTP

Configurer le serveur MCP HTTP

[mcp_servers.docs]
# Point de terminaison du serveur MCP HTTP
url = "https://docs.example.com/mcp"

# En-têtes HTTP inclus
http_headers = {
    Authorization = "Bearer token"
}

Configuration des outils MCP

Restreindre les outils disponibles

Vous pouvez restreindre les outils exposés par le serveur MCP :

Liste blanche/noire des outils

[mcp_servers.filesystem]
# Liste des outils autorisés
enabled_tools = ["read_file", "write_file", "list_directory"]

# Liste des outils refusés (appliquée après enabled_tools)
disabled_tools = ["delete_file"]
L'utilisation de restrictions d'outils peut améliorer la sécurité en n'exposant que les outils dont vous avez besoin.

Configuration du délai d'attente

Configurer le délai d'attente

[mcp_servers.slow_server]
command = "python"
args = ["-m", "slow_server"]

# Délai d'attente au démarrage (secondes, par défaut 10)
startup_timeout_sec = 30

# Délai d'appel par outil (secondes, par défaut 60)
tool_timeout_sec = 120

Configuration de l'authentification MCP

Configuration OAuth

Configurer OAuth

[mcp_servers.protected]
url = "https://api.example.com/mcp"

# Portées OAuth demandées
scopes = ["read", "write"]

# Paramètre de ressource OAuth
oauth_resource = "codex-integration"

# Variable d'environnement du jeton Bearer
bearer_token_env_var = "EXAMPLE_API_TOKEN"

Configuration des en-têtes HTTP

Configuration des en-têtes HTTP

[mcp_servers.api]
url = "https://api.example.com/mcp"

# Renseigner les en-têtes HTTP à partir des variables d'environnement
env_http_headers = {
    X_API_KEY = "MY_API_KEY"
}

# En-têtes HTTP statiques
http_headers = {
    X_Custom_Header = "value"
}

Configuration du callback OAuth

Configurer le callback OAuth

# Port de callback fixe
mcp_oauth_callback_port = 8080

# URL de callback personnalisée
mcp_oauth_callback_url = "https://my-devbox.example.com/callback"

# Emplacement de stockage des identifiants
mcp_oauth_credentials_store = "keyring" # file | keyring | auto

Autorisations des outils MCP

Vous pouvez définir les autorisations individuellement pour les outils de chaque serveur MCP :

Configuration des autorisations d’outils

[mcp_servers.docs.tools.search]
# Mode d’autorisation : ask | approve | deny
approval_mode = "approve"
Mode d’autorisationDescription
askDemander avant chaque exécution (par défaut)
approveApprobation automatique
denyRefus automatique
Soyez prudent lors de la configuration des autorisations d’outils, et n’accordez des autorisations d’approbation automatique qu’aux outils auxquels vous faites confiance.

Serveurs MCP courants

Serveur de système de fichiers

MCP de système de fichiers

[mcp_servers.filesystem]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "./docs"]

Serveur GitHub

MCP GitHub

[mcp_servers.github]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
env = {
    GITHUB_PERSONAL_ACCESS_TOKEN = "your-token-here"
}

Serveur PostgreSQL

PostgreSQL MCP

[mcp_servers.postgres]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-postgres", "postgresql://user:pass@localhost/db"]

Serveurs MCP courants

Vous pouvez installer davantage de serveurs MCP via npm :

# 搜索 MCP 服务器
npm search @modelcontextprotocol/server

# 安装 MCP 服务器
npm install -g @modelcontextprotocol/server-filesystem
OpenAI propose officiellement une variété de serveurs MCP. Voirle dépôt GitHubObtenez la liste complète.

Dépannage

Échec du démarrage du serveur

Vérifiez les points suivants :

  • La commande et les paramètres sont-ils corrects ?
  • Les dépendances nécessaires sont-elles installées ?
  • Les variables d'environnement sont-elles correctement définies ?

Délai d'expiration de l'appel d'outil

Augmentez le délai d'expiration :

tool_timeout_sec = 120

Problème d'authentification

Assurez-vous que le port de rappel OAuth n'est pas occupé et que le stockage des identifiants est configuré correctement.

Utilisationcodex --verboseVous pouvez consulter des informations détaillées de débogage MCP.

FAQ

Q : Le serveur MCP ne démarre pas ?

Vérifiez si la commande est correctement installée, essayez d'exécuter la commande manuellement pour confirmer qu'il n'y a pas d'erreurs.

Q : Où sont configurées les autorisations des outils ?

Dans le fichier de configurationmcp_servers.<id>.tools.<tool>Configuration partielle.

Q : Comment désactiver un serveur MCP spécifique ?

Ajouter à la configurationenabled = falseOu supprimez directement la configuration.

Q : Combien de serveurs MCP sont pris en charge ?

Il n'y a pas de limite stricte, mais il est recommandé de ne configurer que les serveurs dont vous avez réellement besoin.

autres extensions