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
# 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
# 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
# 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
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
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
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
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
# Mode d’autorisation : ask | approve | deny
approval_mode = "approve"
| Mode d’autorisation | Description |
|---|---|
ask | Demander avant chaque exécution (par défaut) |
approve | Approbation automatique |
deny | Refus 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
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "./docs"]
Serveur GitHub
MCP GitHub
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
env = {
GITHUB_PERSONAL_ACCESS_TOKEN = "your-token-here"
}
Serveur PostgreSQL
PostgreSQL MCP
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