Codex-MCP-Server-Konfiguration
MCP (Model Context Protocol) ermöglicht Codex die Integration mit externen Tools und Diensten.
Dieser Abschnitt enthält detaillierte Anweisungen zur Konfiguration und Verwendung von MCP-Servern.
Was ist MCP?
MCP ist ein offenes Protokoll, das eine standardisierte Interaktion zwischen KI-Modellen und externen Tools und Diensten ermöglicht. Über MCP-Server können Sie die Fähigkeiten von Codex erweitern:
- Dateisystem anbinden
- Datenbankzugriff
- Projektmanagement-Tools integrieren
- Externe API aufrufen
MCP basiert auf dem offenenModel Context Protocol-Build, mit Unterstützung für standardisierte Integration über verschiedene Tools hinweg.
MCP-Basiskonfiguration
Codex-Konfigurationsmenü
Sie können MCP-Dienste über das Einstellungsmenü verwalten oder hinzufügen:

Mit benutzerdefiniertem MCP verbinden:

Speicherort der Konfigurationsdatei
MCP-Server unter~/.codex/config.tomlvonmcp_serversTeilkonfiguration.
Server vom Typ stdio
stdio-MCP-Server konfigurieren
# Server-Startbefehl
command = "npx"
# An den Befehl übergebene Argumente
args = ["-y", "@modelcontextprotocol/server-filesystem", "./docs"]
# Arbeitsverzeichnis des Servers
cwd = "/path/to/workdir"
# Umgebungsvariablen übergeben
env = {
NODE_ENV = "production"
}
HTTP-Typ-Server
HTTP-MCP-Server konfigurieren
# MCP-HTTP-Server-Endpunkt
url = "https://docs.example.com/mcp"
# Enthaltene HTTP-Header
http_headers = {
Authorization = "Bearer token"
}
MCP-Tool-Konfiguration
Verfügbare Tools einschränken
Sie können die vom MCP-Server bereitgestellten Tools einschränken:
Tool-Whitelist/Blacklist
# Liste der erlaubten Tools
enabled_tools = ["read_file", "write_file", "list_directory"]
# Liste der verbotenen Tools (angewendet nach enabled_tools)
disabled_tools = ["delete_file"]
Die Verwendung von Tool-Einschränkungen kann die Sicherheit verbessern, indem nur die benötigten Tools verfügbar gemacht werden.
Timeout-Konfiguration
Timeout konfigurieren
command = "python"
args = ["-m", "slow_server"]
# Startup-Timeout (Sekunden, Standard 10)
startup_timeout_sec = 30
# Zeitlimit pro Tool-Aufruf (Sekunden, Standard 60)
tool_timeout_sec = 120
MCP-Authentifizierungskonfiguration
OAuth-Konfiguration
OAuth konfigurieren
url = "https://api.example.com/mcp"
# Angeforderte OAuth-Scopes
scopes = ["read", "write"]
# OAuth-Ressourcenparameter
oauth_resource = "codex-integration"
# Umgebungsvariable für Bearer-Token
bearer_token_env_var = "EXAMPLE_API_TOKEN"
HTTP-Header-Konfiguration
HTTP-Header konfigurieren
url = "https://api.example.com/mcp"
# HTTP-Header aus Umgebungsvariablen befüllen
env_http_headers = {
X_API_KEY = "MY_API_KEY"
}
# Statische HTTP-Header
http_headers = {
X_Custom_Header = "value"
}
OAuth-Callback-Konfiguration
OAuth-Callback konfigurieren
mcp_oauth_callback_port = 8080
# Benutzerdefinierte Callback-URL
mcp_oauth_callback_url = "https://my-devbox.example.com/callback"
# Speicherort der Anmeldeinformationen
mcp_oauth_credentials_store = "keyring" # file | keyring | auto
MCP-Tool-Berechtigungen
Sie können die Berechtigungen für die Tools jedes MCP-Servers individuell festlegen:
Tool-Berechtigungen konfigurieren
# Berechtigungsmodus: ask | approve | deny
approval_mode = "approve"
| Berechtigungsmodus | Beschreibung |
|---|---|
ask | Vor jeder Ausführung fragen (Standard) |
approve | Automatisch genehmigen |
deny | Automatisch ablehnen |
Seien Sie vorsichtig beim Konfigurieren von Tool-Berechtigungen, und erteilen Sie nur Tools, denen Sie vertrauen, Berechtigungen zur automatischen Genehmigung.
Häufige MCP-Server
Dateisystem-Server
Dateisystem-MCP
command = "npx"
args = ["-y", "@modelcontextprotocol/server-filesystem", "./docs"]
GitHub-Server
GitHub-MCP
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
env = {
GITHUB_PERSONAL_ACCESS_TOKEN = "your-token-here"
}
PostgreSQL-Server
PostgreSQL-MCP
command = "npx"
args = ["-y", "@modelcontextprotocol/server-postgres", "postgresql://user:pass@localhost/db"]
Häufige MCP-Server
Sie können weitere MCP-Server über npm installieren:
# 搜索 MCP 服务器 npm search @modelcontextprotocol/server # 安装 MCP 服务器 npm install -g @modelcontextprotocol/server-filesystem
OpenAI stellt offiziell eine Vielzahl von MCP-Servern bereit. SieheGitHub-Repository, um die vollständige Liste zu erhalten.
Fehlerbehebung
Server konnte nicht gestartet werden
Prüfen Sie Folgendes:
- Sind der Befehl und die Parameter korrekt?
- Sind die erforderlichen Abhängigkeiten installiert?
- Sind die Umgebungsvariablen korrekt gesetzt?
Zeitüberschreitung bei Tool-Aufruf
Erhöhen Sie die Zeitüberschreitung:
tool_timeout_sec = 120
Authentifizierungsproblem
Stellen Sie sicher, dass der OAuth-Callback-Port nicht belegt ist und der Anmeldeinformationsspeicher korrekt konfiguriert ist.
Nutzungcodex --verboseSie können detaillierte MCP-Debuginformationen anzeigen.
FAQ
F: MCP-Server kann nicht starten?
Prüfen Sie, ob der Befehl korrekt installiert ist; versuchen Sie, den Befehl manuell auszuführen, um zu bestätigen, dass keine Fehler auftreten.
F: Wo werden Tool-Berechtigungen konfiguriert?
In der Konfigurationsdateimcp_servers.<id>.tools.<tool>Teilkonfiguration.
F: Wie deaktiviere ich einen bestimmten MCP-Server?
Zur Konfiguration hinzufügenenabled = falseOder die Konfiguration direkt löschen.
Frage: Wie viele MCP-Server werden unterstützt?
Es gibt keine strikte Begrenzung, aber es wird empfohlen, nur die Server zu konfigurieren, die Sie tatsächlich benötigen.
Weitere Erweiterungen